config.yml

# ============================================================
#  RoodyKits · config.yml · by Roody
#
#  Files:
#    config.yml    settings, default values and the pieces of a tier kit
#    tiers.yml     the tiers
#    kits/         the kits of /kit, one file each (or /kit create, /kit edit)
#    menus/        the menus of /kit: where each button goes and with what item
#    lang/         messages, menu texts, the name and lore of the pieces, and the
#                  names of enchantments, effects and attributes
#    data/         what each player did with the kits (written by the plugin)
#
#  Colours: &a, &l... and hex &#RRGGBB. MiniMessage works too,
#  for example <gradient:#00fbff:#9eefff>text</gradient>.
#
#  After editing any of them: /rk reload. The pieces players already
#  have update themselves.
# ============================================================

# Language of messages and of the pieces' name and lore: the name of a file in lang/ (en, es, or
# your own). The pieces always use this language.
language: en
# true = each player sees the messages in their Minecraft language when lang/ has that file
# (es_es.yml or es.yml...).
per-player-language: false

# More names for /roodykits (the tier kits). Example: [rk, tiers]
command-aliases: [rk, roodykit]
# More names for /kit (the players' kits). If another plugin already has a name (Essentials has
# /kit and /kits), that one keeps it: RoodyKits' still works as /roodykits:kit, or turn the other
# one off in commands.yml.
kit-command-aliases: [kits]

# ------------------------------------------------------------
#  Kits (/kit): each one is a file in kits/. Made in the game with /kit create <id> and
#  /kit edit <kit>; their keys are explained in kits/starter.yml.
# ------------------------------------------------------------
kits:
  # What a claim does when the inventory has no room for everything: false = it is refused
  # (saying how many slots are missing), true = the rest falls on the ground. A kit can set its own.
  drop-items-when-full: false
  # true = /kit does not show the kits a player has no permission for.
  hide-locked: false
  # Minecraft sound ids, with volume and pitch ("" = none).
  sounds:
    claim: "entity.player.levelup 0.6 1.4"
    error: "entity.villager.no 0.6 1"

settings:
  # Updates the pieces that already exist when you change these files.
  # It happens on join, with /rk reload, when a chest is opened, when a
  # piece is picked up and every 'update-every' seconds.
  update-pieces: true
  update-every: 10
  # When a kit (or a tier kit) is given, the armour is put on right away if that slot is
  # free. Worn armour is never replaced.
  equip-armor: true
  # Levels in roman numerals (Protection XL). false = Protection 40.
  roman-numerals: true

  # Effects of the bonus for wearing the full set of a tier.
  # They come back on their own after a totem, milk, /heal or /effect clear.
  bonus:
    particles: false
    icon: false
    # How often the armour is checked, in ticks (20 ticks = 1 second).
    interval-ticks: 20

# ------------------------------------------------------------
#  Default values of every tier.
#  Each tier can change any of them in tiers.yml.
# ------------------------------------------------------------
defaults:
  # Unbreakable (the same as /ie unbreakable).
  unbreakable: true
  # Enchantment glint. true = always, false = never.
  glow: true
  # Vanilla texts that are hidden (the lore already shows them).
  flags:
    - HIDE_ENCHANTS
    - HIDE_ATTRIBUTES
    - HIDE_UNBREAKABLE
    - HIDE_DYE
    - HIDE_ARMOR_TRIM
  # Extra items added to EVERY kit (besides the tier's own).
  # Short format "MATERIAL amount" or full with name and lore:
  #   - "BREAD 16"
  #   - { material: GOLDEN_APPLE, amount: 4, name: "&6Apple", lore: ["&7For the fight"] }
  extra-items: []
  # Off-hand item for EVERY kit (any item, same format as extra-items), for example
  # "TOTEM_OF_UNDYING". false = none. A tier can set its own or "offhand: false".
  offhand: false

# ------------------------------------------------------------
#  The pieces of every kit (their ids are in the pieces already
#  given: renaming one turns those into normal items).
#  - To add a tool, copy a line and change it.
#  - To take it out of every kit, delete its line.
#  - group: which enchantments and attributes of the tier it takes.
#  - material: {armor} and {tools} become the tier's materials
#    ({armor}_HELMET -> NETHERITE_HELMET).
#    A fixed material works too: material: BOW
#  - extra-lore: lines only for this piece (optional).
# ------------------------------------------------------------
pieces:
  helmet:     { name: "Helmet",     group: armor,   material: "{armor}_HELMET" }
  chestplate: { name: "Chestplate", group: armor,   material: "{armor}_CHESTPLATE" }
  leggings:   { name: "Leggings",   group: armor,   material: "{armor}_LEGGINGS" }
  boots:      { name: "Boots",      group: armor,   material: "{armor}_BOOTS" }
  sword:      { name: "Sword",      group: weapons, material: "{tools}_SWORD" }
  axe:        { name: "Axe",        group: weapons, material: "{tools}_AXE" }
  pickaxe:    { name: "Pickaxe",    group: tools,   material: "{tools}_PICKAXE" }
  hoe:        { name: "Hoe",        group: tools,   material: "{tools}_HOE" }
  shovel:     { name: "Shovel",     group: tools,   material: "{tools}_SHOVEL" }

# Tell the console and admins (permission roodykits.update) when a new version is out
# on plugins.roody.es.
check-updates: true