Skip to content

Achievements

This page explains the achievement structure and documents all built-in achievements.

Each achievement is defined as a JSON object with the following fields:

{
"id": "spider_hunter_1",
"category": "combat",
"iconItem": "Deco_Trophy_Harvest",
"hidden": false,
"difficulty": "easy",
"requires": null,
"showRequires": true,
"title": {
"id": "spider_slayer",
"color": "#FF5555"
},
"trigger": {
"type": "kills",
"target": "Spider",
"count": 1
},
"rewards": [
{
"type": "item",
"itemId": "Ingredient_Bar_Gold",
"amount": 10
}
],
"additionalInfo": {
"text": "Hunt spiders in dark caves!",
"color": "#AAAAAA"
}
}
FieldTypeDescription
idstringUnique identifier (snake_case recommended)
categorystringCategory for filtering: combat, progression, exploration, social, husbandry, secret
triggerobjectUnlock condition (see Triggers)
FieldTypeDefaultDescription
iconItemstring"Ore_Gold"Item ID for the achievement icon
hiddenbooleanfalseHide as ”???” until unlocked
difficultystring"normal"Difficulty tier: easy, normal, hard, epic, legendary (sets the points and the rarity ring in the book)
requiresstring/arraynullPrerequisite achievement ID(s)
showRequiresbooleantrueShow prerequisites in the book’s detail panel
titleobjectnullUnlockable title reward
rewardsarray[]Item/command rewards
additionalInfoobjectnullCustom info text
custombooleanfalseMark as custom achievement

Triggers define how achievements are unlocked. These are the trigger types the server really counts (the editor of the admin window offers exactly this list):

GroupTrigger types
Mining and buildingblocks_mined, blocks_chopped, blocks_dug, blocks_broken (all kinds), blocks_placed, blocks_harvested, flowers_picked
Combatkills, player_kills, damage_dealt, pvp_damage_dealt, pve_damage_dealt, damage_taken
Itemsitems_collected (the most of an item held at once), items_crafted, equip_item, full_armor_set
Worldzones_discovered, distance_walked, playtime_minutes, weekend_login
Social and NPCschat_messages, npc_interact, dialog_complete (see NPC Integration)
Levels (with the mod)skill_level (MMO Skill Tree), rpg_level, rpg_xp (RPG Leveling), leveling_level, leveling_xp (LevelingCore), endless_level, endless_xp, endless_skill_level, endless_class, endless_race (Endless Leveling)
Dungeons (with KyuubiSoft Dungeons)dungeon_complete_any, dungeon_complete_<biome>, dungeon_rarity_<rarity>, dungeon_no_death. dungeon_boss_any / dungeon_boss_<biome> exist, but Dungeons does not send boss kills yet
Specialmanual (only by admin grant), auto_on_prerequisites (unlocks when the requirements are met)

Targets can be an exact id, a prefix (Ore_), a wildcard (Snake_*, Golem_Crystal_*), a comma list or any. Some triggers are easy to abuse; the admin window marks them and warns when such a trigger gives rewards.

Achievements with the manual trigger show as Special in the book. Husbandry, fishing, farming and death achievements have no tracker yet and use manual.

Tracks blocks mined by the player.

{
"type": "blocks_mined",
"target": "Ore_Iron",
"count": 100
}

Target Options:

  • Specific block: "Ore_Iron", "Stone", "Wood_Oak"
  • Any block: "any"
  • Prefix match: "Ore_" matches all ores, "Wood_" matches all wood

Tracks blocks placed by the player.

{
"type": "blocks_placed",
"target": "any",
"count": 1000
}

Tracks entity kills.

{
"type": "kills",
"target": "Spider",
"count": 50
}

Target Options:

  • Specific entity: "Spider", "Wolf", "Goblin"
  • Any mob: "any_mob"
  • Any player: "any_player"
  • Any entity: "any"

Tracks crafted items.

{
"type": "items_crafted",
"target": "Weapon_Sword_Iron",
"count": 1
}

Tracks zone/area discoveries.

{
"type": "zones_discovered",
"target": "any",
"count": 10
}

Tracks chat messages sent.

{
"type": "chat_messages",
"count": 100
}

Tracks playtime in minutes.

{
"type": "playtime_minutes",
"count": 60
}

:::tip Playtime Display Playtime is calculated in real-time, including the current session. Progress shows as “X / Y Minutes” in the book. :::

Tracks walking distance in blocks.

{
"type": "distance_walked",
"count": 10000
}

Tracks when player equips a complete armor set.

