Docs

Configuration files

Everything lives in plugins/Warden/. /clan admin reload re-reads all of them without a restart.

FileHolds
config.ymlLanguage, storage backend, clan limits and naming rules, chat, friendly fire
roles.ymlRole hierarchy and the internal permission matrix
levels.ymlExperience curve, perks per level, experience sources
wars.ymlDuration, minimum members, victory condition, rewards
bank.ymlBank cap and movement log retention
gui.ymlRows, slots and materials for every menu
commands.ymlBase command, aliases and every subcommand word
stats.ymlWhich statistics exist and which are admin-editable
upgrades.ymlThe upgrade catalogue
integrations.ymlBridge toggles, reflection method names, hologram positions
bank-currencies.ymlPulsePrison currencies and their per-level caps
clan-xp-sources.ymlWhich PulsePrison actions grant clan experience
war-integration.ymlAtomCombat combat profile and war rules
messages/<lang>.ymlEvery single piece of text

config.yml

yaml
language:
  default: en
storage:
  type: yaml
clans:
  home-cooldown-seconds: 30
  invite-expiration-seconds: 60
  default-open: false
  name-min-length: 3
  name-max-length: 16
  name-pattern: "[A-Za-z0-9_ ]+"
  tag-min-length: 2
  tag-max-length: 5
  tag-pattern: "[A-Za-z0-9]+"
  description-max-length: 64
  allowed-tag-colors:
    - dark_aqua
    - aqua
chat:
  prefix-character: "!"
  global-prefix-enabled: true
  tablist-prefix-enabled: true
  prefix-refresh-seconds: 5
relations:
  block-friendly-fire: true

allowed-tag-colors accepts any Minecraft named colour. Anything outside the list is rejected.

global-prefix-enabled wraps whatever renderer other chat plugins installed rather than replacing it, so it coexists with most chat formatters.

wars.yml

yaml
defaults:
  duration-minutes: 30
  minimum-members: 3
  declaration-expiration-seconds: 120
victory:
  condition: most-kills
  score-target: 25
rewards:
  money: 5000.0

condition accepts most-kills, where the highest score when time runs out wins, or first-to-score, where the war ends the moment a clan reaches score-target.

A tie ends the war as a draw: no reward, no win or loss recorded.

If the bank cap would reject the reward, the victory message reports the amount actually credited, not the configured one.

bank.yml

yaml
max-balance: 1000000.0
log-retention: 50

max-balance is the base cap. Level perks and the bank-capacity-bonus upgrade add on top of it.

stats.yml

yaml
tracked-stats:
  - kills
  - deaths
  - wars-won
  - wars-lost
  - bank-deposited
editable:
  - kills
  - deaths

Only statistics in tracked-stats are recorded at all. Only those in editable can be changed with /clan admin setstat.

Configuration files | Warden Docs