Tracking System

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 (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/areas discovered	”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

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

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

import DocCardList from ‘@theme/DocCardList’;