# Tracking System

# 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

| 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

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 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

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

<DocCardList />