Tracking System
Mod:
kyuubisoft-core.jar| Used by: Quest System + Achievement System
The Tracking System provides 7 built-in trackers that monitor player activities across the server. Both the Quest System and Achievement System use these trackers as triggers for objectives and achievement conditions.
Trackers
| Tracker | What it tracks | Example use |
|---|---|---|
| BlockBreak | Blocks broken by players | "Mine 50 Stone blocks" |
| BlockPlace | Blocks placed by players | "Place 20 Wood blocks" |
| Kill | Entities killed by players | "Kill 10 Trorks" |
| Damage | Damage dealt by players | "Deal 1000 total damage" |
| Distance | Distance traveled | "Walk 5000 blocks" |
| Pickup | Items picked up | "Collect 30 Berries" |
| ZoneDiscovery | Zones/areas discovered | "Discover 5 new zones" |
How It Works
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).
Configuration
Trackers are automatically active when the Quest or Achievement mod is installed. 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
Admin Commands
| Command | Description |
|---|---|
/ksadmin tracking | View tracking statistics |
/ksadmin tracking reset <player> | Reset a player's tracking data |
Documentation
📄️ Configuration
Tracker settings and category mappings