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 <offset> ==== 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

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