👑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 <player>: A GUI displaying live health, food, EXP, location, and quick access to their Inventory, Ender Chest, and Punishment History.

• /history <player>: 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

Feature	Ban	Mute	Softban	Freeze	Kick	Warn
Prevents Join	✅	❌	❌	❌	✅ (Once)	❌
Blocks Chat	❌	✅	❌	✅ (Public)	❌	❌
Blocks Commands	❌	⚠️ (Config)	✅ (Config)	✅	❌	❌
Immobilizes	❌	❌	❌	✅	❌	❌
Duration	Temp/Perm	Temp/Perm	Temp/Perm	Manual	Instant	Expiring
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.