Configuring the Status Menu (status.yml)
The status.yml file is responsible for everything related to the player status feature, from the default status to the interface for changing it.
Default Status
This parameter sets the text that will be displayed in a player's profile immediately after they first join the server.
| Parameter | Type | Description |
|---|---|---|
default-status | string | The status text for new players. |
Example:
default-status: '&7I''m new to this server!'Status Change Menu
The menu section in this file configures a special anvil interface that opens with the /pp change-status command. The player enters their new status in it and then clicks on the result item to save.
Main Parameters
| Parameter | Type | Description |
|---|---|---|
menu.title | string | The title that will be displayed at the top of the anvil interface. |
menu.title-states | section | Dynamic titles for the anvil interface depending on conditions. |
menu.items | section | The section where the items placed in the anvil slots are described. |
Configuring Items (items)
Unlike regular menus, you only have three slots for customization here:
- Slot 0: The left slot of the anvil.
- Slot 1: The right slot of the anvil (usually used for materials).
- Slot 2: The result slot. This is the most important slot.
For the result slot, you must use the special type CHANGE_STATUS_ACCEPT so that the plugin understands that this specific item saves the status.
Tip
You can add other items to the inventory (like cancel_item in the example), but only slots 0, 1, and 2 are part of the anvil interface itself. Use them to create an intuitive menu.