Overhead Name Tag System

Overhead Name Tag System
A clean, server-side overhead name tag system for any Roblox experience. Display custom rank tags, colored names, and an optional health bar above every player's head — all driven by one config file.

Works with Roblox Group ranks or manual per-player overrides. No client scripts needed.

━━━ Features ━━━

Rank-Based Name Tags

Automatically assign tags like Owner, Admin, Moderator, Staff, Member
Tags pull from your Roblox Group rank or manual UserId overrides
Custom colors for both the name and the rank label independently
Rank tag position: above or below the name

Custom Name Colors

Every rank gets its own name color
Per-player overrides take priority over group ranks
Full RGB support with text stroke for readability

Optional Health Bar

Small health bar displayed under the name tag
Color interpolates from green (full) to red (low HP)
Configurable low health threshold
Auto-hides at full health (optional)

Display Settings

Hides Roblox's default overhead name
DisplayName or Username toggle
Configurable max view distance
Adjustable height offset above head
AlwaysOnTop option for visibility through walls
Light influence control

━━━ Why This System? ━━━

Server-side only — no client scripts, lighter on performance
One config file — everything in NameTagConfig
2 scripts total — minimal footprint
Auto-respawn — recreates on every character spawn
Group rank integration — set your Group ID and rank thresholds
Open source — fully readable and editable Luau
Installer included — one command in the Command Bar

━━━ What's Included ━━━

NameTagConfig (ModuleScript) — all settings in one place
NameTagServer (Script) — server-side logic
Installer (ModuleScript) — one-command setup
README — full setup guide and configuration examples

━━━ Setup (Under 2 Minutes) ━━━

1. Insert the .rbxmx into Workspace
2. Open Command Bar (View → Command Bar)
3. Run: require(workspace.CoreShunNameTagSystem.Installer)
4. Delete the folder from Workspace
5. Open NameTagConfig in ReplicatedStorage
6. Set your Group ID and customize ranks/colors
7. Playtest — done

━━━ Configuration Examples ━━━

Group rank tags:

Code:

GroupId = 12345678,
UseGroupRanks = true,

GroupRanks = {
    [255] = { Tag = "Owner",     NameColor = Color3.fromRGB(255, 215, 0) },
    [254] = { Tag = "Admin",     NameColor = Color3.fromRGB(255, 85, 85) },
    [200] = { Tag = "Moderator", NameColor = Color3.fromRGB(85, 170, 255) },
    [1]   = { Tag = "Member",    NameColor = Color3.fromRGB(200, 200, 200) },
}

Manual player override:

Code:

PlayerOverrides = {
    [12345678] = {
        Tag = "Owner",
        NameColor = Color3.fromRGB(255, 215, 0),
        TagColor = Color3.fromRGB(255, 215, 0),
    },
}

━━━ Requirements ━━━

Works in any Roblox experience
No external dependencies
No client scripts required

━━━ Support ━━━

Join our Discord: https://discord.gg/f6q9WpKB
Or message coreshun on BuiltByBit.

Overhead Name Tag System v1.0

Overview Updates (1) History Discord