exppireed Prova is not public yet; stay tuned!
Nametag System · Setup Guide

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.

Coming Soon Group rankOverhead tagsOne config file
Time 10 min For a first install.
Steps 10 In order, below.
Services 3 Where its parts go.
Settings 25 All in NametagConfig.
It can’t run with the Training Nametag System. Only one nametag system runs in a game. If both are installed, Prova Core stops one of them with PC-010. Remove the one you don’t want.

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.

Explorer

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

Icons aren’t included. The badges come without pictures. Upload your own on create.roblox.com and put their IDs in BadgeImages in NametagConfig, or set them on each badge in NametagUI.
Where the Nametag System parts go
ServiceObjectWhat it holds
ReplicatedStoragePROVA | Nametag SystemThe README and the remotes the nametags use.
ServerScriptServicePROVA | Nametag SystemThe system, its settings and the nametag design.
StarterPlayer → StarterPlayerScriptsPROVA | Nametag SystemThe player side: typing, AFK and the mute badge.
Created when the game runs. Don’t add these yourself. Remotes, again, if it was deleted by mistake.

Installation

Follow the steps in order.

  1. 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.

  2. 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.

  3. Download the Nametag System File

    The Nametag System arrives as one file, from the Prova Discord server. Save it somewhere you can find it.

  4. 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.

    1. Download Prova Core from the Prova Discord server.
    2. In Explorer, right-click Workspace and choose Insert from File. Pick the Prova Core file.
    3. Among what it adds are two folders named PROVA | Core.
    4. Drag the one holding Constants, Core, Ed25519 and Log into ReplicatedStorage.
    5. Drag the one holding CoreServer and LicenseProvider into ServerScriptService.
    6. Delete anything left over, such as an empty model.
    Explorer

    ReplicatedStorage

    └─ PROVA | Core

    ServerScriptService

    └─ PROVA | Core

    Only one copy of Core. A second PROVA | Core stops every system with PC-002.
  5. 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 holdingInto
    README and RemotesReplicatedStorage
    NametagConfig and NametagUIServerScriptService
    NametagClientStarterPlayer → StarterPlayerScripts
    Remove any other nametag script in your game, or players get two nametags. Delete anything left over, such as an empty model.
  6. 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
  7. 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
  8. 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
  9. 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 Secret
    Add Your Licence Key as a Secret
    FieldType
    Nameprova_licence
    SecretYour licence key
    Domainapi.withprova.app
  10. 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.

Every Badge.
In NametagUIIn BadgeImagesShows when
StreakStreakAlways, with the days in a row
VIPVIPThe player owns VIPGamePassId
PlusPremiumThe player has Roblox Premium
RainbowRainbowRainbowGamePassId or RainbowUserIds
DevDevThe rank is in DevRanks
AFKAFKThe player is away
TypingTypingThe player is typing
MuteMuteOnly to players who can’t chat with them

Settings

All settings are in one file. Change a value, then publish.

ServerScriptService/PROVA | Nametag System/NametagConfig
If a value is wrong, Output names the setting and the standard value is used instead. Standard values are listed below.

Your Group

Find a rank’s number on Roblox: your group → Configure → Roles. Each role shows a rank from 0 to 255.

Nametag System: Your Group
SettingStandardWhat it does
GroupId0Your group’s ID. 0 means no role line, no rank colours and no Dev badge.
ShowGroupRoletrueShow the player’s role under their name.
RankColorsranks 5, 7 and 255The role’s colour per rank, e.g. [5] = Color3.fromRGB(51, 168, 255),
DefaultRankColorColor3.fromRGB(255, 255, 255)Colour for ranks not in RankColors.
DevRanks{ 255, 249 }Ranks that get the Dev badge.

The Name

Nametag System: The Name
SettingStandardWhat it does
NameDisplay"Username"The top line: "Username", "DisplayName" or "Both".
HideDefaultNametrueHide Roblox’s own name above players.
HeightAboveHead2.7Studs above the head, 0 to 50.
MaxViewDistance0How 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.

Nametag System: Game Passes
SettingStandardWhat it does
VIPGamePassId0Owners get the VIP badge.
RainbowGamePassId0Owners get the Rainbow badge.
VerifiedGamePassId0Owners get a verified tick before their name.
RainbowUserIds{}Players who always get the Rainbow badge, by user ID, never by name.

Badges

Nametag System: Badges
SettingStandardWhat it does
ShowStreaktrueDays in a row the player has joined.
ShowVIPtrueThe player owns the VIP pass.
ShowPremiumtrueThe player has Roblox Premium.
ShowRainbowtrueThe player owns the Rainbow pass or is in RainbowUserIds.
ShowDevtrueThe player’s rank is in DevRanks.
ShowAFKtrueThe player is away.
ShowTypingtrueThe player is typing in chat.
ShowMutetrueShown only to players who can’t chat with them.
BadgeImagesall ""A picture per badge. "" keeps the picture already on that badge in NametagUI.
AFKAfterIdleSeconds120Seconds without input before AFK. 0 means only when leaving the window.

Saving and Output

Nametag System: Saving and Output
SettingStandardWhat it does
StreakDataStoreName"ProvaNametagStreaks"The name streaks are saved under. Changing it starts every streak again from 1.
VerboseLoggingfalsePrint each nametag shown or removed.

Troubleshooting

Open Output and look for lines starting with [PROVA |. All PC- codes are also on Error Codes.

Problems with the Nametag System
You seeIt meansWhat to do
PC-010Both nametag systems are installed.Remove the Training Nametag System or this one.
GroupId is 0No group is set.Set Your Group.
isn’t validA typing mistake in NametagConfig.The message names the setting.
NametagUI is missingThe nametag design was deleted.Insert the file again and put NametagUI back.
Badges show no pictureNo images are set.Add Your Badge Pictures.
Two nametags on a playerAnother nametag script is still in your game.Remove it.
PC-001Prova Core isn’t installed.Install Prova Core.
PC-002Prova Core is installed twice.Delete one PROVA | Core from each service.
PC-003No licence key found.Add the secret. In a Studio Play, add a Local Secret or use a Team Test.
PC-004HTTP requests are off.Turn On Allow HTTP Requests.
PC-005Prova couldn’t be reached.Usually passes by itself. If not, check the secret’s Domain is api.withprova.app.
PC-006The key isn’t valid.Copy it again, or rotate it on your dashboard.
PC-014You don’t own this experience.Use it in an experience owned by you or your group.
PC-015Your licence doesn’t cover the Nametag System.Buy its Game Pass, or remove it.

Notes

Restyle NametagUI freely, but keep the names Username, GroupRank, Badges and every badge inside it.
To see the Streak badge in Studio, turn on Enable Studio Access to API Services under File → Experience Settings → Security.
Moving from the old nametag script? Set StreakDataStoreName = "PlayerDailyStreaks" to keep its streaks.