Skip to main content
NameplateBuilder persists all player settings and admin configuration to disk so they survive server restarts.

​
Player Preferences

File: preferences.txt One line per record, pipe-delimited. Each line starts with a single-character prefix indicating the record type.
PrefixFormatDescription
NN|uuid|pluginId:segmentId,...NPC segment chain order
PP|uuid|pluginId:segmentId,...Player segment chain order
EE|uuid|true/falseMaster enable toggle
LL|uuid|true/falseLook-at (view-cone) toggle
OO|uuid|0.5Vertical offset value
SS|uuid|pluginId:segmentId|separatorPer-block separator
VV|uuid|pluginId:segmentId|variantIndexSelected format variant
XX|uuid|pluginId:segmentId|prefixPrefix text
UU|uuid|pluginId:segmentId|suffixSuffix text
BB|uuid|pluginId:segmentId|charBar empty-fill character
WW|uuid|true/falseWelcome message toggle

​
Example

N|550e8400-e29b-41d4-a716-446655440000|EliteMobs:health,EliteMobs:tier
P|550e8400-e29b-41d4-a716-446655440000|NameplateBuilder:player_name,MyMod:guild
E|550e8400-e29b-41d4-a716-446655440000|true
L|550e8400-e29b-41d4-a716-446655440000|false
O|550e8400-e29b-41d4-a716-446655440000|0.5
S|550e8400-e29b-41d4-a716-446655440000|EliteMobs:health| -
V|550e8400-e29b-41d4-a716-446655440000|EliteMobs:health|2
X|550e8400-e29b-41d4-a716-446655440000|EliteMobs:health|HP: [
U|550e8400-e29b-41d4-a716-446655440000|EliteMobs:health|]
B|550e8400-e29b-41d4-a716-446655440000|EliteMobs:health|.
W|550e8400-e29b-41d4-a716-446655440000|true

​
Admin Configuration

File: admin_config.txt
PrefixFormatDescription
SS|serverNameServer display name for welcome message
RR|pluginId|segmentIdRequired segment
DD|pluginId|segmentIdDisabled segment
Lines starting with # are comments. Blank lines are ignored.

​
Example

# Server display name
S|My Awesome Server

# Required segments — always shown for all players
R|NameplateBuilder|player_name
R|EliteMobs|health

# Disabled segments — hidden from all players
D|MyMod|debug_info

​
Mutual Exclusion

A segment cannot be both required and disabled. If an admin marks a required segment as disabled, it is automatically removed from the required set (and vice versa). This is enforced both in the UI and in the persistence layer.

​
File Location

Both files are stored in the mod’s data directory: 
%APPDATA%/Hytale/UserData/Saves/<save>/mods/NameplateBuilder/
  preferences.txt
  admin_config.txt