AdvancedSS - Screenshare

Core Features & Components
Advanced Player Management System
The plugin features a sophisticated player freezing system that completely restricts movement, chat, commands, and all interactions when players are under investigation. Players are automatically teleported to designated screenshare locations with persistent spawn settings that survive server restarts.

Multi-Language Support System
AdvancedSS includes a comprehensive language management system supporting English, Spanish, Russian, French, and German translations. All messages are fully customizable with support for hex colors, RGB values, and gradient text formatting.

Professional GUI Management Interface
The plugin provides an intuitive staff interface with paginated player lists, individual player management panels, timer controls, and real-time statistics. Staff members can manage multiple frozen players simultaneously through an organized, user-friendly interface.

Intelligent Timer System
Advanced countdown timers with action bar display, automatic warnings, and configurable punishment execution. Timers persist across server restarts and can be customized per player with automatic actions triggered on expiry.

Discord Integration & Webhook System
Complete Discord webhook integration for logging freeze/unfreeze events, player admissions, disconnections, and timer expiry notifications. All webhook messages are professionally formatted with timestamps and color-coded status indicators.

Detailed Component Documentation
Command System
The command handler manages all plugin functionality including player freezing, GUI access, timer management, spawn setting, and configuration reloading. Commands support comprehensive permission checking and provide detailed feedback messages.

Available Commands:

• /ss <player> - Freeze/unfreeze players with automatic teleportation
  
  
• /ss setspawn - Set screenshare teleport location
  
  
• /ss gui - Access staff management interface
  
  
• /ssgui - Alternative GUI access command
  
  
• /sstimer <player> <minutes> - Set individual player timers
  
  
• /admit - Allow frozen players to admit cheating
  
  
• /discord - Display Discord server information
  
  
• /ssr - Reload plugin configuration

Event Management System
The core event system handles all player interactions, movement restrictions, inventory management, GUI interactions, and data persistence. This system ensures complete player immobilization during screenshares while maintaining user experience.

Key Event Handling:

• Movement Prevention: Complete restriction of player movement, rotation, and teleportation
  
  
• Chat & Command Blocking: Selective command filtering with whitelist support
  
  
• Inventory Protection: Prevents item manipulation and inventory access
  
  
• GUI Management: Handles all interface interactions and automatic reopening
  
  
• Book System: Advanced screenshare information delivery with clickable Discord links
  
  
• Data Persistence: Automatic saving and restoration of frozen player states

Action Management System
Automated command execution system that triggers custom actions on key events including player freeze, unfreeze, admission, disconnection, and timer expiry. Supports both console and player command execution with comprehensive placeholder replacement.

Action Types:

• Freeze Actions: Commands executed when players are frozen
  
  
• Unfreeze Actions: Commands executed when players are unfrozen
  
  
• Admit Actions: Automated punishment for cheating admissions
  
  
• Disconnect Actions: Automatic bans for leaving during screenshares
  
  
• Timer Expire Actions: Punishment for exceeding time limits

Color & Formatting System
Advanced color processing system supporting traditional Minecraft color codes, hex colors, RGB values, and gradient text effects. Includes automatic version detection for RGB support and fallback mechanisms for older server versions.

Supported Formats:

