Configuration reference
This is the config.yml SkillsRPG writes on first start, comments included. Every key you see here is the key the plugin reads; there are no hidden ones. Change a value, reload, and it applies.
Top-level sections: language, license-key, storage, mana, hud, autosave-minutes, audit-log, anti-abuse, integrations, leaderboards, level-rewards, respec.
# SkillsRPG configuration — TTS-Studio
# Documentation: https://docs.tiamatmc.net/skillsrpg/
# Active language. ISO-639-1 two-letter code (lowercase).
# Bundled out of the box: es (Spanish), en (English).
# Missing keys fall back to en automatically. Operators can drop extra
# lang/<code>.yml files in plugins/SkillsRPG/lang/.
language: en
# Your licence key, from the store where you bought SkillsRPG. Required: without it
# SkillsRPG switches itself off. BuiltByBit downloads already carry theirs, so leave it
# blank there. Checked in the background at startup and every six hours; if the
# licence server cannot be reached, SkillsRPG keeps running.
license-key: ""
storage:
# Options: sqlite | mysql
type: sqlite
sqlite:
file: skillsrpg.db
mysql:
host: localhost
port: 3306
database: skillsrpg
user: skillsrpg
password: changeme
mana:
# max = base + per_total_level * total_skill_level (capped at max-cap)
base: 50
per-total-level: 1
max-cap: 500
regen-per-second: 5 # mana/s when not in combat
combat-pauses-regen: true
hud:
mana-bossbar: true
ability-actionbar: true
actionbar-duration-ticks: 60
autosave-minutes: 5
audit-log: false
anti-abuse:
placed-block-tracker-ttl-minutes: 60
spawner-mob-xp-multiplier: 0.2
adventure-mode-gives-xp: false
integrations:
worldguard:
respect-pvp-flag: true
afkguard:
block-xp-when-afk: true
chunkclaim:
respect-pvp-flag: true
combatlogger:
share-combat-state: true
# Leaderboards per skill and by total level: /skills top, the Leaderboards button in /skills,
# and PlaceholderAPI (%skillsrpg_top_<board>_<n>_name%, ..._level%, ..._xp%,
# %skillsrpg_rank_<board>%; <board> = total or a skill id). Worked out in the background every
# few minutes, so a busy server never waits for them.
leaderboards:
enabled: true
refresh-minutes: 5
# How many players each board keeps for the menu and the top_<n> placeholders.
size: 100
# Console commands (and an optional message) when a player reaches a level. Group them under a
# skill id (swords, axes, archery, defense, mining, woodcutting, farming, fishing) or "any",
# keyed by a level ("25") or a step ("every-10" = 10, 20, 30...). Placeholders in commands:
# {player} {uuid} {skill} {level}; in the message: <skill> <level>. Each level pays once per
# player and skill, also after /skills admin reset or setlevel.
level-rewards:
enabled: false
any:
every-10:
commands:
- "give {player} minecraft:experience_bottle 8"
message: "<gold><skill> <level>!</gold> <gray>Here are 8 bottles o' enchanting."
mining:
50:
commands:
- "give {player} minecraft:diamond 5"
message: "<aqua>Mining 50 — five diamonds for the road."
respec:
base-cost: 1000
scale-factor: 1.5