UnlimitedNameTags 2.0.0 - Major Update: Display Groups, Animations, Glow & Item/Block Nametags

UnlimitedNameTags 2.0.0

This is a major update from v1.x, introducing a redesigned nametag system, new display types, animations, glow effects, per-player preferences, configuration migration, and many internal improvements.

Before updating, make a backup of your plugins/UnlimitedNameTags folder and check the console after the first startup for migration messages or warnings.

Updated wiki: https://alexdev-s-organization.gitbook.io/unlimitednametags

Highlights

• Added the new displayGroups system for more flexible stacked nametags.
• Added support for TEXT, ITEM, and BLOCK display rows.
• Added per-line and per-group conditions using the new when format.
• Added configurable display animations such as rotate, bob, pulse scale, wiggle, orbit, and more.
• Added glow effects for supported displays, including fixed colors, rainbow effects, gradients, and presets.
• Added per-player nametag visibility preferences.
• Added through-wall visibility modes.
• Improved support for PlaceholderAPI, MiniPlaceholders, Nexo, Oraxen, ItemsAdder, and HMCCosmetics.
• Added automatic settings.yml migration with backups when possible.

Added

• New displayGroups configuration format.
• Text, item, and block nametag display types.
• Per-line text visibility conditions.
• Per-display-group scale, offset, background, billboard, animation, and visibility rules.
• New glow system with configurable presets.
• New /unt glow command tree.
• New /unt preferences command tree.
• New through-wall behavior options.
• Improved helmet and 3D cosmetic height compensation.
• Maven/API publishing structure for external integrations.
• New Paper API module for addons using Bukkit/Paper types.

Changed

• The old flat lines nametag format has been replaced by displayGroups.
• Old conditional modifiers have been replaced by the simpler when condition format.
• settings.yml now uses configVersion.
• Background, scale, and vertical offset are now configured per display group.
• Internal packet handling and nametag tracking were heavily refactored.
• The project was reorganized into multiple modules: common, api, api-paper, and paper.

Fixed

• Fixed incorrect vertical offsets with multi-line and multi-group nametags.
• Fixed ordering issues where display rows could appear in the wrong order.
• Fixed some through-wall visibility behavior.
• Fixed display animations not always updating correctly on clients.
• Improved /unt reload behavior.
• Improved YAML output by removing unnecessary/null values.
• Improved placeholder replacement handling for values such as Yes and No.
• Improved packet refresh behavior for smoother and more reliable nametag updates.

Updating From v1.x

• Back up your current plugin folder before updating.
• Start the server once and let the plugin migrate the configuration when possible.
• Review the new settings.yml.
• Move old custom nametag lines into displayGroups if needed.
• Replace old conditional modifiers with when.
• Check the console for warnings after startup.

Because this update includes many new features and a large internal refactor, some server setups may expose bugs or edge cases. Please report issues on Discord so they can be reviewed and fixed quickly.

UnlimitedNameTags 1.6.11 - Bug Fixes, improvements and 1.21.11 support

1.21.11 Support

• Added support for 1.21.11
• Fixed ghost nametag on death
• Improved API
• Removed MineDown formatter
• Fixed some problems

✨ Update Instructions
To update, simply drag and drop the new version into your plugins folder. No additional setup required!

UnlimitedNameTags 1.6.10 - 1.21.10 Support and Integrations

1.21.9/10 Support & Integrations

• Added support for 1.21.9/10
• Added support for HMCCosmetics hats via Nexo
• Fixed flickering issue with HMCCosmetics backpacks
• Added support for the LabyMod & FeatherClient nametag hider mod (requires labymod4-server-api / feather-server-api plugins)
• Performance improvements

✨ Update Instructions
To update, simply drag and drop the new version into your plugins folder. No additional setup required!

1.6.9

What's Changed

• Improve compatibility with custom deaths, fix PAPI error by @Leomelonseeds in #30
• Added support for Paper 1.21.6
• ConfigLib is now shaded
• The plugin won't crash if it can't load the resourcepack
• Fixed cache problem

New Contributors

• @Leomelonseeds made their first contribution in #30

Full Changelog: 1.6.8...1.6.9

1.6.8

Added initial support for ItemsAdder (It needs some testing) (Also added support for hat plugins like HMCCosmetics, etc)
Added support for LibsDisguises
Improved nexo support
Improved team handling (This improves compatibility with npc plugins like Citizens)
Improved performance, added caches and new config options to optimize the plugin
Fixed problems with join, death and teleport events

✨ Update Instructions
To update, simply drag and drop the new version into your plugins folder. No additional setup required!

UnlimitedNameTags 1.6.7 - Bug Fixes & Improvements

UnlimitedNameTags 1.6.7 - Changelog

Bug Fixes

• Spectator Joining Problem: Resolved issues preventing spectators from joining properly.
• Nametag Display Fixes: Addressed inconsistencies when using showCurrentNametag & showWhileLooking.
• Java Compatibility: Reverted back to Java 17. (Note: Java 17 support could be dropped in future updates.)
• Teleportation Fix: Fixed issues affecting nametag behavior during teleportation.

Nexo Integration

• Updated Nexo Support: Improved compatibility with Nexo’s resource pack.
• Hat Offset Feature: Now supports every hat model merged inside Nexo’s resource pack.

UnlimitedNameTags 1.6.6 - Introduces new features, fixes, and improvements!

UnlimitedNameTags 1.6.5 adds support for Placeholders Replacements, Nexo, and more.

• Added Elytra Compatibility: Resolved issues when using showCurrentNameTag with Elytra.
• Dynamic Resource Pack Updates: Nametags now refresh when players load a resource pack, fixing alignment issues with custom characters.
• Debug Mode: Added /unt debugger <true/false> to enable detailed troubleshooting logs.
• Reversible Animation Placeholders: You can now reverse animations in placeholders!
  • Examples:
    • Reversed: <gradient:#0000FF:#FF0000:#-phase-mm-g#>Hello, World!</gradient>
    • Normal: <gradient:#0000FF:#FF0000:#phase-mm-g#>Hello, World!</gradient>

Bug Fixes:

• Fixed gradient animations glitches.
• Added checks for fake players to prevent unwanted exceptions.
• Resolved PAPI and conditional system compatibility issues.
• Fixed floating nametags during teleportation and after death in Minecraft 1.20.1.

General Improvements:

• Optimized internal code for better performance and stability.

To update, just drag + drop the new version into your plugins folder!

UnlimitedNameTags 1.6.5 - Placeholders Replacements, Nexo supports and more

UnlimitedNameTags 1.6.5 adds support for Placeholders Replacements, Nexo and more

• Added Bedrock Support, I made a pull request that should be merged soon
• Added Placeholders Replacements
• Added Nexo support
• Added scale parameter to nametag, you increase or decrease nametag size
• Fixed problems with plugins like gsit, now the plugin should be more compatible with plugins that use passengers
• Fixed problem when changing world and using showCurrentNameTag
• Fixed problem with latest release of packet events

To update, just drag+drop.

Added support for PacketEvents 2.6.0 and 1.21.2/1.21.3

Added support for PacketEvents 2.6.0
Added support for 1.21.3