• Traditional codes: &a, &b, &c, &l, &m, &n, &o, &r
  
  
• Hex colors: #FFFFFF, #FF0000, #00FF00
  
  
• RGB values: &rgb(255,0,0), &rgb(0,255,0)
  
  
• Gradients: &gradient{#FF0000,#00FF00}Your Text Here

Timer Management System
Comprehensive timer system with real-time countdown display, warning notifications, and automatic action execution. Timers persist across server restarts and support individual player customization.

Timer Features:

• Real-time action bar countdown display
  
  
• Configurable warning notifications (30-second alerts)
  
  
• Automatic punishment execution on expiry
  
  
• Server restart persistence
  
  
• Individual player timer management
  
  
• Discord webhook integration for timer events

GUI Management System
Professional interface system with paginated player lists, individual management panels, and real-time statistics display. Supports multiple concurrent GUI sessions with advanced interaction handling.

GUI Components:

• Staff Dashboard: Overview of all online players with freeze status
  
  
• Player Management: Individual player controls with freeze, timer, and force admit options
  
  
• Settings Panel: Real-time configuration and statistics viewing
  
  
• Pagination System: Efficient handling of large player counts

Webhook Integration
Enterprise-grade Discord integration with asynchronous message delivery, comprehensive event logging, and professional message formatting. All webhook operations are performed asynchronously to prevent server lag.

Webhook Events:

• Player freeze/unfreeze notifications with staff attribution
  
  
• Cheat admission alerts with automatic timestamp
  
  
• Disconnection warnings with punishment confirmation
  
  
• Timer expiry notifications with timeout duration
  
  
• Professional embed formatting with color-coded status

⚙️ Configuration & Setup
Basic Configuration (config.yml)
The plugin includes extensive configuration options for customizing behavior, appearance, and integration settings. All options support hot-reloading without server restart.

Key Configuration Sections:

• General Settings: Discord links, display preferences, ban commands
  
  
• Timer Configuration: Default duration, warning settings, auto-start options
  
  
• Discord Integration: Webhook URLs, server naming, message formatting
  
  
• Action Commands: Custom commands for all event types
  
  
• Language Settings: Multi-language support and message customization
  
  
• Persistence Options: Data saving and restoration settings

Permission System
Comprehensive permission system with granular control over all plugin features. Supports inheritance and default permission assignment.

Permission Structure:

• advancedss.* - Complete access to all features
  
  
• advancedss.use - Basic freeze/unfreeze functionality
  
  
• advancedss.gui - GUI access and management
  
  
• advancedss.timer - Timer creation and management
  
  
• advancedss.setspawn - Spawn location configuration
  
  
• advancedss.reload - Configuration reloading

Language System
Advanced multi-language support with file-based translations, placeholder replacement, and dynamic message loading. Supports custom translations and message customization.

Language Features:

• Multi-File Support: Separate files for each language
  
  
• Dynamic Loading: Runtime language switching without restart
  
  
• Placeholder System: Advanced variable replacement in messages
  
  
• Custom Messages: Full message customization support
  
  
• Fallback System: Automatic fallback to English for missing translations

Performance Features

• Asynchronous Processing: All webhook and file operations are non-blocking
  
  
• Efficient Data Structures: Optimized collections for high-performance operations
  
  
• Memory Management: Automatic cleanup and garbage collection optimization
  
  
• Event Optimization: Efficient event handling with minimal server impact
  
  
• Database-Free: File-based storage with optional data persistence

Advanced Features
Data Persistence System
Complete player state preservation across server restarts including frozen status, last locations, timer states, and GUI preferences. All data is efficiently stored in YAML format with automatic backup creation.

Smart Restriction System
When players are frozen, the plugin enforces complete restrictions on movement, chat (except whitelisted commands), item interactions, inventory access, and damage dealing/receiving. The system includes intelligent bypass detection and automatic GUI reopening.

Professional Book System
Interactive screenshare information delivery through custom books with clickable Discord links, professional formatting, and automatic reopening. Books include comprehensive screenshare rules, Discord integration, and contact information.

Statistics & Analytics
Built-in statistics tracking including total freeze count, session data, and performance metrics. Statistics persist across restarts and can be accessed through GUI interfaces.

️ Installation & Quick Start

1. Download AdvancedSS.jar from SpigotMC
   
   
2. Place the file in your server's /plugins/ directory
   
   
3. Restart your server to generate configuration files
   
   
4. Configure settings in /plugins/AdvancedSS/config.yml
   
   
5. Set screenshare spawn location using /ss setspawn
   
   
6. Configure Discord webhook (recommended)
   
   
7. Test functionality with /ss <player>

Why Choose AdvancedSS?
AdvancedSS represents the pinnacle of screenshare management technology, combining professional-grade features with user-friendly interfaces. Whether managing a small PvP server or operating a large competitive network, AdvancedSS provides the comprehensive tools needed for effective anti-cheat verification while maintaining optimal server performance and user experience.

The plugin's modular architecture, extensive customization options, and professional Discord integration make it the ideal choice for servers requiring reliable, scalable screenshare management solutions.