Configuration

One config.yml covers tiers, cooldowns, power scaling, particle quality, storage and every message. Messages use MiniMessage formatting.

License

license:
  key: "YOUR-LICENSE-KEY"

Core settings

settings:
  max-tier: 5                  # up to 10 supported
  guard-cooldown: 4            # seconds between guard reactions
  ultimate-base-cooldown: 45    # seconds at tier 1
  ultimate-cooldown-per-tier: 4 # seconds shaved per tier
  passive-refresh-ticks: 40     # how often passives re-apply
  particle-quality: HIGH        # LOW / MEDIUM / HIGH / ULTRA
  unbreakable: true
  shield-drop-on-death: false   # false = returned on respawn
  join-shield: false           # give a shield on first join

◆

particle-quality is your performance dial. Set LOW on a 100+ player server; ULTRA for a cinematic showcase or trailer.

Power scaling

power:
  ability-radius-base: 4.0
  ability-radius-per-tier: 0.6
  ability-damage-base: 3.0
  ability-damage-per-tier: 1.0
  wraithveil-dodge-base: 8       # percent
  wraithveil-dodge-per-tier: 3
  bloodthorn-reflect-base: 15     # percent
  bloodthorn-reflect-per-tier: 5

Storage

storage:
  type: SQLITE            # SQLITE or MYSQL
  mysql:
    host: localhost
    database: shieldsmp
    username: root
    password: ""

Messages

All messages use MiniMessage — gradients, hover and click tags all work:

messages:
  prefix: "<gradient:#00E5FF:#0088FF><bold>SHIELD</bold></gradient> <gray>» </gray>"
  forged: "<green>You forged the <white><shield></white> shield!"
  upgraded: "<green>Upgraded to <white>Tier <tier></white>!"
  max-tier: "<red>This shield is already at max tier."
  ultimate-cooldown: "<red>Ultimate ready in <yellow><time>s</yellow>."

Config version

config-version: 1