<h1 align="center">📊 nixStats</h1> <h3 align="center">Your stats, your screen — a fully configurable sidebar HUD for anything Minecraft counts.</h3> <p align="center"><img src="https://img.shields.io/badge/Fabric-DBA463?style=for-the-badge&amp;logoColor=white" alt="Fabric"> <img src="https://img.shields.io/badge/NeoForge-F16436?style=for-the-badge&amp;logoColor=white" alt="NeoForge"></p> <p align="center"><a href="https://www.curseforge.com/minecraft/mc-mods/nixstats-multi"><img src="https://img.shields.io/badge/Download_on-CurseForge-F16436?style=for-the-badge&amp;logo=curseforge&amp;logoColor=white" alt="Download on CurseForge"></a> <a href="https://discord.gg/J9QnJWDFB3"><img src="https://img.shields.io/badge/Join_the-Discord-5865F2?style=for-the-badge&amp;logo=discord&amp;logoColor=white" alt="Discord"></a> <a href="https://github.com/LunixiaLIVE/nixStats"><img src="https://img.shields.io/badge/Source-GitHub-181717?style=for-the-badge&amp;logo=github&amp;logoColor=white" alt="GitHub"></a></p> <p align="center"><img src="https://img.shields.io/badge/Minecraft-26.x_%26_1.21.x-62B47A?style=flat-square" alt="Minecraft 26.x & 1.21.x"> <img src="https://img.shields.io/badge/Side-Client--side-8E44AD?style=flat-square" alt="Client-side"> <img src="https://img.shields.io/badge/Fabric_API-required_on_Fabric-4A90D9?style=flat-square" alt="Fabric API required on Fabric"> <img src="https://img.shields.io/badge/License-MIT-blue?style=flat-square" alt="MIT License"></p> --- **nixStats** puts a clean, compact stats sidebar on your screen and lets you fill it with whatever you actually care about — the phantom (insomnia) timer, blocks mined, mobs killed, distance walked, play time, and hundreds of other vanilla statistics. Every bit of it is set up in-game from a config screen with a **live preview** — no config-file editing, no IDs to memorize, no external overlay tools. ## ✨ Features - 📊 **A clean sidebar HUD** — a bordered, titled panel with a per-row item icon, a label, and a right-aligned value. Rows alternate shading and columns auto-size to their content. - 🌙 **Live phantom (insomnia) timer** — counts *down* to when phantoms can spawn and shifts color from **rested → warning → critical** as the clock runs out. One glance tells you whether it's time to sleep. Sleeping resets it. - 🏆 **Advancement tracking** *(26.x)* — a **grand total** across every namespace, **per-namespace totals** (vanilla, a datapack, or a mod — each on its own), or **individual advancements** with live `X/Y` criteria progress and a ✓ when complete. Datapack & modded advancements appear automatically. - 🧮 **Track almost any vanilla stat** — blocks mined, items used / crafted / broken / picked up / dropped, mobs killed, deaths *by* a mob, plus the whole General family: counts, distances, and time stats. - 🖱️ **Add stats from a visual picker** — browse categories with a searchable 9-wide item grid (with tooltips) or a scrolling list for General stats, then click to add. No IDs required. - 🏷️ **Name display, three ways** — a single button cycles **Show Names** (full label, *Stone Mined*), **Show Abbrev** (the action alone, *Mined*) and **Show None** (no label at all — just the icon and the number). The caption always reads the mode in effect. General stats, advancements and the phantom timer keep their full label in every mode, since their icon alone wouldn't identify them. - 🔢 **Abbreviate large values** — an optional `Values: Short` toggle shortens big counts to `1.5K` / `2.3M` / `1.1B` and narrows the value column to match. Off by default. Distances, times, the phantom clock and advancement progress keep their own format. - 🎚️ **Full in-game configuration** — title, HUD scale, text scale, column padding, sync interval, the three phantom colors, warning/critical thresholds, and the stat list itself — all beside a live preview. - 📍 **Drag-to-place positioning** — a dedicated "Set Position" mode lets you drag the frame anywhere; one click resets it to the default top-right corner. - ⌨️ **Open it your way** — a rebindable keybind *(unbound by default)* **or** just `/nixstats`, plus a separate **Show / Hide HUD** keybind that toggles the whole sidebar. - 🌐 **Multiplayer-aware** — periodically refreshes your stats from the server so counts stay live, and reads straight from the integrated server in single-player for tick-accurate values. - 🧩 **Fully client-side** — install on your client and it works on any server, vanilla or modded. Modded blocks, items, mobs, and stats appear in the picker automatically because everything is read from the live registry. ## 📋 What you can track The **+ Add Stat** picker groups everything into browsable categories: | Category | What it lists | |:--|:--| | **Phantom Timer** | The built-in insomnia countdown (one click adds it). | | **General: Counts** | Count-type stats (jumps, damage dealt, …). | | **General: Distances** | Distance stats (walked, sprinted, flown, swum, …). | | **General: Time*