TheHud

TheHud is built for survival servers, SMP communities, hubs and private networks that want a clean and unified player display.

Prefixes and suffixes follow players across the tab list, overhead nametags and chat. The server list MOTD and custom icon complete the presentation before a player even joins.

• Modern tab list — Configurable header, footer and player format.
• Live ping — Per-player latency with automatic green, yellow and red status colors.
• Live performance — TPS and MSPT placeholders with dynamic status colors.
• Permission groups — Prefixes, suffixes, weights and sorting controlled by permissions.
• Unified nametags — Matching overhead prefixes and suffixes using scoreboard teams.
• Chat formatting — The same group identity displayed directly in Paper chat.
• Live boss bar — Seven colors, five styles, live placeholders and dynamic progress modes.
• Server MOTD — Two configurable MiniMessage lines with live server information.
• Custom server icon — Built-in 64x64 branding, automatically installed.
• Rich placeholders — Player, ping, world, coordinates, health, experience, TPS, date and time.
• RGB formatting — Full MiniMessage colors, gradients and decorations.
• Separate configuration files — Clean files for general settings, MOTD and groups.
• Live reload — Apply configuration changes without restarting.
• No required dependencies

Each player is resolved to the first matching group in groups.yml. Lower weights appear first in the player list.

The selected prefix and suffix are reused across all enabled display surfaces, keeping ranks visually consistent everywhere.


The boss bar has its own bossbar.yml file and updates live with the same player and server placeholders used by the tab list.

Available styles
Available colors
Progress modes

• STATIC — Uses a configured value from 0.0 to 1.0.
• HEALTH — Tracks the player's current health.
• TPS — Displays current server tick performance.
• PING — Decreases as player latency approaches the configured maximum.

Special display placeholders include <prefix>, <suffix> and <message> where supported.

• config.yml — General settings, tab list, nametags and chat.
• motd.yml — Server list MOTD, displayed capacity and custom icon.
• groups.yml — Group permissions, weights, prefixes and suffixes.
• bossbar.yml — Boss bar title, color, style and progress behavior.

All player-facing formatting uses MiniMessage. The public default server name is Your Server, ready to replace with your own branding.

• /thehud reload — Reloads all four configuration files.
• /thehud refresh — Immediately refreshes every online player.
• /thehud status — Shows the installed version and active status.
• /thehud placeholders — Lists every built-in placeholder.

Create additional groups directly in groups.yml and assign their permissions with LuckPerms or any Bukkit-compatible permission manager.

• Server software: Paper 1.21.x
• Tested version: Paper 1.21.8
• Java: 21 or newer
• LuckPerms: Optional and compatible through permissions
• PlaceholderAPI: Not required

Avoid enabling another plugin's scoreboard-team or chat formatter for the same feature, because both plugins would compete for the final display.

1. Download TheHud-1.1.0.jar.
2. Place the file inside the server's /plugins folder.
3. Restart the server.
4. Confirm that TheHud appears in green in /plugins.
5. Edit the generated files inside plugins/TheHud.
6. Run /thehud reload after configuration changes.

When requesting help, include your Paper version, Java version, TheHud version and any relevant console error. Never post private server credentials.