Nametags 1.1

What's new

Folia support

• Nametags now runs on Folia as well as Paper (1.20.6+).
• PacketEvents is required on Folia. Folia has no scoreboard API, so teams are sent as packets. Without PacketEvents the plugin disables itself and prints a message.
• Paper does not need PacketEvents.

Hex & gradient nick colors

/nametag <player> nickcolor now accepts much more than the 16 vanilla colors:

• Named colors (still supported): red, dark_aqua, ...
• Single hex: #FF5555, &#FF5555
• Gradients with any number of colors: #FF0000 #0000FF, #FF0000 #00FF00 #0000FF
• Also accepts &#FF0000&#0000FF, #FF0000-#0000FF and <gradient:#FF0000:#0000FF>
• Birdflop support: paste the output from RGB Birdflop directly (&#rrggbb, &x&r&r&g&g&b&b and <#rrggbb> formats). Its colors are applied as a gradient to the player's name.

New /nametag <player> nick <text> command

• Replaces a player's displayed name with any custom text, colors included.
• Paste a Birdflop gradient and the name shows exactly as generated.
• A nick without color codes uses the player's nickcolor.
• Reset with /nametag <player> nick reset.
• Max 32 visible characters.

New nametag rendering

Vanilla nametags only support the 16 team colors, so name tags above heads are now rendered with TextDisplay entities:

• Full hex and gradient support for prefix, name and suffix
• Behaves like vanilla:
  • hidden for dead, invisible and spectating players
  • dimmed and not visible through walls while sneaking
• Hidden from players who can't see the target (vanish plugins)
• Works across teleports and world changes
• Always fully bright, even at night or in caves

Tab list & chat

• The tab list now shows prefix + colored name + suffix (gradients included).
• Chat shows the gradient nick and custom nick.

Changes

• The HP subtitle (/nametag <player> subtitle on/off) is now part of the nametag display instead of the vanilla below-name scoreboard. Each player still chooses whether they see HP.
• The team color is set to the closest vanilla color of the nick color (used e.g. for the glowing outline).
• Scheduling now uses the Paper/Folia region schedulers.
• Player data access is thread-safe.

Fixes

• Hex colors in rgbprefix / rgbsuffix are no longer downgraded to the nearest vanilla color in chat.

Notes

• Like vanilla, you don't see your own nametag. Client mods with a "show own nametag" option (Lunar, Feather, ...) show the vanilla tag with team colors only. Other players see the full gradient.
• Folia: if a vanish plugin hides a player after their nametag was shown, the tag disappears for the other player only after the display is respawned (death, world change or a subtitle toggle).
• Requires Paper or Folia 1.20.6+. PacketEvents 2.9.5+ on Folia.