Skip to content

Getting Started

  1. Stop the server.
  2. Make sure KyuubiSoft Core 2.9.9 or newer is installed. Achievements needs it; when you update, update Core first.
  3. Put KyuubiSoftAchievements-3.1.6.jar into the server’s mods/ folder. When you update, remove the old KyuubiSoftAchievements-*.jar first.
  4. Start the server. The plugin creates its data folder mods/kyuubisoft_achievements/ and fills it with the default files.

mods/
KyuubiSoftAchievements-3.1.6.jar
kyuubisoft_achievements/
config.json main configuration
configs/ shipped content (replaced on updates, keep your edits out of it)
achievements.json 277 standard achievements
mmo_achievements.json 121 MMO Skill Tree achievements
rpg_leveling_achievements.json 34 RPG Leveling achievements
lootbags.json 20 lootbag rewards
custom/ your own content (never overwritten)
custom_achievements.json, custom_mmo_achievements.json,
custom_rpg_leveling_achievements.json, custom_lootbags.json
*.example templates
localization/ en-US.json ... tr-TR.json (9 languages) + custom_<lang>.json
players/<uuid>.json per player: progress, unlocks, points, title, waiting rewards
stats/ statistics export and server records
backups/ backup sets of the admin window (last 20)
admin/ players tool: action log and actions queued for offline players

With MySQL set up in KyuubiSoft Core, player data is stored there instead of players/.


CommandOpens
/ksachievements (/ac)The achievement book on the overview
/kstitles (/title)The book on the titles tab
/ksrewards (/rw)The book on the rewards tab

New players also get the green Achievement Book item on their first join (item.hotbarSlot, default 7 counted from 0, so the eighth slot). Right-click it to open the book.

Give yourself ks.achievements.admin, then:

Terminal window
# open the admin window
/acadmin panel
# grant yourself an achievement (with its rewards)
/acadmin grant YourName first_blood
# list a player's achievements
/acadmin list YourName

The admin window is also a tile in the KyuubiSoft hub (/ksadmin).