Configuration

Everything player-facing lives in config.yml and messages.yml. Below are the sections you'll touch most.

License & storage

# plugins/MaceSMP/config.yml
license-key: "XXXX-XXXX-XXXX-XXXX"   # from your BuiltByBit purchase

storage:
  type: SQLITE          # SQLITE or MYSQL
  mysql:
    host: localhost
    port: 3306
    database: macesmp
    username: root
    password: ""

▲

Never share your config.yml publicly with the license key inside. Blank it out before posting configs for support.

Per-mace tuning

Each mace has its own block. Rename it, retune it, or disable it entirely:

maces:
  storm:
    enabled: true
    display-name: "<gradient:#DCBB77:#A87F3C>⚡ Storm Mace</gradient>"
    ability-cooldown: 45        # seconds
    ability-damage: 8.0          # hearts x2
    ability-radius: 4            # blocks
    particles: true
    sound: ENTITY_LIGHTNING_BOLT_THUNDER
    custom-model-data: 1001

Protection hooks

protection:
  respect-griefprevention: true   # block ability damage in claims
  respect-pvp-toggle: true        # honor /pvp off players
  disabled-worlds:
    - spawn
    - lobby

Messages

All messages support MiniMessage formatting (gradients, hover, click) and live in messages.yml:

prefix: "<gradient:#DCBB77:#A87F3C><bold>MACE</bold></gradient> <dark_gray>»</dark_gray> "
ability-used: "<gray>You unleashed <gold>%mace%</gold>!"
on-cooldown: "<red>Ability ready in <yellow>%time%s</yellow>."
claim-blocked: "<red>Abilities are disabled inside claims."

Resource pack

Upload the bundled MaceSMP-Pack.zip to your host or a CDN.
Set resource-pack= URL and resource-pack-sha1= in server.properties.
Keep custom-model-data values in config.yml matched with the pack (defaults already match).