NNN Tracker (Client)
Shows your No Nut November challenge stats from a Minecraft server as an in-game HUD and as rotating Discord Rich Presence.
NNN Tracker is a small client-side companion mod for servers that run the NNN Tracker server mod. The server tracks every player's stats during the 30-day challenge and sends them to your game – this mod displays them in-game and on your Discord profile.
This mod only does something on servers running NNN Tracker (Server). On any other server or in singleplayer without the server mod, it stays inactive.
Features
Stats HUD
A compact overlay in the top-left corner showing:
- Current challenge day (e.g. NNN Tag 12/30) or the countdown to the start
- ☠ Deaths
- ⛏ Blocks mined · blocks placed
- ➜ Blocks walked
- ⚔ Mob kills · PvP kills
- ⏱ Total playtime and current session time
Toggle the HUD with N – rebindable under Options → Controls → NNN Tracker. It hides automatically when the F1/F3 screens are open.
Discord Rich Presence
Your Discord profile shows the current challenge day and rotates through one stat at a time (every 15 seconds by default):
NNN Tag 12/30
3 Tode → 1.234 Blöcke abgebaut → 5.678 Blöcke gelaufen → …
- Shows how long you have been playing in the current session
- Includes a "Stats ansehen" button linking to the server's stats website
- Clears automatically when you leave the server
Installation
- Install Minecraft Forge 1.21.1 (52.x)
- Put the mod into your
modsfolder - Join a server running NNN Tracker – the HUD and Discord status appear within ~30 seconds
Discord Rich Presence requires the Discord desktop app running on the same computer (Windows, macOS and Linux incl. Flatpak/Snap are supported).
Configuration
config/nnntracker-client.json is created on first start:
| Option | Default | Description |
|---|---|---|
discordRpc |
true |
Enable/disable Discord Rich Presence |
discordRotateSeconds |
15 |
Seconds between stat changes in Discord (min. 10) |
hudEnabled |
true |
Show the in-game HUD (also toggled with N) |
discordClientId |
– | Discord application ID (no need to change) |
largeImageKey |
nnn |
Image shown in the Discord status |
Privacy & network usage
- The mod does not connect to the internet and does not collect or send any data.
- It only receives stats from the Minecraft server you are connected to.
- For Rich Presence it talks to the Discord app on your own computer via Discord's local IPC interface – nothing else.
- All tracking (deaths, blocks, playtime …) is done by the server, not by this mod.
FAQ
My Discord status only shows my launcher (e.g. "Modrinth App"). Your launcher sets its own Rich Presence. Disable it (Modrinth App: Settings → Discord RPC) and make sure Discord → Settings → Activity Privacy → "Share your detected activities with others" is enabled.
The HUD doesn't show up.
The server must run NNN Tracker (Server). Stats arrive with the first sync, about 30 seconds after joining. Press N in case the HUD was turned off.
Can I use it on servers without NNN Tracker? Yes, it is harmless there – it simply stays inactive.
🔧 Compatibility
| Minecraft | 1.21.1 1.19.2 1.18.2 1.12.2 |
| Loader | Forge |
| Java | 21 |
| Side | Client only |
| Language | In-game texts and Discord status are in German |
No Nut November - GLHF
NNN Tracker Team
