messages.yml

messages.yml contains the messages, upgrade-menu, and confirmation-menu sections. Legacy & colors are supported. When PlaceholderAPI is installed, supported player messages are passed through it.

Player Messages

The default keys cover command usage, permission denial, player-only commands, unknown players, empty hands, unsupported items, insufficient money, failed and successful rolls, enchantment conflicts, blocked worlds, reload completion, insufficient source amount, and addon loading delay.

messages.not-enough-amount uses Java message-format tokens:

{0} required source amount
{1} current held amount

Keep apostrophes escaped or doubled if you add them to a message that uses {0} or {1}.

Upgrade Menu

Key	Purpose
upgrade-menu.rows	Inventory height from one to six rows.
upgrade-menu.title	Menu title.
upgrade-menu.fill-item	Optional item used to fill empty cells. Leave its material empty to disable.
upgrade-menu.block-item	Close or cancel item shown in the bottom center.

The source preview is placed at column 3 of the middle row, and the result preview at column 7. The menu blocks ordinary inventory movement and shift-clicking.

Confirmation Menu

confirmation-menu.rows and title define the inventory. The confirm-item and cancel-item entries support material, name, lore, and a zero-based inventory slot.

Custom provider items are supported in menu materials with oraxen:, itemsadder:, and ecoitems: prefixes.