Default Configs

SoapsTraits ships three main config files. On first run they are copied to plugins/SoapsTraits/. On /sts reload, missing keys from the JAR are merged into your live files without overwriting your values.

config.yml

default-trait: human

settings:
  debug-mode: false
  strict-config-validation: true
  class-sync: true
  respect-manual-assign: true
  tick-interval: 20
  save-interval: 6000
  max-cooldown-ticks: 72000
  gui-click-debounce-ms: 150

gui:
  enabled: true

Key	Default	Description
default-trait	human	Trait assigned when no class match exists
settings.debug-mode	false	Log trigger/condition/action details to console
settings.strict-config-validation	true	Skip entire effects with invalid conditions/actions
settings.class-sync	true	Keep active trait aligned with MMOCore class on join
settings.respect-manual-assign	true	/sts set survives relog; class changes still sync
settings.tick-interval	20	How often tick triggers are evaluated (ticks)
settings.save-interval	6000	Auto-save playerdata.yml interval (ticks, 6000 = 5 min)
settings.max-cooldown-ticks	72000	Hard cap for effect cooldown values
settings.gui-click-debounce-ms	150	GUI click debounce
gui.enabled	true	SoapsCommon suite master GUI switch for /sts gui

Only gui.enabled controls the GUI. There is no separate settings.gui-enabled key.

traits.yml

Contains all trait definitions under traits:. See Traits Configuration.

Bundled content (1.1.x):

• 7 class-bound traits: human, warrior, mage, rogue, paladin, archer, berserker
• 3 showcase traits without class binding
• Combat-aware procs, distance_above for archer, out-of-combat human sustain
• Inline comments documenting triggers, conditions, actions, and balance ranges

The file header documents the full schema for quick reference while editing.

messages.yml

All player-facing text: command output, errors, GUI titles, button labels, debug lines.

Uses MiniMessage gradients with consistent color meanings:

Meaning	Gradient
Success	green to teal
Error	red to orange
Warning	amber to orange
Info	blue to purple
Headers	gold to purple

Legacy & color codes still work where parsed through SoapsCommon text utilities.

Edit messages.yml to match your server's tone. Reload with /sts reload.

playerdata.yml

Auto-generated. Do not hand-edit unless you know the format.

<uuid>:
  trait: warrior
  enabled: true
  manual-override: false
  cooldowns: {}
  runtime-stats: {}

Field	Meaning
trait	Active trait id
enabled	Effect procs on (/sts toggle)
manual-override	Set by /sts set; protects against join class-sync when configured
cooldowns	Admin trait-wide lock timestamps
runtime-stats	Reserved / legacy map

• Created on first trait assignment
• Saved on interval (save-interval) and on shutdown

Related pages

• Getting Started
• Traits Configuration
• Commands and Permissions