Skip to content

Tracking System

Mod: kyuubisoft-core.jar | Used by: Quest System, Achievement System and Season Pass

The Tracking System provides built-in trackers that monitor player activities across the server. The Quest System, the Achievement System and the Season Pass use them as triggers for objectives, achievement conditions and challenges.

TrackerWhat it tracksExample use
BlockBreakBlocks broken by players (mined/chopped/dug)“Mine 50 Stone blocks”
BlockPlaceBlocks placed by players”Place 20 Wood blocks”
BlockHarvestPlants and flowers picked (F-key)“Pick 25 Flowers”
KillEntities killed by players”Kill 10 Trorks”
DamageDamage dealt and taken”Deal 1000 total damage”
DistanceDistance traveled”Walk 5000 blocks”
PickupItems picked up interactively”Collect 30 Berries”
ZoneDiscoveryZones discovered for the first time”Discover 5 new zones”
CraftRecipeItems crafted at workbenches”Craft 10 Iron Swords”
ProcessingBenchItems produced at processing benches”Smelt 20 Gold Bars”
PlaytimeMinutes spent online”Play for 60 minutes”

Trackers run as ECS (Entity Component System) systems that observe game events. When a tracked event occurs, the tracker updates the player’s statistics and notifies any registered listeners (quests, achievements).

Trackers run while Core’s tracking module is on (modules.tracking in mods/kyuubisoft_core/config.json, default true) and feed every installed mod that listens (Quests, Achievements, Season Pass). Some trackers have additional configuration:

  • BlockBreak/BlockPlace — Category mappings (e.g., “Stone” category includes all stone variants)
  • Kill — Entity type mappings
  • Pickup — Item type filters

The tracking system is managed through the core admin command. There are no dedicated tracking commands — tracking is fully automatic when enabled.

CommandDescription
/ksadmin reloadReloads all mod configs, including tracking system settings

import DocCardList from ‘@theme/DocCardList’;