THE MOD IS NOW REQUIRED ON CLIENT SIDE!

[1.2.2] - 2026-02-02

Added

• Client-Side Nametag Hiding: New optional feature to hide player nametags above heads:

  • Implemented via NeoForge's RenderNameTagEvent for clean client-side rendering control.
  • Completely client-side solution using packet synchronization from server.
  • Configuration synced when players join via custom HideNametagsPacket.
  • No scoreboard teams involved - purely visual hiding on client.
  • Controlled by server config option hideNametags (default: false).
  • Command: /oneria config set hideNametags true/false (was already here, just ported to the new system)

• Nametag Nickname Display: Nicknames now visible above player heads:

  • Optional prefix/suffix display from LuckPerms.
  • Configurable via showNametagPrefixSuffix option.
  • Command: /oneria config set showNametagPrefixSuffix true/false
  • Full color code support for nicknames in nametags.

• Platform Management Command: New /setplatform command for easier platform creation:

  • Syntax: /setplatform <name> <dimension> <x> <y> <z>
  • Requires OP level 2.
  • Automatically creates or updates platform entries.
  • Simplifies platform configuration without manual config editing.

Fixed

• LuckPerms Solo Crash: Fixed crash when playing in singleplayer or on servers without LuckPerms:

  • Added NoClassDefFoundError catching in getPlayerPrefix() and getPlayerSuffix().
  • Mod now gracefully handles LuckPerms absence with debug logging instead of crashes.
  • All LuckPerms-dependent features safely skip when mod is not present.
  • Enhanced error handling in OneriaServerUtilities for better stability.

• Performance Issues: Fixed severe FPS drops caused by tick loop:

  • Added server-side check to prevent client-side tick execution.
  • TabList update system now only runs on dedicated servers.
  • Eliminated unnecessary packet broadcasts on client.
  • Massive performance improvement in single-player and multiplayer.

Technical

• New Classes:

  • ClientNametagRenderer - Client-side event handler for nametag visibility control.
  • HideNametagsPacket - Custom packet for synchronizing nametag config from server to client.
  • ClientNametagConfig - Client-side config storage with server state tracking.
  • ClientEventHandler - Handles client disconnect events and config reset.
  • NetworkHandler - Packet registration and handling for client-server communication.

• Enhanced Classes:

  • OneriaEventHandler - Now sends nametag configuration packet to clients on login.
  • OneriaServerUtilities - Enhanced LuckPerms error handling with NoClassDefFoundError catching, added server-side tick protection.
  • OneriaConfig - Added HIDE_NAMETAGS and SHOW_NAMETAG_PREFIX_SUFFIX configuration options.
  • OneriaCommands - Added /setplatform command and nametag configuration commands.
  • MixinEntity - Enhanced to display nicknames with optional prefix/suffix above heads.

• Network Protocol:

  • Custom packet payload type: oneriaserverutilities:hide_nametags.
  • Boolean payload for nametag visibility state.
  • Sent to players on login with current server configuration.
  • Client automatically resets state on disconnect.

Configuration

• New Options:
  • hideNametags (Boolean) - Hide all player nametags above heads (default: false).
  • showNametagPrefixSuffix (Boolean) - Show LuckPerms prefix/suffix with nicknames in nametags (default: false).
  • Both located in [Obfuscation Settings] section.
  • Both can be toggled via /oneria config set <option> true/false.

Migration Notes

• No breaking changes - fully backward compatible with 1.2.1.
• New nametag hiding feature is disabled by default.
• Existing configurations continue to work without modification.
• Feature can be enabled by setting hideNametags = true in server config.

Known Behavior

• Nametag hiding only affects player entities (not mobs or other entities).
• Client must receive configuration packet from server before feature activates.
• Configuration automatically syncs on player join/rejoin.
• Disconnect automatically clears client-side config state.
• Nicknames in nametags support full color codes (§ and &).