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.
Trackers
Section titled “Trackers”| Tracker | What it tracks | Example use |
|---|---|---|
| BlockBreak | Blocks broken by players (mined/chopped/dug) | “Mine 50 Stone blocks” |
| BlockPlace | Blocks placed by players | ”Place 20 Wood blocks” |
| BlockHarvest | Plants and flowers picked (F-key) | “Pick 25 Flowers” |
| Kill | Entities killed by players | ”Kill 10 Trorks” |
| Damage | Damage dealt and taken | ”Deal 1000 total damage” |
| Distance | Distance traveled | ”Walk 5000 blocks” |
| Pickup | Items picked up interactively | ”Collect 30 Berries” |
| ZoneDiscovery | Zones discovered for the first time | ”Discover 5 new zones” |
| CraftRecipe | Items crafted at workbenches | ”Craft 10 Iron Swords” |
| ProcessingBench | Items produced at processing benches | ”Smelt 20 Gold Bars” |
| Playtime | Minutes spent online | ”Play for 60 minutes” |
How It Works
Section titled “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
Section titled “Configuration”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
Admin Commands
Section titled “Admin Commands”The tracking system is managed through the core admin command. There are no dedicated tracking commands — tracking is fully automatic when enabled.
| Command | Description |
|---|---|
/ksadmin reload | Reloads all mod configs, including tracking system settings |
Documentation
Section titled “Documentation”import DocCardList from ‘@theme/DocCardList’;