editor menus

Every menu of the In-Game Editor is a file in guis/editor/. Nothing about the editor is hardcoded: you can move, restyle, rename the text of or remove any button. After editing, run /cratesadmin reload.

The files use the same Title / Size / Items format as the player menus, with [back], [close], [previous] and [next] for navigation.

Button ids

Editor buttons are found by their id, not their slot. Mode-Item toggles the mode wherever you put it, but renaming the key to something else turns it into a plain decoration. Keep the ids listed below; everything else about them (material, slot, name, lore) is yours to change.

Extra keys

On top of the normal layout keys, editor files use three extras:

Key	Description
<Name>-Slots + <Name>-Icon	A content slot list (Crate-Slots, Reward-Slots, Item-Slots, Line-Slots) and the template for each entry. The icon’s Name and Lore are applied to each entry’s own item.
Icons:	Buttons that wear a live item from the crate file (its display item, place item, and so on). Each needs a Slot, and its Name and Lore are applied to that item.
States:	Toggle buttons with Enabled / Disabled looks, plus Locked where PICK mode fixes the value.

The paged editors (crates.yml, rewards.yml, lines.yml) also have Temporary-Icons (No-Previous-Page, No-Next-Page) and get {page}, {pages}, {max-page} and {results} on every item.

crates.yml - the crate list

Id	Does
Crate-Slots / Crate-Icon	Every crate, drawn with its display item. Left click edits, shift right click deletes.
Create-Item	Creates a crate from the held item (chat prompt for the name).

Crate icon tokens: {crate} (the id), {file}, {mode}, {animation}, {rewards}, {slot}. Menu tokens: {crates} (number of crates).

crate.yml - one crate

Title: "Editing: {crate}"
Key-Balance-Amount: "-1 &8(key balance)"
Toggle-Names:
  Enabled: "&a&lENABLED"
  Disabled: "&c&lDISABLED"

Key	Description
Key-Balance-Amount	What {display-amount} shows when the crate uses -1 (the key balance). Required.
Toggle-Names.Enabled / Disabled	What {particles} and {hologram} show. Required.

Id	Does
Mode-Item	Switches ROLL / PICK.
Animation-Item	Cycles the spin animation.
Preview-Item	Preview toggle. States: Enabled, Disabled, Locked.
Preview-Menu-Item	Cycles the preview design.
Mass-Open-Item	Mass open toggle. States: Enabled, Disabled, Locked.
Display-Amount-Item	Chat prompt for the display amount.
Display-Slot-Item	Chat prompt for the display slot.
Insufficient-Empty-Item	Shown in place of the no-keys icon while the crate has no No-Keys-Item.
Particles-Item, Holograms-Item, Rewards-Item	Open the particle, hologram and reward editors.
Delete-Item	Deletes the crate behind the confirm menu.
Icons.Display-Item, Icons.Place-Item, Icons.Insufficient-Item	Wear the crate’s display item, place item and no-keys item. Click with an item in hand to replace; shift right click clears the no-keys item.

Tokens: {crate}, {file}, {mode}, {next-mode}, {animation}, {animations} (options to cycle, including none), {preview-menu}, {previews} (number of designs), {display-amount}, {display-slot}, {rewards}, {particles}, {hologram}.

rewards.yml and reward.yml

rewards.yml lists the rewards of one crate.

Id	Does
Reward-Slots / Reward-Icon	Every reward. Left click edits, right click moves later, shift left click moves earlier, shift right click deletes.
Create-Item	Adds the held item as a new reward.

Reward icon tokens: {crate}, {reward} (the id), {position}, {total}, {chance}, {share} (its share of the crate total, like 12.5%), {items}, {actions}. Menu tokens: {crate}, {rewards}.

reward.yml edits one reward (title takes {reward}).

Id	Does
Icons.Display-Item	Wears the reward’s display item. Click with an item in hand to replace.
Chance-Item	Chat prompt for the chance.
Items-Item	Opens the items grid.
Actions-Item	Opens the action list.

Tokens: {crate}, {reward}, {chance}, {share}, {items}, {actions}.

items.yml - reward items

Id	Does
Item-Slots / Item-Icon	The reward’s items. The icon’s Lore is appended to each item’s own lore, so the real name and lore stay visible. The number of slots is the item limit (36 by default).

Item icon tokens: {position}, {total}, {amount}. Menu tokens: {crate}, {reward}, {items}, {capacity}.

lines.yml - actions and hologram lines

One list editor used for both reward actions and hologram lines. Its title takes {label} and {crate}; {label} comes from Editor-Format.Line-Labels in config.yml (Action or Line).

Id	Does
Line-Slots / Line-Icon	Every line. Left click rewrites, right click moves later, shift left click moves earlier, shift right click deletes.
Create-Item	Adds a line typed in chat.

Line icon tokens: {line}, {position}, {total}, {label}. Menu tokens: {crate}, {label}, {total}.

particles.yml and holograms.yml

File	Ids	Tokens
particles.yml	Enabled-Item (States: Enabled, Disabled), Interval-Item, Particle-Item, Color-Item	{crate}, {interval}, {particle}, {color}
holograms.yml	Enabled-Item (States: Enabled, Disabled), Height-Item, Interval-Item, Lines-Item	{crate}, {height}, {interval}, {lines}

confirm.yml - deletions

Questions:
  Delete-Crate: "&7Delete the crate &f{crate}&7?"
  Delete-Reward: "&7Delete the reward &f{reward}&7?"

Id	Does
Questions.Delete-Crate / Delete-Reward	The {question} text. Required.
Confirm-Item	Confirms the deletion.
Cancel-Item	Ships with [back], returning without deleting.
Info-Item	Shows {question}.

Sounds and words

Editor clicks play ANIMATIONS-TOGGLE, opening the editor plays CRATE-MENU-OPEN, and moving entries plays PAGE-CHANGED, all from config.yml. Words shared by several editor menus or used in chat prompts are in Editor-Format.