LiveMetrics is a Minecraft datapack purpose-built for streamers, community servers, and admins who want rich, human-friendly telemetry without external mods. It focuses on live storytelling: dramatic death streaks, kill milestones, AFK tracking, location insight, and configurable HUD surfaces that keep chat engaged.
- Deaths & Survival: ✅ lifetime deaths, cause breakdown, streaks, deathless timer, last death location.
- Combat Pulse: ✅ mob/player/boss kills, K/D, kill streaks, boss kill counters, PvP tracking.
- Location & Movement: ✅ live coordinates, distance from spawn, total distance traveled, light levels, AFK detection.
- Time & Session: ✅ playtime, session timers, AFK detection with configurable thresholds.
- Resources & Economy: (planned) items picked up/crafted/used, rare loot counters, villager trades.
- Presentation: ✅ sidebar, boss bar, action bar, chat cues, preset configurations (Survival, Hardcore, Speedrun, Admin).
- Configuration: ✅ toggleable stat groups, reset tools, team-aware aggregation, admin controls.
See CHANGELOG.md for release-by-release notes.
- Install: Copy the
LiveMetricsfolder into your world’sdatapacks/directory (Java Edition 1.21.x), then run/reload. - Verify: The datapack will initialize the required scoreboard objectives and announce readiness in chat.
- Use: Default tracking begins immediately. Display surfaces (sidebar, boss bar, etc.) are configurable through functions that will ship with each release.
Server tip: Pair the datapack with a log parser or streaming overlay to echo the stats to OBS via
/datacommands or webhooks.
| Command | Purpose |
|---|---|
/function livemetrics:setup/init |
Forces a full re-initialization (scoreboards, storage flags, constants). |
/function livemetrics:tick/main |
Runs the per-tick tracker loop (automatically scheduled via minecraft:tick). |
/function livemetrics:preset/survival |
Activates Survival preset (sidebar shows death streak). |
/function livemetrics:preset/hardcore |
Activates Hardcore preset (sidebar shows deathless streak, boss bar shows kill streak). |
/function livemetrics:preset/speedrun |
Activates Speedrun preset (sidebar shows session time, boss bar shows session progress). |
/function livemetrics:preset/admin |
Activates Admin preset (sidebar shows AFK status, monitoring tools). |
/function livemetrics:admin/reset_all |
ADMIN ONLY: Resets all LiveMetrics data for all players. |
/scoreboard objectives setdisplay sidebar <objective> |
Choose which LiveMetrics stat is broadcast in the sidebar at runtime. |
pack.mcmeta
data/
├── livemetrics/
│ ├── functions/
│ │ ├── load.mcfunction # Datapack entry point
│ │ ├── setup/
│ │ │ ├── init.mcfunction # Scoreboards, storage flags, constants
│ │ │ └── bossbars.mcfunction # Boss bar initialization
│ │ ├── tick/
│ │ │ ├── main.mcfunction # Core loop (session time, distance, sanity checks)
│ │ │ └── player.mcfunction # Per-player updates and event detection
│ │ ├── events/ # Event handlers (death, kill_total, kill_pvp, kill_boss)
│ │ ├── alerts/ # Chat milestone notifications
│ │ ├── preset/ # Display preset configurations
│ │ ├── display/ # Live display surfaces (actionbar)
│ │ └── admin/ # Administrative functions
│ └── (future: predicates, advancements, loot tables)
└── minecraft/tags/functions/
├── load.json
└── tick.json
Data flows from vanilla statistics (e.g., minecraft.custom:minecraft.walk_one_cm) into custom dummy scoreboards, which are then post-processed for displays and automation hooks.
- Changelog:
CHANGELOG.md - Issues/Ideas: Use GitHub issues (coming soon) or open a discussion thread with feature requests and streamer-specific needs.
Pull requests are welcome once the MVP spec lands. Please follow the Apache 2.0 license and keep contributions aligned with the roadmap pillars above.
Licensed under the Apache License 2.0. LiveMetrics is built by M1tsumi (quefep) for the WormWoodMC community.