?
Host a server
Modrinth App
Sign in
ModsPluginsData PacksShadersResource PacksModpacksServers
Settings
Nametags

Nametags

Nametags is a lightweight Minecraft plugin for Paper/Spigot 1.20.6+ designed to fully customize player displays.

12
0
12
0

Compatibility

Minecraft: Java Edition

26.2
26.1.x
1.21.x
1.20.6

Platforms

Tags

Creators

Details

Licensed ARR
Published 5 days ago

A robust and lightweight Minecraft plugin designed for Paper/Spigot 1.20.6+ (and newer) that lets you fully customize player nametags, chat formatting, tab lists, and health displays.

🌟 Overview

The plugin manages player prefixes, suffixes, nickname colors, and health subtitles across three areas:

  1. Above player heads (3D scoreboard team nametags).
  2. On the TAB list (player list).
  3. On the Chat (the default <PlayerName> Message format is replaced with Prefix Nickname Suffix: Message, and colors are prevented from bleeding into the message text).

🛠️ Key Features

  1. Gradients & RGB Hex Support (1.16+):

    • Fully supports legacy color codes (e.g., &a, &l, §c).
    • Supports custom Hex colors (e.g., &#FF5555).
    • Built-in multi-hex color interpolation for gradients (e.g., &#FF0000&#00FF00Admin smoothly transitions from red to green).

  2. Smart Formatting & Auto-Spacing:

    • Automatically adds a space after prefixes and before suffixes if missing, ensuring they never clash or stick to player names.

  3. Native Nickname Coloration (nickcolor):

    • Uses Minecraft's native team.color(...) scoreboard field to change player name colors above heads and in the TAB list.
    • Modifies chat name colors while cleanly resetting message colors afterwards to prevent color bleed.

  4. Health Display below Name (subtitle):

    • Enabled by default (shows <health> HP in red under player names in real-time).
    • Health scores update exactly 1 tick after damage or healing events for accuracy.
    • Simple per-player toggle using on/off options.

  5. LuckPerms Integration:

    • Allows manual synchronization of prefix/suffix values from LuckPerms groups.
    • Features a toggleable autosync scheduler that updates all online players' groups every 5 seconds.

  6. Persistent Data:

    • All player modifications (prefixes, suffixes, colors, and subtitle configurations) are stored in data.yml inside the plugin directory so they survive server restarts.

📋 Commands & Permissions

Modify commands require the nametags.use permission. Admin commands (reload/autosync) require nametags.admin (defaults to OP).

Command Description
/nametag <player> prefix <text> Changes the player's prefix and notifies them in chat.
/nametag <player> silentprefix <text> Changes the prefix silently (no message is sent to the target player).
/nametag <player> rgbprefix <hex/gradient> Set a gradient prefix (e.g. &#FF0000&#00FF00Owner).
/nametag <player> suffix <text> Changes the player's suffix and notifies them.
/nametag <player> silentsuffix <text> Changes the suffix silently.
/nametag <player> rgbsuffix <hex/gradient> Set a gradient suffix.
/nametag <player> nickcolor <color> Sets nickname color (Options: red, blue, green, gold, yellow, white, aqua, etc.).
/nametag <player> subtitle <on/off> Toggles the <health> HP display below the player's name.
/nametag <player> <category> reset Resets the selected category (prefix, suffix, or nickcolor).
/nametag <player> luckperms-sync Performs a one-time synchronization of prefix/suffix from LuckPerms.
/nametag luckperms-autosync Toggles the automatic 5-second LuckPerms synchronizer.
/nametag reload / /nametags reload Reloads the plugin configuration and applies updates to online players.

Full tab-completion support is included, suggesting online player names, subcommands, and English color names for the nickcolor command.