> 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/editor.yml.md).

# editor.yml

Controls the in-game kit editor — the contents editor layout, the armor/offhand marker panes, the control buttons, the link tool, and the entry-type menu. Most servers can leave this at its defaults.

{% code title="editor.yml" %}

```yaml
# KitHarbor - editor.yml

# The in-game kit editor GUI.

#
# Slot map (54-slot double chest):

#   0-8    hotbar

#   9-35   main inventory

#   36     helmet     (orange pane marker when empty)

#   37     chestplate (orange pane marker when empty)

#   38     leggings   (orange pane marker when empty)

#   39     boots      (orange pane marker when empty)

#   40     offhand    (lime pane marker when empty)

#   41-42  filler     (black pane, no name)

#   43-44  control buttons (per-player limit, menu visibility)

#   45-53  control buttons

#
# Marker panes are display-only and are stripped before the kit is saved.

CONTENTS-EDITOR:
  TITLE: "&8ᴇᴅɪᴛɪɴɢ &7{kit_name}"
  SIZE: 54

  # ─── Armor / offhand slot markers (shown only when slot is empty) ───────────
  MARKERS:
    HELMET:
      SLOT: 36
      MATERIAL: "ORANGE_STAINED_GLASS_PANE"
      DISPLAY-NAME: "&#0099FBHelmet"
      LORE:
        - "&7Place a helmet here"
    CHESTPLATE:
      SLOT: 37
      MATERIAL: "ORANGE_STAINED_GLASS_PANE"
      DISPLAY-NAME: "&#0099FBChestplate"
      LORE:
        - "&7Place a chestplate here"
    LEGGINGS:
      SLOT: 38
      MATERIAL: "ORANGE_STAINED_GLASS_PANE"
      DISPLAY-NAME: "&#0099FBLeggings"
      LORE:
        - "&7Place leggings here"
    BOOTS:
      SLOT: 39
      MATERIAL: "ORANGE_STAINED_GLASS_PANE"
      DISPLAY-NAME: "&#0099FBBoots"
      LORE:
        - "&7Place boots here"
    OFFHAND:
      SLOT: 40
      MATERIAL: "LIME_STAINED_GLASS_PANE"
      DISPLAY-NAME: "&aOffhand"
      LORE:
        - "&7Place an offhand item here"

  # ─── Filler (non-interactive, no name) ──────────────────────────────────────
  FILLER:
    MATERIAL: "BLACK_STAINED_GLASS_PANE"
    SLOTS: [41, 42]

  # ─── Control buttons (bottom row) ───────────────────────────────────────────
  CONTROLS:
    BACK:
      SLOT: 45
      MATERIAL: "RED_STAINED_GLASS_PANE"
      DISPLAY-NAME: "&cʙᴀᴄᴋ"
      LORE:
        - "&fReturn without saving changes"
    NAME:
      SLOT: 46
      MATERIAL: "NAME_TAG"
      DISPLAY-NAME: "&#0099FBɴᴀᴍᴇ"
      LORE:
        - "&7Current: &f{kit_name}"
        - ""
        - "&fClick to change (type in chat)"
    DESCRIPTION:
      SLOT: 47
      MATERIAL: "BOOK"
      DISPLAY-NAME: "&#0099FBᴅᴇѕᴄʀɪᴘᴛɪᴏɴ"
      LORE:
        - "&7Sets the lore shown in the kit menu"
        - ""
        - "&fClick to edit (type in chat)"
    ICON:
      SLOT: 48
      MATERIAL: "ITEM_FRAME"
      DISPLAY-NAME: "&#0099FBɪᴄᴏɴ"
      LORE:
        - "&7The material shown in the kit menu"
        - ""
        - "&fClick with an item to set it as the icon"
    COOLDOWN:
      SLOT: 49
      MATERIAL: "CLOCK"
      DISPLAY-NAME: "&#0099FBᴄᴏᴏʟᴅᴏᴡɴ"
      LORE:
        - "&7Current: &f{cooldown}"
        - ""
        - "&fClick to change (e.g. 2d 6h 30m)"
    PERMISSION:
      SLOT: 50
      MATERIAL: "IRON_BARS"
      DISPLAY-NAME: "&#0099FBᴘᴇʀᴍɪѕѕɪᴏɴ ʀᴇǫᴜɪʀᴇᴍᴇɴᴛ"
      LORE:
        - "&7Status: {status}"
        - "&7Permission: &fkitharbor.kit.{kit_name}"
        - ""
        - "&7Controls whether permission is"
        - "&7required to claim this kit."
        - ""
        - "&fClick to toggle"
    COST:
      SLOT: 51
      MATERIAL: "GOLD_INGOT"
      DISPLAY-NAME: "&#0099FBᴄᴏѕᴛ"
      LORE:
        - "&7Current: &f{cost}"
        - ""
        - "&7Currency cost to claim (requires Vault)"
        - ""
        - "&fClick to change (type in chat)"
    CLAIM-LIMIT:
      SLOT: 52
      MATERIAL: "BARRIER"
      DISPLAY-NAME: "&#0099FBᴄʟᴀɪᴍ ʟɪᴍɪᴛ"
      LORE:
        - "&7Current: &f{claim_limit}"
        - ""
        - "&7How many times this kit can ever"
        - "&7be claimed (0 = unlimited)"
        - ""
        - "&fClick to change (type in chat)"
    PER-PLAYER-LIMIT:
      SLOT: 43
      MATERIAL: "PLAYER_HEAD"
      DISPLAY-NAME: "&#0099FBᴘᴇʀ-ᴘʟᴀʏᴇʀ ʟɪᴍɪᴛ"
      LORE:
        - "&7Current: &f{per_player_limit}"
        - ""
        - "&7How many times each player may"
        - "&7claim this kit (-1 = inherit global)"
        - ""
        - "&fClick to change (type in chat)"
    MENU-VISIBILITY:
      SLOT: 44
      MATERIAL: "ENDER_EYE"
      DISPLAY-NAME: "&#0099FBᴍᴇɴᴜ ᴠɪѕɪʙɪʟɪᴛʏ"
      LORE:
        - "&7Status: {visibility}"
        - ""
        - "&7Hidden kits only show to players with"
        - "&7kitharbor.kit.{kit_name}.visible"
        - ""
        - "&fClick to toggle"
    SAVE:
      SLOT: 53
      MATERIAL: "LIME_STAINED_GLASS_PANE"
      DISPLAY-NAME: "&aѕᴀᴠᴇ"
      LORE:
        - "&fSave this kit and close the editor"

  STATUS:
    ENABLED: "&aEnabled"
    DISABLED: "&cDisabled"

# ─── Linked-block tool ────────────────────────────────────────────────────────

LINK-TOOL:
  MATERIAL: "BLAZE_ROD"
  DISPLAY-NAME: "&#0099FBᴋɪᴛ ʟɪɴᴋ ᴛᴏᴏʟ"
  LORE:
    - "&7Right-click a block to link it to"
    - "&#66C2FF{kit_name}&7."
    - ""
    - "&7Players who interact with the linked"
    - "&7block will preview and claim the kit."
    - ""
    - "&fSneak + right-click to unlink a block"
  MESSAGES:
    LINKED: "&aLinked &#66C2FF{kit_name} &ato the block at &f{x}, {y}, {z}&a."
    UNLINKED: "&7Unlinked the kit from the block at &f{x}, {y}, {z}&7."
    ALREADY-LINKED: "&cThat block is already linked to &#66C2FF{kit_name}&c."
    NOT-LINKED: "&cThat block isn't linked to any kit."
    TOOL-RECEIVED: "&7You received the kit link tool for &#66C2FF{kit_name}&7."

# ─── Reward-type selection (item vs command entries) ──────────────────────────

ENTRY-TYPE-MENU:
  TITLE: "&8ᴋɪᴛ ᴇɴᴛʀɪᴇѕ"
  SIZE: 27
  PLACEHOLDER: true
  PLACEHOLDER-MATERIAL: "BLACK_STAINED_GLASS_PANE"
  ITEM-ENTRY-BUTTON:
    SLOT: 11
    MATERIAL: "CHEST"
    DISPLAY-NAME: "&#0099FBɪᴛᴇᴍ ᴇɴᴛʀɪᴇѕ"
    LORE:
      - "&7The items given when the kit is claimed"
      - ""
      - "&fClick to open the contents editor"
  COMMAND-ENTRY-BUTTON:
    SLOT: 15
    MATERIAL: "COMMAND_BLOCK"
    DISPLAY-NAME: "&#0099FBᴄᴏᴍᴍᴀɴᴅ ᴇɴᴛʀɪᴇѕ"
    LORE:
      - "&7Console commands run when the kit is"
      - "&7claimed. Use {player} for the claimer."
      - ""
      - "&7Example: &feco give {player} 500"
      - ""
      - "&fClick to edit the command list"
  BACK-BUTTON:
    SLOT: 22
    MATERIAL: "RED_STAINED_GLASS_PANE"
    DISPLAY-NAME: "&cʙᴀᴄᴋ"
    LORE:
      - "&fClick to return"
```

{% endcode %}


---

# 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/editor.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.