Nametag System setup
Nametags above every player for your group’s main game: name, group role in its rank colour, and badges for streak, VIP, Premium, Rainbow, Dev, AFK, typing and mute.
You Need
- Roblox Studio, with your game open.
- Your Prova licence key, from your dashboard.
- To own the experience, or the group that owns it.
- Your Roblox group’s ID.
You Get
- A file from the Prova Discord server.
- Prova Core, free, one per experience.
- Your licence key, added as a secret.
What Goes Where
Your Explorer after installing. Don’t rename anything.
ReplicatedStorage
└─ PROVA | Nametag System Folder
├─ README Script
└─ Remotes Folder
├─ MuteStatus RemoteEvent
└─ StatusUpdate RemoteEvent
ServerScriptService
└─ PROVA | Nametag System Folder
├─ NametagConfig ModuleScript
├─ NametagRules ModuleScript
├─ NametagServer Script
├─ NametagService ModuleScript
├─ NametagUI BillboardGui
│ ├─ Badges Frame
│ │ ├─ AFK ImageLabel
│ │ ├─ Dev ImageLabel
│ │ ├─ Mute ImageLabel
│ │ ├─ Plus ImageLabel
│ │ ├─ Rainbow ImageLabel
│ │ ├─ Streak ImageLabel
│ │ ├─ Typing ImageLabel
│ │ ├─ UIListLayout UIListLayout
│ │ └─ VIP ImageLabel
│ ├─ GroupRank TextLabel
│ └─ Username TextLabel
├─ StatusService ModuleScript
└─ StreakService ModuleScript
StarterPlayer → StarterPlayerScripts
└─ PROVA | Nametag System Folder
└─ NametagClient LocalScript
| Service | Object | What it holds |
|---|---|---|
| ReplicatedStorage | PROVA | Nametag System | The README and the remotes the nametags use. |
| ServerScriptService | PROVA | Nametag System | The system, its settings and the nametag design. |
| StarterPlayer → StarterPlayerScripts | PROVA | Nametag System | The player side: typing, AFK and the mute badge. |
Installation
Follow the steps in order.
-
Join the Prova Group
You must be in the Prova group when you buy and when you sign in to your dashboard. Players in your game don’t need to join.
-
Buy the Game Pass
One payment in Robux, from the Nametag System page. The Game Pass is your proof of purchase.
Then open your dashboard and create your licence key. It is shown once, so copy it somewhere safe. One key covers every system you own, in up to six of your experiences.
-
Download the Nametag System File
The Nametag System arrives as one file, from the Prova Discord server. Save it somewhere you can find it.
-
Install Prova Core
Once per experience, however many Prova systems you own. Core is free. Open View → Explorer and click the arrow beside ReplicatedStorage. If PROVA | Core is already there, skip this step.
- Download Prova Core from the Prova Discord server.
- In Explorer, right-click Workspace and choose Insert from File. Pick the Prova Core file.
- Among what it adds are two folders named PROVA | Core.
- Drag the one holding Constants, Core, Ed25519 and Log into ReplicatedStorage.
- Drag the one holding CoreServer and LicenseProvider into ServerScriptService.
- Delete anything left over, such as an empty model.
ExplorerReplicatedStorage
└─ PROVA | Core
ServerScriptService
└─ PROVA | Core
Only one copy of Core. A second PROVA | Core stops every system with PC-002. -
Add the Nametag System Folders
In Explorer, right-click Workspace and choose Insert from File. Pick the Nametag System file. Among what it adds are three folders named PROVA | Nametag System. Drag each one into its service.
Add the Nametag System Folders Drag the folder holding Into README and Remotes ReplicatedStorage NametagConfig and NametagUI ServerScriptService NametagClient StarterPlayer → StarterPlayerScripts Remove any other nametag script in your game, or players get two nametags. Delete anything left over, such as an empty model. -
Set Your Group
Open NametagConfig and change Config.GroupId = 0 to your group’s ID. It is the number in your group’s web address, for example roblox.com/communities/976641660.
Without it, nametags show names and badges but no role.
ServerScriptService/PROVA | Nametag System/NametagConfig -
Add Your Badge Pictures
The badges come without pictures. Upload an image for each on create.roblox.com, copy its ID, and put it in BadgeImages, like VIP = "rbxassetid://1234567890",
The Rainbow badge shows only the picture you set, to players who own RainbowGamePassId.
ServerScriptService/PROVA | Nametag System/NametagConfig -
Turn On Allow HTTP Requests
Turn on Allow HTTP Requests and click Save. Without it the licence can’t be checked and Core stops with PC-004. Already on if another Prova system works in this game.
File/Experience Settings/Security -
Add Your Licence Key as a Secret
Publish your game first: File → Publish to Roblox. Then, in a web browser, open create.roblox.com, click your experience, and in the left menu choose Secrets → Create Secret. Fill in all three fields exactly.
Already done for another Prova system? Skip this step. Lost your key? Rotate it on your dashboard and paste the new one here.
Creator Dashboard/Your Experience/Secrets/Create SecretAdd Your Licence Key as a Secret Field Type Name prova_licence Secret Your licence key Domain api.withprova.app -
Publish and Check the Output
Publish and join your game. Press F9 to open the Developer Console and choose the Server log. When the Nametag System works, you see these lines.
In the game, a few seconds after you spawn, a nametag with your name and role appears above your head, and Roblox’s own name disappears.
Testing in Studio instead? Open View → Output. A normal Play can’t read the published secret, so add a Local Secret named prova_licence with your key under File → Experience Settings → Security, or use a Team Test.
Output[PROVA | Core] v0.2.0 starting.
[PROVA | Core] Nametag System v1.0.1 registered.
[PROVA | Nametag System] v1.0.1 ready.
[PROVA | Core] Licence confirmed.
Every Badge.
The badge’s name in NametagUI, the picture’s name in BadgeImages, and who sees it.
| In NametagUI | In BadgeImages | Shows when |
|---|---|---|
| Streak | Streak | Always, with the days in a row |
| VIP | VIP | The player owns VIPGamePassId |
| Plus | Premium | The player has Roblox Premium |
| Rainbow | Rainbow | RainbowGamePassId or RainbowUserIds |
| Dev | Dev | The rank is in DevRanks |
| AFK | AFK | The player is away |
| Typing | Typing | The player is typing |
| Mute | Mute | Only to players who can’t chat with them |
Settings
All settings are in one file. Change a value, then publish.
Your Group
Find a rank’s number on Roblox: your group → Configure → Roles. Each role shows a rank from 0 to 255.
| Setting | Standard | What it does |
|---|---|---|
| GroupId | 0 | Your group’s ID. 0 means no role line, no rank colours and no Dev badge. |
| ShowGroupRole | true | Show the player’s role under their name. |
| RankColors | ranks 5, 7 and 255 | The role’s colour per rank, e.g. [5] = Color3.fromRGB(51, 168, 255), |
| DefaultRankColor | Color3.fromRGB(255, 255, 255) | Colour for ranks not in RankColors. |
| DevRanks | { 255, 249 } | Ranks that get the Dev badge. |
The Name
| Setting | Standard | What it does |
|---|---|---|
| NameDisplay | "Username" | The top line: "Username", "DisplayName" or "Both". |
| HideDefaultName | true | Hide Roblox’s own name above players. |
| HeightAboveHead | 2.7 | Studs above the head, 0 to 50. |
| MaxViewDistance | 0 | How far away nametags show, in studs. 0 is any distance. |
Game Passes
Find a pass’s ID on create.roblox.com → your experience → Monetization → Passes. 0 means not used.
| Setting | Standard | What it does |
|---|---|---|
| VIPGamePassId | 0 | Owners get the VIP badge. |
| RainbowGamePassId | 0 | Owners get the Rainbow badge. |
| VerifiedGamePassId | 0 | Owners get a verified tick before their name. |
| RainbowUserIds | {} | Players who always get the Rainbow badge, by user ID, never by name. |
Badges
| Setting | Standard | What it does |
|---|---|---|
| ShowStreak | true | Days in a row the player has joined. |
| ShowVIP | true | The player owns the VIP pass. |
| ShowPremium | true | The player has Roblox Premium. |
| ShowRainbow | true | The player owns the Rainbow pass or is in RainbowUserIds. |
| ShowDev | true | The player’s rank is in DevRanks. |
| ShowAFK | true | The player is away. |
| ShowTyping | true | The player is typing in chat. |
| ShowMute | true | Shown only to players who can’t chat with them. |
| BadgeImages | all "" | A picture per badge. "" keeps the picture already on that badge in NametagUI. |
| AFKAfterIdleSeconds | 120 | Seconds without input before AFK. 0 means only when leaving the window. |
Saving and Output
| Setting | Standard | What it does |
|---|---|---|
| StreakDataStoreName | "ProvaNametagStreaks" | The name streaks are saved under. Changing it starts every streak again from 1. |
| VerboseLogging | false | Print each nametag shown or removed. |
Troubleshooting
Open Output and look for lines starting with [PROVA |. All PC- codes are also on Error Codes.
| You see | It means | What to do |
|---|---|---|
| PC-010 | Both nametag systems are installed. | Remove the Training Nametag System or this one. |
| GroupId is 0 | No group is set. | Set Your Group. |
| isn’t valid | A typing mistake in NametagConfig. | The message names the setting. |
| NametagUI is missing | The nametag design was deleted. | Insert the file again and put NametagUI back. |
| Badges show no picture | No images are set. | Add Your Badge Pictures. |
| Two nametags on a player | Another nametag script is still in your game. | Remove it. |
| PC-001 | Prova Core isn’t installed. | Install Prova Core. |
| PC-002 | Prova Core is installed twice. | Delete one PROVA | Core from each service. |
| PC-003 | No licence key found. | Add the secret. In a Studio Play, add a Local Secret or use a Team Test. |
| PC-004 | HTTP requests are off. | Turn On Allow HTTP Requests. |
| PC-005 | Prova couldn’t be reached. | Usually passes by itself. If not, check the secret’s Domain is api.withprova.app. |
| PC-006 | The key isn’t valid. | Copy it again, or rotate it on your dashboard. |
| PC-014 | You don’t own this experience. | Use it in an experience owned by you or your group. |
| PC-015 | Your licence doesn’t cover the Nametag System. | Buy its Game Pass, or remove it. |
