nametags

Custom overhead nametags for Roblox (server realm).

Replaces the default Humanoid name/health display with a BillboardGui showing the player's DisplayName plus an optional subtitle line.

The subtitle line is generic: other systems own its content via setSubtitle (and onTagCreated to hook newly built tags). This package has no knowledge of titles or any other system.

Install

In your game's server wally.toml:

[dependencies]
nametags = "nack-2/nametags@0.1.0"

Then:

wally install --project-path ServerScriptService/Modules

Usage

local NameTags = require(game.ServerScriptService.Modules.Packages.nametags)

NameTags.setup() -- hooks all current and future players (safe to call multiple times)

API

• setup() — hook Players.PlayerAdded + all current players. Safe to call multiple times.
• setupPlayer(player) — hook one player's respawns so every character gets the tag.
• setupCharacter(player, character) — attach the tag to a specific character.
• getTag(player): BillboardGui? — find a player's current tag, if any.
• setSubtitle(player, text, colour?) — set the generic subtitle line; empty text hides it.
• onTagCreated(callback) — hook fired with (player, tag, character) every time a tag is built.
• refresh(player) — immediately re-render a player's DisplayName.

Publishing a new version

1. Bump version in wally.toml.
2. wally package --project-path . --output nametags.zip (or --list to preview files).
3. wally publish --project-path .
4. Add the new version to your wally index, then wally install in consuming projects.