02. Identity System

Covers proximity based name obfuscation, persistent RP nicknames, and the nametag rendering above player heads. All three share the same goal: keep players in character and prevent metagaming.

Config file: rpessentials-core.toml, section [Obfuscation Settings].

Proximity Obfuscation

Player names in the TabList and above heads are replaced by a string of ? characters beyond a configurable range.

Option	Default	Description
enableBlur	true	Master switch.
proximityDistance	12	Detection range in blocks.
obfuscatedNameLength	5	Number of ? characters shown.
obfuscatePrefix	true	Also hides the LuckPerms rank prefix while obfuscated.
opsSeeAll	true	Staff always see real names and do not have any range restricion.
debugSelfBlur	false	Debug only, applies blur to yourself as well.
enableSneakStealth	true	Crouching players are only detectable at a shorter range.
sneakProximityDistance	1	Detection range while crouching.
blurSpectators	true	Spectator mode players are hidden from the TabList (useful when you want to moderate players without them knowing you do so, this can prevent players who try to hide bad behaviors).
whitelist	[]	Players who always see everyone clearly.
blacklist	[]	Players who are always obfuscated, regardless of distance.
alwaysVisibleList	[]	Players who are never obfuscated to anyone.
whitelistExemptProfessions	false	Whitelisted players also bypass profession restrictions.

The player head icon next to an obfuscated name in the TabList is hidden as well, so a skin cannot be used to identify someone. Non obfuscated, staff, whitelisted, and always visible players keep their head icon.

Nickname System

Persistent RP nicknames, fully integrated across chat, TabList, nametags and private messages.

• Supports both § and & color codes.
• Stored in world/data/rpessentials/nicknames.json.
• Set with /rpessentials nick <player> <nickname>, reset with /rpessentials nick <player>.
• /whois <nickname> lets staff reverse look up the real username and UUID behind a nickname.
• Players can optionally set their own nickname with /rp selfnick, see the [Self Nick] section of rpessentials-rp.toml.

Nametag System

Realistic behaviour for the name displayed above a player's head.

Option	Default	Description
hideNametags	false	Hides all player nametags server wide.
showNametagPrefixSuffix	true	Shows LuckPerms prefix/suffix in the nametag.

Toggle at runtime with /rpessentials config set hideNametags true or false.

Chat variables

Wherever a player name can be formatted (chat, /rp commands, private messages), the following placeholders are available:

Placeholder	Meaning
$name / {player}	Nickname if set, otherwise the MC username.
$nick / {nick}	Alias of the above.
$real / {real}	Always the MC username.
$nick_real / {nick_real}	Nickname (RealName) when they differ, otherwise just the name.

Setting showRealNameInChat = true in rpessentials-chat.toml automatically appends (RealName) everywhere $name/{player} is used, without editing every format string.