Custom Player Names And Roles

🎖️ Custom Player Names & Roles
Take control of your battlefield identity!
This mod lets players set custom display names and role prefixes, replacing default console or platform usernames with immersive military-style identities.

Support in Discord: https://discord.gg/2EDkGpPPRH

⚙️ Features
✅ Dual Identity System
Custom Name (Callsign): Your personal identifier — e.g. Eagle-1, Ghost, Viper
Role Prefix: Your position or duty — e.g. [Medic], [SL], [Engineer]
Display Format: [Role] Callsign for clear and consistent identification

✅ Chat Command System
Simple, universal chat commands no extra UI required:
.name <custom name>     → Set your callsign (3–20 chars)
.prefix <role>          → Set your role prefix (max 10 chars)
.clearname              → Remove your callsign
.clearprefix            → Remove your role
.reset                  → Clear both name and role
.myname                 → Display your current identity
.namehelp               → Show command list

✅ ADMIN ONLY Chat Commands
.setname <playersname> <CustomName>             → ADMIN SETS PLAYERS NAME
.setprefix <playersname> <CustomePrefix>            → ADMIN SETS PLAYERS PREFIX
IF PLAYER HAS SPACE IN THE NAME USE ""
.setname "Big John" Sgt. John

✅ Universal Display
Your identity is visible everywhere:
Nametags: Floating above players → [Role] Callsign
Scoreboard: (RealUsername) [Role] Callsign — admins can still identify you
Voice Chat Overlay: Radio and local voice both use your custom name
Killfeed: Death messages reflect your identity

✅ Name Uniqueness Enforcement
Each Custom Name (Callsign) is unique — prevents duplicates/confusion
Roles can be shared — e.g., multiple [Medic] players allowed

✅ Profanity Filter System
Keep your community clean with a server-configurable blacklist:
Editable JSON file: $profile:CustomNamesConfig.json
Options:
{
  "enable_filter": true,
  "case_sensitive": false,
  "block_partial": true,
  "banned_words": [
    "badword1",
    "badword2",
    "badword3"
  ]
}

Blocks inappropriate names based on your settings
Supports case sensitivity and partial-match detection

✅ Multiplayer & Persistence
Fully Replicated: Everyone sees your name instantly
Persistent: Stored by player UID, not session
Server-Side Storage: $profile:CustomNames.json
Automatic Restoration: Your name/role reloads on reconnect

✅ Admin-Friendly
Scoreboard format: (RealUsername) [Role] Callsign
Perfect for moderation — admins always know who’s who

✅ Cross-Platform Compatible
Works seamlessly on PC, Xbox, and PlayStation
100% chat-command-based — no special controls or UI needed

⚠️ CSI Compatibility
Out of the box, this mod does not yet support Coalition Squad Interface (CSI).
A separate compatibility patch will be released to integrate Custom Names into CSI’s UI systems.

🪖 Perfect For:
Roleplay Servers: Create immersive identities
MilSim Operations: Proper callsigns and unit roles
Community Events: Organized team play
Training Servers: Instructor/student identification
Clans & Units: Enforce naming standards

🧠 Technical Details
No EPF dependencies — works with vanilla Reforger
UID-based identity system (persistent across sessions)
Real-time synchronization via RPC replication
Server-side uniqueness and profanity validation
Faction-independent and compatible with all vanilla modes

Example Usage:
.name Ghost
.prefix Medic

🪪 You now appear as: [Medic] Ghost to all players!

Server Config Files:
$profile:CustomNames.json → Player data storage
$profile:CustomNamesConfig.json → Profanity filter settings

Bring immersion, clarity, and professionalism to your Reforger experience
because “xXNoobSlayer420Xx” doesn’t belong on the battlefield.