🖼️Items and Menus

CrownPunishments features a dynamic menu system, fully customizable via .yml files.

All YAML text files must be valid for the plugin to work, so check for errors in your changes at https://jsonformatter.org/yaml-validator

🗂️ Menu Structure 🗂️

The plugin uses several interconnected menus:

1. Punish Menu (punish_menu.yml): The main menu, accessed via /crown punish <player> or /punish <player>. It lists punishment types and player information.

   • Items:

     • Player Information: Displays target player details (online status, IP, coords, softban status, punishment counts).

     • Punishment Type Buttons: Ban, Mute, Softban, Kick, Warn, Freeze - Clicking opens the respective Details Menu.

     • History Button: Opens the History Menu.

     • Utility Buttons: Invsee, TP to Me, Clear Inventory, Kill Player. (These are just examples)

2. Punish Details Menus (punish_details_menu.yml): Specific menus for each punishment type (Ban Details, Mute Details, etc.), accessed from the Punish Menu.

   • Items (Common):

     • Information Item: Provides details about the specific punishment type.

     • Set Time Button: Opens the Time Selector Menu (for time-based punishments).

     • Set Reason Button: Allows inputting a punishment reason via chat.

     • Confirm Punish Button: Applies the punishment.

     • Back Button: Returns to the Punish Menu.

     • Unpunish Buttons: Unban, Unmute, Unsoftban, Unwarn, Unfreeze - Appear in relevant details menus to remove existing punishments.

3. Time Selector Menu (time_selector_menu.yml): Opened from Details Menus to select a punishment duration.

   • Items:

     • Time Adjustment Buttons: + / - 5 Minutes, 2 Hours, 1 Day, 5/7 Days.

     • Time Display Item: Shows the currently selected time.

     • Permanent Time Button: Sets the punishment to permanent.

     • Custom Time Button: Allows entering a custom time duration via chat.

     • Back Button: Returns to the Punish Details Menu.

4. History Menu (history_menu.yml): Accessed from the Punish Menu to view a player's punishment history.

   • Items:

     • History Entries: Dynamically generated items displaying past punishments.

     • Navigation Buttons: Next Page, Previous Page.

     • Back Button: Returns to the Punish Menu.

     • Punishment Counts Item: Displays a summary of punishment counts for the target player.