menu.yml

Menu options

You can use PlaceholderAPI and local placeholders found in Menu Placeholders

Menu options

Title

title: TEXT

The menu title. Format: https://docs.advntr.dev/minimessage/format.html

Rows

rows: NUMBER # 1 - 6

The number of rows the menu should have.

Open When Empty

open_when_empty: BOOLEAN # true / false

Whether to open the menu even if there are no players to display.

Leaderboard Player

leaderboard_player:
  display_name: "TEXT"
  # ...

Define how a leaderboard player item looks in the menu.

See Items on how to create items

---

Items

Syntax

itemName:
  custom_model_data: NUMBER
  amount: NUMBER
  display_name: TEXT
  lore:
  - TEXT
  - TEXT
  enchantments:
  - ENCHANTMENT;LEVEL
  item_flags:
  - ITEM_FLAG
  glow: BOOLEAN
  click_commands:
  - "[TYPE] DATA"

This is the common syntax for creating items. Below are the explanations for each option.

Custom Model Data

custom_model_data: NUMBER

The custom model data for the item. Used with custom resource packs.

Amount

amount: NUMBER

The item's amount. Default: 1

Display Name

display_name: TEXT

The item display name. Uses MiniMessage format: https://docs.advntr.dev/minimessage/format.html

Lore

lore:
- TEXT
- TEXT

The item lore. Uses MiniMessage format: https://docs.advntr.dev/minimessage/format.html

Enchantments

enchantments:
- ENCHANTMENT;LEVEL

The item enchantments. https://www.digminecraft.com/lists/enchantment_list_pc.php

Item Flag

item_flags:
- ITEM_FLAG

The item flags. https://jd.papermc.io/paper/1.20.4/org/bukkit/inventory/ItemFlag.html

Alternative:

hide_enchants: BOOLEAN       # true / false
hide_attributes: BOOLEAN     # true / false
hide_unbreakable: BOOLEAN    # true / false
hide_destroys: BOOLEAN       # true / false
hide_placed_on: BOOLEAN      # true / false
hide_dye: BOOLEAN            # true / false
hide_armor_trim: BOOLEAN     # true / false
hide_item_specifics: BOOLEAN # true / false

Glow

glow: BOOLEAN # true / false

Whether the item should glow.

Click Commands

click_commands:
- "[TYPE] DATA"

Type	Argument (Data)	Description	Example
PLAYER	Command without "/"	Executes a command as the player	"[PLAYER] help"
CONSOLE	Command without "/"	Executes a command from the console	"[CONSOLE] give %player_name% minecraft:diamond 1"
CHAT	Message	Sends a chat message as the player	"[CHAT] Hey there!"
MESSAGE	Message	Sends a message to the player	"[MESSAGE] Hey %player_name%!"
SOUND	Key: https://www.digminecraft.com/lists/sound_list_pc.php Volume (optional): A float number >= 0 Pitch (optional): A float number, 0.0 - 2.0	Sends a sound effect to the player	"[SOUND] entity.generic.explode" "[SOUND] entity.generic.explode 1.0" "[SOUND] entity.generic.explode 1.0 2.0"
CLOSE	-	Closes the menu	"[CLOSE]"
PREVIOUS	-	Goes to the previous menu page	"[PREVIOUS]"
NEXT	-	Goes to the next menu page	"[NEXT]"

Slotted Items

Items that have slots associated with them. Found in menu.items and boards.boardName.custom_items

Material

material: TEXT # true / false

The item material. https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Material.html

Slot(s)

slot: NUMBER # 0 - 53 (depends on menu size)

Multiple slots:

slots:
- NUMBER
- NUMBER

Ranged slots:

slots:
- NUMBER-NUMBER
- NUMBER-NUMBER

The slots the item should be in, first slot is 0.

Leaderboard Player Items

Custom material, glow, and enchantments are not supported. You can use placeholders found in Leaderboard Player Specific Placeholders