How to Make a Stat Tracker

A stat tracker is a craftable item that, once dropped onto a tool, weapon, or armor piece, counts a stat on it and shows the running total in the item's lore. Each tracker is one config file built from a display, a set of counters, and a tracker item. This page takes you from an empty file to a working, craftable tracker.

Quick start

1. Open /plugins/StatTrackers/stats/ and copy _example.yml to a new file, e.g. nether_ores_mined.yml. The file name is the tracker's ID.

2. Set display to the lore line you want, using %value% where the count should appear.

3. List the items the tracker can attach to under applicable-to.

4. Add one or more counters to define what gets counted.

5. Fill in the tracker block: the item, name, lore, and (optionally) a crafting recipe.

6. Run /stattrackers reload, then run /stattrackers give <player> nether_ores_mined, drop the tracker onto a matching item, and check the lore updates as you play.

Naming and IDs

The file name without .yml is the tracker's ID. That ID is what you pass to commands and use in the Item Lookup System.

The structure of a tracker

A tracker config has three parts:

Here is a complete tracker with every part in place:

# === Display: what the player sees ===
display: "&bNether Ores Mined: %value%" # Lore line on the item; %value% is the running count
applicable-to: # Item groups this tracker can attach to, defined in targets.yml
  - sword
  - bow
  - trident
  - axe

# === Counters: what gets counted ===
counters:
  - trigger: mine_block # The event that adds to the count
    value: 1 # Add a flat 1 per trigger; use 'multiplier' instead to scale the trigger's own value
    filters:
      blocks: # Only count these blocks
        - nether_gold_ore
        - ancient_debris
        - nether_quartz_ore
    conditions:
      - id: in_world # Only count while this condition holds
        args:
          world: world_nether

# === Tracker item: the physical item ===
tracker:
  item: compass max_stack_size:1 # The base item; see the Item Lookup System for options
  name: "&eTracker - Nether Ores Mined" # Display name of the tracker item
  lore:
    - "&8Drop this onto an item with /stattrackers"
    - "&8to display the nether ores mined"
  craftable: true # Whether the tracker can be crafted
  recipe-permission: stattrackers.craft.nether_ores_mined # Optional; permission needed to craft it
  shapeless: false # Optional; whether the recipe is shapeless, default false
  recipe: # The crafting grid, read top-left to bottom-right
    - iron_sword
    - iron_sword
    - iron_sword
    - iron_sword
    - compass
    - iron_sword
    - iron_sword
    - iron_sword
    - iron_sword

Display

The display line is the lore added to the item, and applicable-to controls which items the tracker can attach to.

display: "&bNether Ores Mined: %value%" # %value% is replaced with the current count
applicable-to: # Item groups defined in targets.yml (sword, bow, armor, pickaxe, etc.)
  - sword
  - bow
  - trident
  - axe

Counters

A counter defines what stat is tracked: a trigger fires on an event, then value (a flat amount) or multiplier (a scale on the trigger's own value) decides how much to add. Optional filters and conditions narrow when it counts.

counters:
  - trigger: mine_block # Event that fires the counter
    value: 1 # Flat amount added per trigger; swap for 'multiplier' to scale the trigger's value
    filters:
      blocks: # Restrict to specific blocks
        - nether_gold_ore
        - ancient_debris
    conditions:
      - id: in_world # Only count while the condition is met
        args:
          world: world_nether

Tracker item

The tracker block defines the physical item players drop onto their gear, plus its optional crafting recipe.

tracker:
  item: compass max_stack_size:1 # Base item; see the Item Lookup System for options
  name: "&eTracker - Nether Ores Mined" # Display name
  lore:
    - "&8Drop this onto an item with /stattrackers"
    - "&8to display the nether ores mined"
  craftable: true # Whether it can be crafted
  recipe-permission: stattrackers.craft.nether_ores_mined # Optional; permission to craft
  shapeless: false # Optional; whether the recipe is shapeless, default false
  recipe: # Crafting grid, read top-left to bottom-right
    - iron_sword
    - iron_sword
    - iron_sword
    - iron_sword
    - compass
    - iron_sword
    - iron_sword
    - iron_sword
    - iron_sword

Internal placeholders

These placeholders are available inside this config:

Where to go next

• Default trackers: the shipped configs live here and make good starting points.

• Community configs: browse user-made trackers on lrcdb.

• Triggers and conditions: Configuring an Effect covers the full counter system.