TheHud

TheHud is a lightweight, all-in-one visual identity plugin for Spigot and Paper servers. It keeps your tab list, nametags, chat prefixes, boss bar and server-list presentation consistent from the moment a player sees your server until they join.

Version 1.2.0 introduces a rebuilt cross-version engine designed to run from Minecraft 1.8 through 1.21.x using a single JAR.

• One universal JAR — No separate legacy and modern downloads.
• Java compatibility — Java 8 bytecode runs on Java 8, 11, 16, 17 and 21.
• Automatic server adaptation — Legacy-safe APIs with modern features detected at runtime.
• RGB and gradients — Preserved on Minecraft 1.16+ and converted safely on older versions.
• Boss bar compatibility — Native on Minecraft 1.9+; disabled safely on 1.8.
• Server icon system — Bundled 64x64 icon plus a replaceable external server-icon.png.
• Verified compatibility — Isolated testing completed on Paper 1.16.5 with Java 8, plus modern Paper testing.

• Configurable tab list — Header, footer and player format.
• Live ping — Per-player latency with automatic status colors.
• TPS and MSPT — Live server-performance placeholders.
• Permission groups — Prefixes, suffixes, weights and sorting.
• Unified nametags — Matching overhead prefixes using scoreboard teams.
• Chat formatting — Reuses the same rank identity in chat.
• Dynamic boss bar — Seven colors, five styles and four progress modes.
• Server MOTD — Two configurable lines with live placeholders.
• Custom server icon — Replace plugins/TheHud/server-icon.png and run /thehud reload.
• No required dependencies

Styles
Colors
Progress modes: STATIC, HEALTH, TPS and PING.

Special display placeholders include , and where supported.

• Code (Text):

  config.yml
  — General settings, tab list, nametags and chat.
• Code (Text):

  motd.yml
  — Server-list MOTD, capacity and icon.
• Code (Text):

  groups.yml
  — Permissions, weights, prefixes and suffixes.
• Code (Text):

  bossbar.yml
  — Title, color, style and progress.

• Minecraft: Designed for Spigot/Paper 1.8–1.21.x.
• Java: Java 8, 11, 16, 17 and 21.
• RGB: Native on 1.16+; classic-color fallback on legacy versions.
• Boss bars: Native on 1.9+; safely disabled on 1.8.
• LuckPerms: Optional through standard Bukkit permissions.
• PlaceholderAPI: Not required.

Avoid enabling another scoreboard-team or chat formatter for the same feature, as both plugins may compete for the final display.

1. Download TheHud-1.2.0.jar.
2. Place it inside your server's plugins folder.
3. Restart the server.
4. Edit the generated files in plugins/TheHud.
5. Run /thehud reload after configuration changes.

Created by TheMurft • Version 1.2.0