Configuration

One config.yml runs everything. Colours use & codes, and &#RRGGBB hex is supported anywhere a message is.

License

license:
  key: "YOUR-LICENSE-KEY"

▲

Never post your config.yml publicly with the key filled in. Blank it out before sharing configs for support.

Storage

Trust data lives here. SQLite needs no setup; MySQL is for networks sharing data across servers.

storage:
  type: sqlite          # sqlite (default) or mysql
  mysql:
    host: localhost
    port: 3306
    database: macesmp
    username: root
    password: ""
    use-ssl: false
    table-prefix: "macesmp_"

Worlds

Two modes, one list. blacklist means maces work everywhere except the listed worlds; whitelist means they work only in them.

worlds:
  mode: blacklist
  list:
    - world_nether
    - world_the_end

◆

Running an SMP where maces are the whole point? Switch to whitelist and list only your survival world — spawn, lobby and minigame worlds stay untouched without listing each one.

Claim rule

The single most important setting for a survival server. Three modes:

Mode	Behaviour	Needs
`griefprevention`	Wilderness → allowed. Inside a claim → owner and trusted players only.	GriefPrevention
`regions`	Blocked inside any WorldGuard region or BetterTeams claim.	WorldGuard or BetterTeams
`none`	No claim restriction at all. Full anarchy.	Nothing

claim:
  mode: griefprevention

Trust

Players trust each other directly — a trusted player can use abilities inside your claim.

trust:
  max-per-player: 25

Disabled maces

Managed live with /macesmp enable|disable <mace> — the config just persists it:

disabled-maces: []

Cooldowns & effects

cooldowns:
  tempest_mace: 30
  cataclysm_mace: 30
  oblivion_mace: 30
  frostbite_mace: 30
  inferno_mace: 30
  storm_mace: 30
  cataclysm_mace_passive: 3

effects:
  frostbite_freeze_seconds: 15     # targets frozen in place + slowed
  inferno_burn_seconds: 6          # targets burn
  storm_strikes: 2                 # lightning bolts per use
  storm_self_immune_seconds: 2     # caster takes no lightning damage

Cooldowns can also be changed in-game without touching the file: /macesmp cooldown <mace> <seconds>.

Messages

Every string is editable. {prefix} is substituted into any message that includes it, and each message has its own placeholders — {player}, {mace}, {qty}, {seconds}, {coords}, {limit}:

messages:
  prefix: "&8[&bMaceSMP&8]&r "
  claim-denied: "&c✖ &7You can only use mace abilities &finside your own claim&7!"
  world-disabled: "&c✖ &7Mace abilities are &fdisabled in this world&7!"
  mace-disabled: "&c✖ &7This mace is &fdisabled&7!"
  blacklisted: "&c✖ &7You are &fblacklisted &7from using mace abilities!"
  oblivion-banned: "&b{player} &7has been banned by the &5Oblivion Mace"
  oblivion-ban-reason: "&cKilled by the Oblivion Mace"

That's a trimmed view — the file carries the full set covering trust, blacklist, crafting, cores, cooldowns and every command usage string.

Config version

config-version: 5

▲

Don't edit this. It's how MaceSMP detects an outdated config.yml after an update.