Skip to content

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

Latest
Latest

Choose a tag to compare

View all tags
@alexdev03 alexdev03 released this 06 Jun 13:44
· 8 commits to main since this release
2.0.0
9f47c34

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.

Assets 2
Loading