vrs_permanentid is designed to be read-only from the outside. Any resource can display or log the permanent ID without a hard dependency, by reading the replicated statebag or calling the exports.
HUDs and scoreboards (recommended)
Statebags replicate automatically. No export call, no server round-trip.
To render an ID above another player’s head, iterate active players and read their statebag:
Use the server exports to resolve IDs both ways, including offline lookups.
Offline lookups (reports, bans, ticketing)
Resolve a permanent ID to a stored identifier even if the player is offline:
Going the other way:
Iterating every online player
Depending on the resource
vrs_permanentid itself requires vrs_bridge v1.2.0+. If your resource wants to hard-require the permanent-id resource, add it to your fxmanifest.lua:
If you’d rather stay optional, guard your calls:
Last modified on July 28, 2026