hytale-nameplates

What problem does it solve?

Documents how to set and modify entity nameplates in Hytale plugins. This guide explains the Nameplate component, system type selection (RefChangeSystem vs RefSystem), CommandBuffer visibility rules, and patterns for building rich NPC nameplates with quality, affixes, and level. It also covers common triggers and text formatting used to present clear, informative NPC names above heads.

Core Features & Use Cases

• Compose a complete nameplate by combining Quality, Prefix affixes, Base name, Suffix affixes, and Level into a single string.
• Clarifies how to interact with CommandBuffer and the two system types to ensure safe reads and updates during entity creation and modification.
• Provides practical patterns for NPC nameplate updates during spawn, quality changes, or level scaling, including integration with a separate DisplayNameComponent.

Quick Start

Configure a RefChangeSystem that composes the Nameplate text from quality, affixes, base name, and level, and writes it to the Nameplate component.