🛡️ AdminControlPanel v1.0 - Ultimate Server Administration Suite 🖥️

AdminControlPanel is a comprehensive, all-in-one administration and moderation suite tailored for Spigot and Paper servers. 🚀 It seamlessly bridges the gap between deep server monitoring, graphical user interfaces, and a highly reliable data-saving architecture. This plugin grants server staff absolute control over their community, ensuring that player moderation remains fluid and uncompromised—regardless of whether a player is online or offline. 💎

🌟 Core Features

💻 Intuitive Master Dashboard (/cp)

The heart of the plugin is a centralized graphical user interface (GUI) that dynamically displays all online players as skulls. 👤 By simply hovering over a skull, administrators can view permanently attached player notes right inside the item lore. The dashboard also tracks the total number of unresolved reports and features a single-click toggle to control the global maintenance state. ⚙️

💾 Bulletproof Offline Inventory & Ender Chest System

Unlike conventional administration plugins that frequently suffer from data corruption or item loss when trying to read/write serialized item arrays to YAML configs, this suite utilizes a rigorous slot-by-slot saving routine. 🛠️ Administrators can completely open, edit, clear, or target-delete specific items (/inv delete) inside the inventories and ender chests of offline players. The modifications are safely cached and automatically applied the very millisecond the player rejoins the network! 🔄

❄️ Advanced Freeze Mechanics

The plugin introduces two layers of restriction to effectively deal with rulebreakers or players undergoing screenshares:

🥶 Total Freeze: Completely locks a player's movement, block breaking, block placing, and item dropping capabilities.

🎒 Inventory & Ender Chest Freeze: Selectively prevents a player from moving, sorting, taking, or dropping items within any open inventory screen or container block.

👻 Professional Vanish Mode & Silent Chests

When activated, staff members become entirely invisible to normal players. 🕵️‍♂️ This state comes equipped with a built-in Silent Chest filter. When an invisible admin opens regular chests, trapped chests, or ender chests, the visual opening animation and the associated chest sound effects are completely suppressed, allowing for flawless, stealthy investigations. 🤫

🚫 Secure Maintenance Mode

Maintenance mode can be toggled instantly via a direct chat command or through the master GUI. 🔒 When enabled, it instantly kicks all active players who lack administrative privileges. Furthermore, it hooks directly into the network layer (PlayerLoginEvent) to actively reject incoming connection attempts before a player can fully join. This successfully suppresses annoying connection spam and redundant chat messages. 🙅‍♂️

📝 Integrated Report & Notes System

The plugin comes out of the box with a fully integrated ticketing and documentation pipeline. 📋 Players can submit live reports against rulebreakers, which are instantly broadcast to staff and logged into the master dashboard. Meanwhile, administrators can append permanent, index-based text notes to player files to track player history and behavioral patterns over time. 🔍

⌨️ Full Tab Completion Support

To maximize efficiency and workflow speed for busy moderators, every single command—including intricate sub-commands, dynamic online player lists, and material names—comes with full, alphabetically sorted autocompletion. ⚡

🛠️ Commands and Permissions

📊 Control Panel & Dashboard

/cp 🎛️ Opens the main graphical user interface displaying the player grid and global toggles. Required Permission: admincontrol.admin

/cp maintenance ⚠️ Directly toggles the global maintenance status of the server. Required Permission: admincontrol.admin

📦 Inventory & Container Management

/inv <see / clear / freeze / unfreeze> 🔍 Inspects, clears, or locks the main inventory of the target player (works online and offline). Required Permission: admincontrol.inv or admincontrol.admin

/inv delete <item_material> ❌ Deletes all instances of a specified material from an online player's inventory. Required Permission: admincontrol.inv or admincontrol.admin

/echest <see / clear / freeze / unfreeze> 🔮 Inspects, clears, or locks the ender chest contents of the target player (works online and offline). Required Permission: admincontrol.echest or admincontrol.admin

👤 Player Moderation & Stealth

/freeze 🧊 Toggles a complete physical movement and interaction lock on the target player. Required Permission: admincontrol.admin

/vanish 👁️‍🗨️ Toggles absolute invisibility and enables the silent container interaction filter. Required Permission: admincontrol.admin

💬 Communication & Chat Control

/chat <mute / demute> 🔇 Silences or restores the chat privileges of an individual player. Required Permission: admincontrol.admin

/chat clear 🧹 Completely wipes the active chat log to clear out advertisements or toxic messages. Required Permission: admincontrol.admin

/chat globalmute 🌐 Toggles a global chat lock, preventing anyone without administrative rights from speaking. Required Permission: admincontrol.admin

📄 Administrative Documentation & Tickets

/notes <add / remove / list> [text / index] 📌 Allows staff to add, delete by index, or list permanent text entries attached to a player's profile. Required Permission: admincontrol.admin

/report 🚨 Submits a formal complaint against a user. This is the only command open to the entire player base. Required Permission: None (Available to all players)