DonutSMP Shard Displayer

Shard Displayer

Displays DonutSMP player shard counts above their heads in real time, fetched from donutstats.net.
Fully client-side Fabric mod with customizable label appearance.

🎯 Features

Automatic shard parsing from donutstats.net for all visible players

In-game label above players showing ✦ 12.5K (auto‑formatted with K, M, B, T suffixes)

Fully customizable display:

1. Text color and scale
2. Vertical offset above the player
3. Background toggle
4. Show/hide your own shards
5. Debug mode – shows loading states (loading, err, waiting) to troubleshoot issues
6. Smart caching: fast updates (every 15s) while active, relaxed (every 3min) in the background
7. No API keys required – all data is taken from the public stats page

📋 Commands

All commands start with /shardslabel (tab completion works).

Command Description

/shardslabel on / off ==== Enable / disable shard labels

/shardslabel toggle ==== Toggle visibility

/shardslabel self on / off ==== Show / hide your own shard count

/shardslabel background on / off ==== Enable / disable background behind the label

/shardslabel scale <30..200> ==== Set text size in percent (default 70)

/shardslabel y ==== Vertical offset (range -100 to 100, default 25)

/shardslabel color <#RRGGBB> ==== Text color in HEX, e.g. #FFAA00

/shardslabel debug on / off ==== Enable debug mode

/shardslabel clearcache ==== Clear the stats cache

/shardslabel reload ==== Reload config from file

⚙️ Configuration

Settings are stored in config/shards.properties and created automatically on first launch.

📦 Installation

Install Fabric Loader for Minecraft 1.21.10 / 1.21.11

Download Fabric API and place it in your mods folder

Download the latest Shard Displayer jar and put it in mods as well