MysticNametags

MysticNameTags v1.1.3

Server Compatibility

• Target Server Version: >= 2026.1.0
• Tested against Hytale server builds 2026.1.x.
• Maintains backward-safe behavior within supported API range.

Major Additions

• Added Endless Race Display option:
  • endlessRaceDisplay in settings.json
  • When enabled, nameplates now format as:

    RaceId • Rank Name Tag - Lvl.X
    

  • Clean single-line formatting (avoids multiline renderer limitations).
• Improved Endless Leveling integration:
  • MysticNameTags now properly invalidates Endless label cache when /tags updates occur.
  • Fixes issue where level display could disappear until server restart.

Improvements

• Refined Endless Leveling nameplate formatting:

  • Consistent - Lvl.X suffix.
  • Bullet separator (•) for clean visual spacing.
  • Better layout balance with tags and prefixes.

• Improved integration synchronization:

  • Prevents system conflicts when tags are toggled.
  • Eliminates double-write flicker between systems.

• Optimized nameplate update logic:

  • Reduced unnecessary string building.
  • Cached comparison before component writes.
  • Cleaner separation of integration ownership.

Performance

• No additional background schedulers introduced.
• No new ticking loops.
• Nameplate updates only occur when:
  • Level changes
  • Race changes
  • Tag or prefix changes
  • Config toggles

Bug Fixes

• Fixed: Level display disappearing after /tags usage when Endless Leveling is enabled.
• Fixed: Cache desync between MysticNameTags and Endless Leveling.
• Fixed: Redundant nameplate component writes under rapid state changes.

Configuration

New option added:

endlessRaceDisplay = false

Existing relevant options:

nameplatesEnabled = true
defaultTagEnabled = false
defaultTagId = "mystic"
endlessLevelingNameplatesEnabled = false

All features remain optional and fully reload-safe. Changed endlessLevelingNameplatesEnabled to false as default.

Stability

• Stronger integration boundaries with Endless Leveling.
• Deterministic nameplate ownership model.
• Improved behavior across reloads, world transfers, and player reconnects.

MysticNameTags continues to prioritize:

Performance. Stability. Clean Integration.