TwoCubeStrike Wiki

This page explains what each file does, how to customize branding, and how to safely change menus with examples.

Commands

• /kiteditor Open the standard kit editor flow

• /goldenhead give [amount] Give Golden Head items

• /totempractice Open Totem Practice menu

• /twocubestrike reload Reload plugin configs

• /twocubestrike editcrystal Open crystal room layout edit mode

• /sep reload Reload SEP placeholder cache/services

Permissions

• twocubestrike.goldenhead.give Give Golden Heads

• twocubestrike.editcrystal Edit crystal category layout in GUI

• twocubestrike.reload Reload TwoCubeStrike files

• twocubestrike.sep.reload Reload SEP compatibility system

• twocubestrike.round.* Access all duel rounds when menus/rounds-config.yml round permission mode is enabled

• twocubestrike.round.1 Example round node used when menus/rounds-config.yml round permission mode is enabled

• twocubestrike.trimmer.use Use Armor Trimmer when menus/armor_trimmer.yml permission mode is enabled

Configuration File Map

• config.yml → global feature toggles, allowed worlds, chat format, join/leave settings.

• messages.yml → all customizable messages and lore templates.

• sounds.yml → central sound aliases and sound controls (if used in your setup).

• golden-head.yml → Golden Head item, cooldown, effects, particles, command messages.

• menus/kiteditor.yml → normal kit editor GUI title, size, filler, buttons, armor/offhand slots.

• menus/kitroom.yml → crystal room GUI structure and categories.

• kitroom_items.yml → item data for each crystal room category.

• menus/rounds-config.yml → duel kit menu, round menu, round permissions, command mapping.

• menus/armor_trimmer.yml → armor trim editor titles, options, permission node, sounds.

Branding Guide (Server Name, Theme, Style)

A) Change GUI titles

• menus/kiteditor.yml → title

• menus/kitroom.yml → title

• menus/rounds-config.yml → kit_menu.title, round_menu.title

• menus/armor_trimmer.yml → gui.title

title: "&8MyNetwork » Kit Editor"
round_menu:
  title: "&d&lRound Selection"

B) Change button style (name + lore + icon)

Edit button names/lore in menus/kiteditor.yml and menus/kitroom.yml.

buttons:
  save:
    material: "LIME_BUNDLE"
    name: "&a&lSAVE LOADOUT"
    lore:
      - "&7Store your current setup"
      - "&eClick to confirm"

C) Change message branding (prefix + tone)

Use messages.yml for all player-facing text.

common:
  no_permission: "&c[MyNetwork] You do not have permission."

kiteditor:
  kit_saved: "&a[MyNetwork] Kit saved successfully!"

D) Change chat format branding

Edit CHAT_FORMAT in config.yml.

CHAT_FORMAT: "&8[&bMyNetwork&8] &f%player_name% &7» &f{MESSAGE}"

Step-by-Step: Common Customizations (with Examples)

Example 1: Restrict kit editor to specific worlds

File: config.yml

kiteditor:
  allowed_worlds:
    - "MainSpawn"
    - "PracticeLobby"

Example 2: Move Save/Reset/Leave button slots

File: menus/kiteditor.yml

buttons:
  save:
    slot: 20
  reset:
    slot: 22
  leave:
    slot: 24

Important: Do not overlap button slots with armor/offhand slots.

Example 3: Change round icons and slot positions

File: menus/rounds-config.yml

rounds:
  1:
    material: "IRON_SWORD"
    slot: 10
  3:
    material: "DIAMOND_SWORD"
    slot: 11

Example 4: Configure filler panes only on selected slots

File: menus/rounds-config.yml

duel_filler:
  material: "BLACK_STAINED_GLASS_PANE"
  display_name: "&f"
  slots: [0,1,2,3,4,5,6,7,8]

round_filler:
  material: "GRAY_STAINED_GLASS_PANE"
  display_name: "&7"
  slots: [0,1,2,3,4,5,6,7,8,18,19,20,21,22,23,24,25,26]

Example 5: Enable per-round permission locking

File: menus/rounds-config.yml

round_permissions:
  enabled: true
  node_prefix: "twocubestrike.round."
  deny_message: "&cYou need &e{permission} &cto play Round {round}."
  locked_item:
    material: "BARRIER"
    amount: 1

Then grant permissions like:

twocubestrike.round.1
twocubestrike.round.3
twocubestrike.round.5

Example 6: Tune Golden Head cooldown and effects

File: golden-head.yml

cooldown: 5
effects:
  - "ABSORPTION:120:1:true:false"
  - "REGENERATION:6:1:true:false"
  - "SPEED:10:0:true:false"

Example 7: Enable Armor Trimmer permission node

File: menus/armor_trimmer.yml

permissions:
  enabled: true
  node: "twocubestrike.trimmer.use"

Crystal Room Layout Editing (No Manual Slot Guessing)

1. Run /twocubestrike editcrystal.

2. Move category items inside editable range (item_slots.start to item_slots.end).

3. Switch category to auto-save current category layout.

4. Press ESC to save final positions into kitroom_items.yml.

Locked in edit mode: category buttons, action buttons, armor slots, offhand slot, and structural GUI slots.

Placeholders You Can Use

General

• {player}, %player%

• %sender%, %sender_name%

• <playername>, <target>, %target%, %target_name%

Rounds

• {round}, %round%

• {permission}, %permission%

• {round_name}, %round_name%

Golden Head

• {time} (cooldown seconds remaining)

SEP placeholders

• %SEP_inqueuecount_<kit>%

• %SEP_dynamicqueue_<kit>%

• %SEP_dynamicqueue2_<kit>%

• %SEP_infightcount_<kit>%

• %SEP_dynamicfight_<kit>%

• %SEP_partymember_<n>%

SEP identifier is case-sensitive: SEP.

Safe Editing Checklist

• Use valid Material names for your server version.

• Keep slot values in range: 0 to size - 1.

• Avoid slot collisions (buttons, armor, offhand, categories).

• After each change, run /twocubestrike reload and test once.

• If placeholders seem stale, run /sep reload