{
"type": "full_armor_set",
"target": "iron"
}

Available Materials: iron, copper, bronze, steel, cobalt, mithril, thorium, adamantite, onyxium, prisma

Tracks when a specific item is equipped.

{
"type": "equip_item",
"target": "Weapon_Sword_Legendary"
}

Admin-only manual grant. Cannot be unlocked through gameplay.

{
"type": "manual"
}

Automatically unlocks when all prerequisites are met.

{
"type": "auto_on_prerequisites"
}

Grants items to the player’s inventory.

{
"type": "item",
"itemId": "Ingredient_Bar_Gold",
"amount": 10
}

If the inventory is full, only what fits is handed out; the rest waits in the Rewards tab of the book. See Rewards.

Executes a server command.

{
"type": "command",
"command": "give {player} diamond 5",
"executor": "console"
}
FieldOptionsDescription
executor"console"Execute with full permissions (also the default when the field is missing)
executor"player"Execute as the player

Placeholder: \{player\} is replaced with the player’s name.

:::caution Console command rewards Adding, changing or removing a command reward that runs as the console needs ks.core.admin.dialog.console in addition to ks.achievements.admin (in the admin window, when saving and in web editor imports). See Permissions. :::

Grants a lootbag that is opened in the Rewards tab of the book (/ksrewards).

{
"type": "lootbag",
"lootbagId": "starter_pack"
}
FieldTypeDescription
typestring"lootbag"
lootbagIdstringTemplate ID from lootbags.json

Examples:

"rewards": [
{ "type": "lootbag", "lootbagId": "welcome_gift" },
{ "type": "lootbag", "lootbagId": "miner_reward" },
{ "type": "lootbag", "lootbagId": "legendary_hoard" }
]

:::tip Pending Rewards Lootbags wait in the Rewards tab of the book (/ksrewards). They are rolled once and the result is saved, so a relog never re-rolls them. :::

See Lootbags Configuration for detailed lootbag template configuration.

Achievements can grant unlockable titles.

"title": {
"id": "spider_slayer",
"color": "#FF5555"
}
FieldTypeDescription
idstringTitle identifier (for localization)
colorstringHex color code (default: #FFD700 gold)

Titles are displayed in chat and on the nameplate when the player chooses them in the Titles tab of the book (/kstitles).

Achievements can require other achievements to be completed first.

Single prerequisite:

{
"id": "spider_hunter_2",
"requires": "spider_hunter_1",
...
}

Multiple prerequisites:

{
"id": "master_hunter",
"requires": ["spider_hunter_5", "wolf_hunter_5", "bear_hunter_5"],
...
}

Achievements can form progression chains using the requires field:

spider_hunter_1 (1 kill)
↓
spider_hunter_2 (10 kills) - requires: spider_hunter_1
↓
spider_hunter_3 (50 kills) - requires: spider_hunter_2
↓
spider_hunter_4 (100 kills) - requires: spider_hunter_3
↓
spider_hunter_5 (500 kills) - requires: spider_hunter_4

The book shows a chain as one line with the current stage (“Stage 2 / 5”); the detail panel shows the whole stage path.

Set "hidden": true to hide an achievement until unlocked:

{
"id": "secret_easter_egg",
"hidden": true,
"category": "secret",
...
}

Hidden achievements display as ”???” without icon, progress, reward or title, and the search never finds them. Add an optional hint with the text key achievements.hint.<id> in localization/custom_<lang>.json.

Add custom notes to achievements:

"additionalInfo": {
"text": "Only available during the Summer Event!",
"color": "#FF9900"
}

This text appears in the book’s detail panel.

The standard file includes 277 achievements across 6 categories (plus 121 MMO Skill Tree and 34 RPG Leveling achievements in their own files):

CategoryCountDescription
Combat51Killing mobs, PvP, combat milestones
Progression104Mining, crafting, building, general progress
Exploration34Zone discovery, distance traveled, dungeons
Social22Chat messages, playtime hours
Husbandry29Animals, farming, fishing (special, see above)
Secret37Easter eggs, hidden challenges

Categories can be renamed, reordered and given icons in the admin window.

  • Kill 50 → 250 → 1,000 → 5,000 → 10,000 mobs
  • Mine 100 → 1,000 → 10,000 → 100,000 blocks
  • Play 1h → 5h → 10h → 25h → 50h → 100h → 250h → 500h → 1,000h
  • Walk 100 → 1,000 → 5,000 → 10,000 → 42,195 (marathon!) → 100,000 → 500,000 → 1,000,000 blocks