CrownPunishments

DISCORD | WIKI

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 Freeze Chat, Freeze Chat, 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.

THE PREMIUM VERSION IS HERE!

GET IT NOW WITH AN EXCLUSIVE 10% LAUNCH DISCOUNT

Premium Banner

*Orange check marks mean they are included but not yet available.*

Why CrownPunishments?

- Supported: Unlike older plugins, CrownPunishments uses a split-file configuration system, making it easier to manage complex setups. - Supported: 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. - Supported: Features like `/check`, `/fchat`, and the GUI make moderation faster and less error-prone. - Supported: From simple message changes to complex menu item actions and post-punishment hooks, make it truly your own. - Supported: Supported:

Core Features

- PlaceholderAPI Support: 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 - ️PlaceholderAPI Support: - PlaceholderAPI Support: Standard handling with support for temporary and permanent durations. - PlaceholderAPI Support: Restrict specific commands (configurable) for a player while keeping them online. - PlaceholderAPI Support: Completely immobilize a player. Includes a dedicated <u>Freeze Chat</u> (`/fchat`) for private communication between staff and the frozen player. - PlaceholderAPI Support: 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. - PlaceholderAPI Support: Remove a player from the server with a custom reason. - ⌨️ PlaceholderAPI Support: - 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. - PlaceholderAPI Support: Use `/check <id>` to view detailed information about any specific punishment, including staff, reason, duration, and expiration status. - ⚙️ PlaceholderAPI Support: - <u>Modular Configuration</u>: Specific files for every punishment type (punishments/ban.yml, mute.yml, etc.). - <u>Menu Customization</u>: Modify every aspect of the menus (items, slots, names, lore, actions) in the `menus/` folder. - <u>Post-Action Hooks</u>: Execute a list of custom actions (commands, messages, sounds, titles) automatically after a punishment is applied or removed. - <u>Database Support</u>: Built-in support for SQLite (default) and MySQL for cross-server synchronization. - PlaceholderAPI Support: Track every infraction. History entries display status (Active, Expired, Removed), reason, and duration. - PlaceholderAPI Support: Configurable on-join alerts for staff members to see active punishments. - PlaceholderAPI Support: Extensive placeholder support for messages and menus.

Demo video [DEPRECATED]

Commands

- /unban, /unmute, /unwarn, /unfreeze, /unsoftban - Base command. - /unban, /unmute, /unwarn, /unfreeze, /unsoftban - Opens punish menu or directly punishes. - /unban, /unmute, /unwarn, /unfreeze, /unsoftban - Removes a specific punishment. - /unban, /unmute, /unwarn, /unfreeze, /unsoftban - View detailed info about a specific punishment ID. - /unban, /unmute, /unwarn, /unfreeze, /unsoftban - Reloads plugin configurations. - /unban, /unmute, /unwarn, /unfreeze, /unsoftban - Shows help message. - /unban, /unmute, /unwarn, /unfreeze, /unsoftban - Alias for `/crown punish`. - /unban, /unmute, /unwarn, /unfreeze, /unsoftban - Alias for lookup. - /unban, /unmute, /unwarn, /unfreeze, /unsoftban - Toggle freeze chat participation with a specific player. - /unban, /unmute, /unwarn, /unfreeze, /unsoftban - Quick direct commands. - /unban, /unmute, /unwarn, /unfreeze, /unsoftban - Quick removal commands.

Dependencies

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

Configuration

CrownPunishments offers extensive configuration options through a modular file structure: - Configure the layout of the `/check` command. - Main settings, database connection, sounds, time units, and global report settings. - Configure the layout of the `/check` command. - All user-facing messages and prompts. - **punishments/*.yml: Configure the layout of the `/check` command. - 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!

A more detailed documentation can be found here:

➡️ Click to go to GitBook ⬅️

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