Overview
CrownPunishments is a comprehensive, modern punishment system designed to give server administrators and moderators full control over player discipline. With an intuitive GUI, modular configuration files, and powerful features like Warning Levels, Punishment Lookup, and Freeze Chat, CrownPunishments is the all-in-one solution for maintaining order on your server. It supports both internal punishment handling and external command execution.





Why CrownPunishments?

• Modern Standards: Unlike older plugins, CrownPunishments uses a split-file configuration system, making it easier to manage complex setups.
• Warning Escalation: The warning system isn't just a counter; it's a fully functional escalation tool that can automate bans and mutes based on player behavior.
• Staff Quality of Life: Features like `/check`, `/fchat`, and the GUI make moderation faster and less error-prone.
• Extreme Customizability: From simple message changes to complex menu item actions and post-punishment hooks, make it truly your own.
• Supported: Through Discord!

Core Features

• Intuitive GUI System: Manage all punishments through clean, easy-to-navigate menus.
  • Main Punish Menu
  • Detailed Menus for Ban, Mute, Softban, Kick, Warn, and Freeze
  • Time Selector Menu with presets and custom input
  • Comprehensive Punishment History Menu with pagination
• ️ Advanced Punishment Types:
  • Ban & Mute: Standard handling with support for temporary and permanent durations.
  • Softban: Restrict specific commands (configurable) for a player while keeping them online.
  • Freeze: Completely immobilize a player. Includes a dedicated Freeze Chat (/fchat) for private communication between staff and the frozen player.
  • Warn System: Advanced leveling system. Configure specific actions (mute, kick, ban) to trigger automatically when a player reaches a certain warn level (e.g., 3 warns = 1 day ban). Supports incremental or unique expiration modes.
  • Kick: Remove a player from the server with a custom reason.
• ⌨️ Direct & Internal Handling:
  • Choose to handle punishments internally (native code) or execute external commands from other plugins.
  • Toggle between IP and Local punishments per infraction directly from the GUI.
• Punishment Lookup: Use /check <id> to view detailed information about any specific punishment, including staff, reason, duration, and expiration status.
• ⚙️ Highly Configurable:
  • Modular Configuration: Specific files for every punishment type (punishments/ban.yml, mute.yml, etc.).
  • Menu Customization: Modify every aspect of the menus (items, slots, names, lore, actions) in the `menus/` folder.
  • Post-Action Hooks: Execute a list of custom actions (commands, messages, sounds, titles) automatically after a punishment is applied or removed.
  • Database Support: Built-in support for SQLite (default) and MySQL for cross-server synchronization.
• Detailed History: Track every infraction. History entries display status (Active, Expired, Removed), reason, and duration.
• Staff Alerts: Configurable on-join alerts for staff members to see active punishments.
• PlaceholderAPI Support: Extensive placeholder support for messages and menus.

Commands

• /crown - Base command.
  • /crown punish <player> [type] [time] [reason] - Opens punish menu or directly punishes.
  • /crown unpunish <player> <type> - Removes a specific punishment.
  • /crown check <id> - View detailed info about a specific punishment ID.
  • /crown reload - Reloads plugin configurations.
  • /crown help - Shows help message.
• /punish <player> ... - Alias for `/crown punish`.
• /check <id> - Alias for lookup.
• /fchat <player|#id> - Toggle freeze chat participation with a specific player.
• /softban, /freeze, /ban, /mute, /warn, /kick - Quick direct commands.
• /unban, /unmute, /unwarn, /unfreeze, /unsoftban - Quick removal commands.

Dependencies

• PlaceholderAPI (Required) - For using the placeholders listed here.

Configuration
CrownPunishments offers extensive configuration options through a modular file structure:

• config.yml: Main settings, database connection, sounds, time units, and global report settings.
• messages.yml: All user-facing messages and prompts.
• punishments/*.yml: Individual configuration files for `ban`, `mute`, `warn`, `kick`, `softban`, and `freeze`. This is where you configure hooks, commands, and warning levels.
• punishments/punish_info.yml: Configure the layout of the `/check` command.
• menus/punish/*.yml: Configuration for the main punish menu, details menus, time selector, and history.

You can customize item materials, names, lore, slots, player heads, custom model data, and even the actions (commands, sounds, opening other menus, etc.) performed on click for every item in every menu!



Installation

1. Download the `CrownPunishments.jar` file.
2. Place the JAR file into your server's `plugins` folder.
3. Restart or reload your server. (Restart is recommended for initial setup).
4. Configure the plugin to your liking by editing the generated YAML files in the `plugins/CrownPunishments` folder.
5. Use `/crown reload` to apply configuration changes (some changes might still require a restart).