hytale-nameplates

To create dynamic NPC nameplates in Hytale modding, aggregate quality, affixes, base name, and level into a formatted display string using a RefChangeSystem. This ensures the Nameplate component updates correctly during NPC creation and modification.

RefChangeSystem and RefSystem differ in how they handle entity modifications for Hytale nameplates. A RefChangeSystem is required to safely compose and write Nameplate text after entity creation, ensuring accurate quality and level updates across mods.

You should use a CommandBuffer to update NPC nameplates when reading data after entity creation commits. This workflow ensures safe reads and updates when qualities, affixes, or levels change during NPC spawn or scaling.

Yes, you can combine quality and level into one NPC nameplate string in Hytale. The system composes Prefix affixes, Base name, Suffix affixes, Quality, and Level into a single formatted text written to the Nameplate component for client updates.

NPC nameplate updates may not show on the client in Hytale if the Nameplate text is not written to the Nameplate component correctly. Ensure your RefChangeSystem executes after the CommandBuffer commit to enforce safe visibility rules.

To integrate a DisplayNameComponent with the Hytale Nameplate component, use a RefChangeSystem to compose the formatted nameplate string and write it to the Nameplate component. This pattern supports practical updates during spawn, quality changes, or level scaling.