Overview
CrownPunishments is a comprehensive, modern punishment system designed to give server administrators and moderators full control over player discipline. With an intuitive GUI, extensive configuration options, and powerful features like softbans, player freezing, and detailed punishment history, CrownPunishments is the all-in-one solution for maintaining order on your server. Developed with passion and precision, it aims to be both user-friendly for staff and robust for server owners.


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
• ️ Multiple Punishment Types:
  • Ban: Standard player banning.
  • Mute: Restrict player chat.
  • Kick: Remove a player from the server.
  • Warn: Issue a formal warning to a player.
  • Softban: Restrict specific commands (configurable) for a player. Player remains online.
  • Freeze: Completely immobilize a player, block commands/chat (for non-mods), and prevent interactions. Disconnecting while frozen can trigger configurable actions (e.g., auto-ban).
• ⌨️ Direct Command Alternatives: Quick commands for all punishment types (`/punish`, `/softban`, `/freeze`, `/unpunish`) mirroring GUI functionality.
• ⚙️ Highly Configurable:
  • Customize nearly every message (`messages.yml`).
  • Define external commands for bans, mutes, etc. (`config.yml`).
  • Modify all menus as you wish (items, slots, names, lore, actions - `menus/*.yml`).
  • Configure sounds for various actions.
  • Set up specific time units (s, m, h, d, y).
  • Detailed database configuration (SQLite & MySQL supported).
  • Advanced Freeze mechanics (disconnect commands, periodic actions).
  • Post-Action Hooks: Execute a list of custom actions (commands, messages, sounds, etc.) after a punishment or unpunishment is applied!
• Detailed Punishment History: Track every punishment and unpunishment with reasons, punishers, timestamps, and durations. Viewable in-game via GUI.
• PlaceholderAPI Support: Display punishment information via PAPI placeholders (e.g., softban status, time left, punishment counts).
• Database Support: Choose between SQLite (file-based, default) or MySQL for data storage.

Why CrownPunishments?

• All-in-One Solution: Combines features of multiple punishment plugins into one seamless package.
• User-Friendly for Staff: The GUI makes moderating accessible even for less experienced staff members, while power users can leverage direct commands.
• Extreme Customizability: From simple message changes to complex menu item actions and post-punishment hooks, make it truly your own.
• Focus on Modern Moderation: Features like Freeze and detailed Softbans provide advanced tools for handling difficult situations.
• Supported: Through Discord!

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 reload - Reloads plugin configurations.
  • /crown help - Shows help message.
• /punish <player> [type] [time] [reason] - Alias for `/crown punish`.
• /unpunish <player> <type> - Alias command to remove punishments.
• /softban <player> [time] [reason] - Alias command to apply a softban.
• /freeze <player> [reason] - Alias command to freeze a player.

Dependencies

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

Configuration
CrownPunishments offers extensive configuration options through multiple YAML files:

• config.yml: Main settings, prefix, database, external punishment commands, sounds, time units, softban/freeze mechanics, and post-action hooks.
• messages.yml: All user-facing messages, prompts, and menu text components.
• menus/punish_menu.yml: Configuration for the main punishment selection menu.
• menus/punish_details_menu.yml: Configuration for each specific punishment details menu (ban, mute, etc.).
• menus/time_selector_menu.yml: Configuration for the time selection GUI.
• menus/history_menu.yml: Configuration for the punishment history GUI.

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! The post-action hooks in `config.yml` are particularly powerful for integrating with other plugins or sending custom notifications.



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).