menu
This section contains the general configuration for the menu, such as its title and layout.
- title: The title of the menu, including color codes using the &# syntax for advanced color customization.
- rows: Defines the number of rows in the inventory menu (maximum of 6 rows, equivalent to 54 slots).
customFeature
This section allows enabling or disabling specific automatic features for the menu.
- fillMenu: Automatically fills empty inventory slots with a specified item.
- active: If true, this feature is enabled.
- type: Defines the item type used for filling.
- nameItem: The name displayed for the item.
- lore: Custom text descriptions for the item.
- material: Specifies the type of material used (e.g., black_stained_glass_pane).
- glow: If true, the item will have a glowing effect.
- cmd: List of commands executed when interacting with this item.
- edges: Automatically fills the border of the inventory with a specified item.
- active: If true, this feature is enabled.
- type: Defines the item type used for the edges.
- nameItem: The name displayed for the edge item.
- lore: Custom descriptions for the edge item.
- material: Specifies the material used for edges (e.g., yellow_stained_glass_pane).
- glow: If true, the edge item will glow.
- cmd: List of commands executed when interacting with the edge item.
items
This section configures the specific items placed in certain inventory slots. Each item has a unique index (e.g., 0, 1, 2, etc.).
Each item configuration can include:
- type: Specifies the type of item (e.g., item, playerHead, or head).
- nameItem: The name of the item, with color codes.
- lore: Text that appears when hovering over the item, including color codes for customization.
- material: Defines the material or texture of the item.
- amount: Specifies the quantity of the item.
- slot: The position of the item in the menu (from 0 to 53, depending on the size of the inventory).
- glow: If true, the item will have a glowing effect.
- cmd: Commands that are executed when the item is clicked, with support for various actions such as %menu%, %chat%, %write%, and %say%.
Key Features Explained:
- Auto-Fill: Automatically fills empty spaces in the menu with a customizable item.
- Auto-Edges: Automatically applies items to the edges of the menu for better visual organization.
- Player Heads: Supports dynamic player heads (e.g., showing the player's own head) and custom heads using texture data.
- Custom Commands: Each item can trigger a specific command upon interaction. These commands can range from opening other menus to executing chat-based commands.
- %menu% <menuName>
- What it does: Opens a specific menu for a player, regardless of permissions.
- Details: When a player clicks on an item configured with this command, the specified menu (<menuName>) will open for them. This is useful for linking multiple menus or bypassing permission checks for opening a certain menu.
- %chat% <command>
- What it does: Executes a chat command for the player who clicks the item.
- Details: When a player clicks an item, the specified command will be executed in the chat as if the player themselves had typed it. This can be used to trigger any server command that the player has permission to run.
- %write% <command>
- What it does: Allows the player to type another player’s name, then executes a command using that name.
- Details: After clicking an item with this command, the player can type a name in chat. Once they do, the specified command will run, appending the typed player’s name to the end. This is particularly useful for commands that require targeting other players (e.g., teleporting or granting permissions).
- %say% <message>
- What it does: Sends a custom message in chat to the player who clicks the item.
- Details: When an item with this command is clicked, a message is printed in the chat for the player. The message can include special formatting, colors, or placeholders, making it useful for feedback, notifications, or announcements..