GUI

GUI and economy

gui.yml controls the upgrade inventory, placeholder buttons, cost, money placeholders, and the charge command.

Key Reference

Key	Meaning
`title`	Inventory title. MiniMessage is supported.
`size`	Inventory slot count. It must be a multiple of 9, commonly 27, 36, 45, or 54.
`buttons.<id>.slots`	Slots used by a button or placeholder. Slot indexes start at 0.
`confirm.cost`	Money required for one upgrade attempt.
`confirm.money-placeholder`	PlaceholderAPI placeholder that returns the player's balance as a plain number.
`confirm.money-display-placeholder`	PlaceholderAPI placeholder used for formatted balance display in messages.
`confirm.charge-command`	Console command used to charge the player. `{amount}` is the cost.
`custom-model-data`, `item-model`, `tooltip-style`	Resource pack and modern item component support.

Full Example

title: "<dark_gray>Item Upgrade</dark_gray>"
size: 45

buttons:
  confirm:
    material: LIME_STAINED_GLASS_PANE
    amount: 1
    slots: [ 40 ]
    cost: 10000
    money-placeholder: "%vault_eco_balance_fixed%"
    money-display-placeholder: "%vault_eco_balance_commas%"
    charge-command: "eco take %player_name% {amount}"
    glow: true
    hide-flags: true
    unbreakable: true
    custom-model-data: 0
    item-model: ""
    tooltip-style: ""
    hide-tooltip: false
    display: "<green>Upgrade Item</green>"
    lore:
      - "<gray>Cost: <white>{cost}</white></gray>"
      - "<gray>Success chance is calculated from the stone, level, and charms.</gray>"

  upgrade-stone:
    material: PURPLE_STAINED_GLASS_PANE
    amount: 1
    slots: [ 4 ]
    display: "<aqua>Upgrade Stone</aqua>"
    lore:
      - "<gray>Place a configured upgrade stone here.</gray>"

  lucky-charm:
    material: WHITE_STAINED_GLASS_PANE
    amount: 1
    slots: [ 20 ]
    display: "<aqua>Lucky Charm</aqua>"
    lore:
      - "<gray>Optional. Adds extra success chance.</gray>"

  upgrade-item:
    material: CYAN_STAINED_GLASS_PANE
    amount: 1
    slots: [ 22 ]
    display: "<aqua>Upgrade Item</aqua>"
    lore:
      - "<gray>Place the MMOItems item to upgrade here.</gray>"

  protect-charm:
    material: YELLOW_STAINED_GLASS_PANE
    amount: 1
    slots: [ 24 ]
    display: "<aqua>Protect Charm</aqua>"
    lore:
      - "<gray>Optional. Prevents downgrade on failure.</gray>"

  filler:
    material: BLACK_STAINED_GLASS_PANE
    amount: 1
    slots: [ 0, 1, 2, 3, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 21, 23, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 41, 42, 43, 44 ]
    display: " "
    lore: [ ]

Economy: if money-placeholder returns commas, currency symbols, or text, MMOUpgrade may send invalid-money-placeholder. Use a plain-number placeholder for checks and a formatted placeholder for display.