> For the complete documentation index, see [llms.txt](https://docs.blixaozric.online/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.blixaozric.online/kit-harbor/configuration/menus.yml.md).

# menus.yml

Controls the layout and appearance of every KitHarbor menu — kit selection, preview, history, settings, and the confirmation menu. You can change titles, sizes, item materials, slots, display names, and lore.

```yaml
# KitHarbor - menus.yml

GLOBAL:
  PAGE-MENU:
    MATERIAL: "ARROW"
    NEXT-BUTTON: "&aɴᴇxᴛ"
    BACK-BUTTON: "&aʙᴀᴄᴋ"
    NEXT-LORE:
      - "&fClick to go to the next page"
    BACK-LORE:
      - "&fClick to go to the previous page"

# ─── Kit Selection Menu (/kit menu) ──────────────────────────────────────────

KIT-MENU:
  TITLE: "&8ᴋɪᴛʜᴀʀʙᴏʀ"
  SIZE: 54
  MAX-ITEMS-PER-PAGE: 45
  PLACEHOLDER: true
  PLACEHOLDER-MATERIAL: "BLACK_STAINED_GLASS_PANE"
  KIT-BUTTON:
    AVAILABLE-NAME: "&#0099FB{kit_name}"
    COOLDOWN-NAME: "&c{kit_name}"
    NO-PERMISSION-NAME: "&8{kit_name}"
    LIMIT-REACHED-NAME: "&8{kit_name}"
    AVAILABLE-LORE:
      - "&fLeft click to claim"
      - "&fRight click to preview"
    COOLDOWN-LORE:
      - "&cOn cooldown"
      - ""
      - "&7Available in: &f{time_remaining}"
    NO-PERMISSION-LORE:
      - "&cYou don't have permission for this kit"
      - ""
      - "&7Required: &f{permission}"
    LIMIT-REACHED-LORE:
      - "&cClaim limit reached"
      - ""
      - "&fRight click to preview"
    # Appended to every state's lore for a kit that has a cost.
    COST-LORE:
      - "&7Cost: &f{cost}"
    # Appended to AVAILABLE / LIMIT-REACHED lore only when the kit has such a limit.
    GLOBAL-LIMIT-LORE:
      - "&7Global claims left: &f{global_remaining}"
    PERSONAL-LIMIT-LORE:
      - "&7Your claims left: &f{personal_remaining}"
    AVAILABLE-SYMBOL: "&#0099FB▪"
    COOLDOWN-SYMBOL: "&c▪"
    NO-PERMISSION-SYMBOL: "&8▪"
    LIMIT-REACHED-SYMBOL: "&8▪"
  REFRESH-BUTTON:
    DISPLAY-NAME: "&#0099FBᴋɪᴛѕ"
    MATERIAL: "CHEST"
    SLOT: 49
    LORE:
      - "&fClick to refresh"
      - "&7{kits_available} kits available"

# ─── Kit Preview Menu (/kit preview <name>) ───────────────────────────────────

KIT-PREVIEW-MENU:
  TITLE: "&8ᴘʀᴇᴠɪᴇᴡ &7{kit_name}"
  SIZE: 54
  PLACEHOLDER: true
  PLACEHOLDER-MATERIAL: "BLACK_STAINED_GLASS_PANE"
  CLAIM-BUTTON:
    AVAILABLE-NAME: "&#0099FBᴄʟᴀɪᴍ ᴋɪᴛ"
    COOLDOWN-NAME: "&cᴏɴ ᴄᴏᴏʟᴅᴏᴡɴ"
    LIMIT-REACHED-NAME: "&cʟɪᴍɪᴛ ʀᴇᴀᴄʜᴇᴅ"
    MATERIAL: "LIME_STAINED_GLASS_PANE"
    SLOT: 49
    AVAILABLE-LORE:
      - "&fClick to claim &#66C2FF{kit_name}"
    COOLDOWN-LORE:
      - "&7Available in: &f{time_remaining}"
    LIMIT-REACHED-LORE:
      - "&cYou can no longer claim this kit"
    # Appended to every state's lore for a kit that has a cost.
    COST-LORE:
      - "&7Cost: &f{cost}"
    # Appended to AVAILABLE / LIMIT-REACHED lore only when the kit has such a limit.
    GLOBAL-LIMIT-LORE:
      - "&7Global claims left: &f{global_remaining}"
    PERSONAL-LIMIT-LORE:
      - "&7Your claims left: &f{personal_remaining}"
  BACK-BUTTON:
    DISPLAY-NAME: "&cʙᴀᴄᴋ"
    MATERIAL: "RED_STAINED_GLASS_PANE"
    SLOT: 45
    LORE:
      - "&fClick to return to kits"

# ─── Kit History Menu (/kit history) ─────────────────────────────────────────

KIT-HISTORY-MENU:
  TITLE: "&8ᴋɪᴛ ʜɪѕᴛᴏʀʏ"
  SIZE: 54
  MAX-ITEMS-PER-PAGE: 45
  PLACEHOLDER: true
  PLACEHOLDER-MATERIAL: "BLACK_STAINED_GLASS_PANE"
  HISTORY-BUTTON:
    MATERIAL: "PAPER"
    DISPLAY-NAME: "&#0099FB{kit_name}"
    LORE:
      - "&7Claimed: &f{claimed_at}"
      - "&7Next available: &f{next_available}"
  REFRESH-BUTTON:
    DISPLAY-NAME: "&#0099FBʜɪѕᴛᴏʀʏ"
    MATERIAL: "CLOCK"
    SLOT: 49
    LORE:
      - "&fClick to refresh"

# ─── Settings Menu (/kh settings) ─────────────────────────────────────────

KIT-SETTINGS-MENU:
  TITLE: "&8ᴋɪᴛ ѕᴇᴛᴛɪɴɢѕ"
  SIZE: 27
  PLACEHOLDER: true
  PLACEHOLDER-MATERIAL: "BLACK_STAINED_GLASS_PANE"
  BUTTONS:
    CLAIM-NOTIFICATIONS:
      DISPLAY-NAME: "&#0099FBᴄʟᴀɪᴍ ɴᴏᴛɪꜰɪᴄᴀᴛɪᴏɴѕ"
      MATERIAL: "BELL"
      SLOT: 10
      LORE:
        - "&fGet notified when a kit becomes available"
        - "&fᴄᴜʀʀᴇɴᴛʟʏ: {status}"
    STARTER-KIT-REMINDER:
      DISPLAY-NAME: "&#0099FBѕᴛᴀʀᴛᴇʀ ᴋɪᴛ ʀᴇᴍɪɴᴅᴇʀ"
      MATERIAL: "PAPER"
      SLOT: 11
      LORE:
        - "&fRemind you to claim your starter kit"
        - "&fᴄᴜʀʀᴇɴᴛʟʏ: {status}"
    AUTO-CLAIM:
      DISPLAY-NAME: "&#0099FBᴀᴜᴛᴏ-ᴄʟᴀɪᴍ ᴏɴ ʟᴏɢɪɴ"
      MATERIAL: "HOPPER"
      SLOT: 12
      LORE:
        - "&fAutomatically claim available kits on join"
        - "&fᴄᴜʀʀᴇɴᴛʟʏ: {status}"

# ─── Confirm Claim Menu ───────────────────────────────────────────────────────

KIT-CONFIRM-MENU:
  TITLE: "&8ᴄᴏɴꜰɪʀᴍ ᴄʟᴀɪᴍ"
  SIZE: 27
  PLACEHOLDER: true
  PLACEHOLDER-MATERIAL: "BLACK_STAINED_GLASS_PANE"
  KIT-DISPLAY:
    SLOT: 13
    DISPLAY-NAME: "&#0099FB{kit_name}"
    LORE:
      - "&7Click confirm to claim &#66C2FF{kit_name}"
      - ""
      - "&7Cost: &f{cost}"
      - "&7Cooldown: &f{cooldown}"
  CONFIRM-BUTTON:
    DISPLAY-NAME: "&#00FC00ᴄᴏɴꜰɪʀᴍ"
    MATERIAL: "LIME_STAINED_GLASS_PANE"
    SLOT: 15
    LORE:
      - "&fClick to claim {kit_name}"
  CANCEL-BUTTON:
    DISPLAY-NAME: "&#FC0000ᴄᴀɴᴄᴇʟ"
    MATERIAL: "RED_STAINED_GLASS_PANE"
    SLOT: 11
    LORE:
      - "&fClick to cancel"

# ─── Help Menu (/kit help) ────────────────────────────────────────────────────

KIT-HELP-MENU:
  TITLE: "&8ᴋɪᴛʜᴀʀʙᴏʀ ʜᴇʟᴘ"
  SIZE: 27
  PLACEHOLDER: true
  PLACEHOLDER-MATERIAL: "BLACK_STAINED_GLASS_PANE"
  BUTTONS:
    KIT:
      MATERIAL: "CHEST"
      SLOT: 10
      DISPLAY-NAME: "&#0099FB/kit <name>"
      LORE:
        - "&fClaim a kit by name"
    LIST:
      MATERIAL: "BOOK"
      SLOT: 11
      DISPLAY-NAME: "&#0099FB/kit list"
      LORE:
        - "&fView all available kits"
    PREVIEW:
      MATERIAL: "ITEM_FRAME"
      SLOT: 12
      DISPLAY-NAME: "&#0099FB/kit preview <name>"
      LORE:
        - "&fPreview a kit's contents"
    MENU:
      MATERIAL: "CHEST_MINECART"
      SLOT: 13
      DISPLAY-NAME: "&#0099FB/kh menu"
      LORE:
        - "&fOpen the kit selection GUI"
    HISTORY:
      MATERIAL: "CLOCK"
      SLOT: 14
      DISPLAY-NAME: "&#0099FB/kit history"
      LORE:
        - "&fView your kit claim history"
    SETTINGS:
      MATERIAL: "COMPARATOR"
      SLOT: 15
      DISPLAY-NAME: "&#0099FB/kh settings"
      LORE:
        - "&fToggle personal kit settings"
    STARTERKIT:
      MATERIAL: "GOLDEN_APPLE"
      SLOT: 16
      DISPLAY-NAME: "&#0099FB/kh starterkit"
      LORE:
        - "&fClaim your one-time starter kit"
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.blixaozric.online/kit-harbor/configuration/menus.yml.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.