Skip to content

Menu Customization

Every GUI in SkyblockCore is defined in a YAML file under plugins/Skyblock/menus/. You can move buttons, swap icons, reword text, and re-theme the whole plugin without code.

The Menu Files

File Menu
main.yml Main menu (/is) — see Main Menu
settings.yml Settings / flags — see Settings
upgrades.yml Upgrades — see Upgrades
warp.yml Public warps — see Warps
blocks.yml Block values (/is block) — see Block Values
help.yml Command/help list
delete-confirm.yml Delete confirmation

Anatomy of a Menu

title: "&8Island Menu"
rows: 5
type: warp            # plain | warp | upgrades | blocks

items:
  home:
    slot: 37
    material: GRASS_BLOCK
    name: "&aGo To My Island"
    lore:
      - "&eClick to teleport!"
    action: "island:git"
Field Meaning
title Inventory title (color codes allowed)
rows 1–6 rows
type Special behavior (see below)
items.<id>.slot Slot index (0-based)
items.<id>.material Item material
items.<id>.name / lore Display text
items.<id>.action What clicking does
type Behavior
(plain) Just the items you define
warp Center slots auto-fill with online islands' heads; clicking visits them
upgrades Items auto-fill from upgrades.yml
blocks Items auto-fill from block-values.yml, paginated

Actions

Action Effect
open:<menu> Open another menu (e.g. open:warp)
island:<sub> Run an island sub-command (e.g. island:git, island:olustur)
flag:<NAME> Toggle an island flag (e.g. flag:PVP)
page:prev / page:next Page navigation
close Close the menu

island:<sub> uses the internal sub-command name (see command.subcommands in config.yml).

Placeholders in Menus

Menu text supports the plugin's own placeholders (%skyblock_level%, %skyblock_flag_pvp%, {owner}, {level}, {points}, {member_list}, ...) and, when installed, any PlaceholderAPI placeholder (e.g. %vault_group%). The %skyblock_...% ones render even without PlaceholderAPI.

Tip

Reload menus with /is admin reload after editing.