# Overview **Crown** is a comprehensive, enterprise-grade moderation and punishment solution designed for Minecraft servers (Spigot/Paper). It bridges the gap between standard punishment plugins and advanced administration suites by integrating punishments, player forensics, reporting, and moderator utilities into a single, cohesive ecosystem. Unlike simple ban plugins, Crown focuses on **context and evidence**. Every action is logged, player states are snapshotted at the moment of infraction, and confiscated items are securely stored rather than deleted. ### **🚀 Key Features**
#### ⚖️ Advanced Punishment System Crown offers a robust punishment engine that goes beyond simple bans. * **6 Punishment Types:** Ban, Mute, Kick, Warn, **Softban** (blocks specific commands), and **Freeze** (immobilizes player + admin-only chat). * **IP Synchronization:** Punishments can be applied by IP automatically. If a player is banned by IP, all accounts associated with that IP are also punished immediately. * **Forensic Snapshots:** When a player is punished, Crown records their snapshot data: Inventory, Location, Health, Gamemode, IP, and Ping. * **Escalating Warnings:** A configurable warning system where accumulating warnings can trigger automatic actions (e.g., *Warn #3 triggers a 7-day Softban*). Warning expiration can be unique or incremental. #### 🛡️ Moderator Mode (`/mod`)
A fully integrated state-switching system for staff. * **Session Management:** Saves the staff member's inventory, location, and stats before putting them into Mod Mode. Restores everything exactly upon exit (even after server crashes). * **Mod Tools:** Configurable hotbar tools including: * **Vanish/Spectator:** Toggle visibility and collision. * **Player Selector:** Quickly target players for inspection. * **Freeze Tool:** Left/Right click to freeze/unfreeze. * **InvSee:** Inspect target inventories instantly. * **Random TP:** Teleport to random players to spot-check behavior. * **Persistent Preferences:** Moderators can toggle settings like **Container Spy**, **Silent Mode** (fake quit/join), **Night Vision**, and **Fly Speed**, which persist across sessions. #### 📝 Dynamic Report System
An anti-abuse reporting system that allows players to report others using an intuitive **Book GUI**. * **Interactive Book Interface:** Players select categories (Player, Clan, Server), specific reasons, and input details via chat without memorizing commands. * **Staff GUI (`/reports`):** A filterable menu for staff to view, claim ("Take"), resolve, or reject reports. * **Data Collection:** Reports automatically attach a snapshot of the reported player's stats (HP, Location, Kills, Ping) for context.
#### 🎒 The Locker System (Evidence Vault) Crown introduces a unique **Confiscation Locker**. * **Confiscation:** When a moderator removes an illegal item from a player's inventory via the Inspection Menu, it is **not deleted**. * **Evidence Storage:** The item is serialized and sent to the "Locker". * **Review:** Admins can view the Locker to see exactly what items were confiscated, when, and by whom. Items can be deleted permanently or returned to the moderator's inventory.
#### 👤 Deep Profiling & History Complete oversight of player data. * **`/profile `:** A GUI displaying live health, food, EXP, location, and quick access to their Inventory, Ender Chest, and Punishment History. * **`/history `:** View active and expired punishments. Active punishments show exact expiry times and allow for re-punishing or un-punishing directly from the GUI. * **Operator Audit Log:** Tracks administrative actions performed on a player (e.g., *AdminX cleared inventory of PlayerY*). ### ⚙️ Technical Architecture #### Database Support Crown is built for scalability, supporting both local and network environments. * **SQLite:** Zero-setup local storage for single servers. * **MySQL:** Optimized HikariCP connection pooling for networks, allowing cross-server data syncing. #### Asynchronous Operations To ensure zero lag impact on the main server thread: * Database queries (Lookups, Logs, History) are executed asynchronously. * Heavy tasks like inventory serialization are handled off-thread. * Menus load with "Loading..." indicators while fetching data. #### Customizability * **MiniMessage & Legacy Colors:** Full support for RGB gradients and standard color codes in all messages. * **GUIs:** Every menu (Punish, History, Profile) is configurable via YAML. * **Placeholders:** Native PlaceholderAPI support for messages and scoreboards. *** ### 🛑 Comparison: Punishments
FeatureBanMuteSoftbanFreezeKickWarn
Prevents Join✅❌❌❌✅ (Once)❌
Blocks Chat❌✅❌✅ (Public)❌❌
Blocks Commands❌⚠️ (Config)✅ (Config)✅❌❌
Immobilizes❌❌❌✅❌❌
DurationTemp/PermTemp/PermTemp/PermManualInstantExpiring
IP Sync✅✅✅✅✅❌
*** ### 🔜 Getting Started Ready to install Crown? Check the **Installation** guide to set up your database and permissions. * **Commands:** View the full list of commands and aliases. * **Permissions:** Configure access for Helpers, Mods, and Admins. * **Configuration:** Learn how to tweak the `config.yml` and `messages.yml`. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://coronas-studios.gitbook.io/coronas-studios/crown/overview.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.