CurseForge · Minecraft mod
JSON HUD
A simple mod that allows modifying the player's HUD using JSON files.
Quick answer
Which JSON HUD release should I use?
JSON HUD jsonhud-3.0.0.jar targets 1.20.1 with Forge. The project page does not say whether this file belongs on the client, dedicated server, or both. No extra mods listed for this file.
Where it goes
Is JSON HUD required on the client, server, or both?
The project page does not say whether this file belongs on the client, dedicated server, or both.
The source does not explicitly classify this release as client-only or server-only.
What else does JSON HUD jsonhud-3.0.0.jar need?
jsonhud-3.0.0.jar. Change the file and its required mods may change too.
This file does not list any required mods. Do not add a library just because a different file uses it.
This file does not list any required or optional mods.
Before you install it
Add JSON HUD without breaking your instance.
Built for JSON HUD jsonhud-3.0.0.jar. Pick another file and the loader, install side or required mods may change.
- 01
Stick to this file
Use jsonhud-3.0.0.jar. It targets 1.20.1 with Forge; another release may have different loader, side or dependency requirements.
- 02
Bring the mods it needs
This file does not list any required mods. Do not add a library just because a different file uses it.
- 03
Put it on the correct side
The project page does not say whether this file belongs on the client, dedicated server, or both.
- 04
Pick the file you checked
Use the “Get this file” button beside jsonhud-3.0.0.jar. It opens that exact file at the source.
About this project
What does JSON HUD add?
A Minecraft mod that allows you to add text to the player interface using JSON files.
This mod is currently in beta; please report any bugs.
The json file is in .minecraft/config/hud.json
The more lines you add, the higher the likelihood of an FPS drop.
Wiki under construction.
Currently available placeholders:
$player_name$
$player_world$
$player_health$ $player_xp$
$player_level$
$player_food$
$pos_x$
$pos_y$
$pos_z$
$score_<scoreboard_name>$
Updated how colors are rendered, adding more variety by using & prefixes.
For example:
Food: &c$player_food$
Added new item symbols using $item:<item>$.
Example:
$item:golden_apple$ Health: $player_health$

The scoreboard must be displayed somewhere for the client to receive it; example command:
/scoreboard objectives setdisplay (belowname, sidebar, list, sidebar.team_aqua, etc.) <scoreboard>
Example:

"Example": {
"lines": [
"Player: $player_name$",
"Health: $player_health$",
"Food: $player_food$"
],
"color": "yellow / white / red / black / gray / orange / green / blue / purple / pink",
"position": "top-left / top-right / left / right / bottom-left / bottom-right / bottom / top",
"visibility": "visible / hidden",
"shadow": true / false
}
When Shadow = true
When Shadow = false

Project description from CurseForge.
Pick your setup
JSON HUD by Minecraft version and loader
Choose the version and loader you play, then open the matching release.
Check the dependencies, then try the file in a copied instance before changing a world you care about.
Recent files
JSON HUD versions and loaders
jsonhud-3.0.0.jar
15 Nov 2026
jsonhud-2.0.0.jar
12 Aug 2026
jsonhud-beta-1.4.0.jar
8 Jul 2026
Looking for an older file? The official CurseForge project page is in Resources.