RaffLab Identity gives every saved character a permanent player ID on FiveM servers using QBCore or Qbox.
- Each saved character gets a permanent public ID that stays the same across reconnects and server restarts.
- Players and staff use this permanent ID in supported commands, admin tools, reports, and scoreboards.
- When a supported resource needs the player's current FiveM source ID, RaffLab Identity finds it in the background and passes it to the original resource.
- This allows your server to use fixed player IDs without changing how supported resources normally work.
- Deleted IDs are retired and never used again.
- txAdmin is not affected and continues to use the original FiveM source IDs. If a command or system is not supported, staff can still check the original source ID there and handle it manually. Unsupported scripts are not modified and continue using their existing ID behavior.
| Resource | Version | Purpose | Documentation |
|---|---|---|---|
rafflab_identity |
1.0.0 | Main identity resource | Main resource guide |
rafflab_identity_qb |
1.0.0 | QBCore integration | QBCore guide |
rafflab_identity_qbox |
1.0.0 | Native Qbox integration | Qbox guide |
| Custom integrations | — | Developer documentation | Integration guide |
Install the main identity resource together with the integration for your framework.
The main resource and active framework integration reported 0.00 ms client resmon during testing with two connected players on fresh QBCore and Qbox servers.
Results may vary depending on the server setup, installed resources, and player count.
- A current FXServer
- MySQL or MariaDB with InnoDB
oxmysql2.12.0 or newer- QBCore or Qbox
- The supported resource versions listed in the selected framework guide
For an automated setup that checks the required patches and creates a backup, use the installer for your framework:
- Stop the server before applying patches. Do not apply patches or restart the identity resources while players are online.
Basic setup:
- Back up your database and the resources that will be patched.
- Install
rafflab_identity. - Install either
rafflab_identity_qborrafflab_identity_qbox. - Review
rafflab_identity/config.luabefore issuing IDs. - Follow the installation guide for your framework.
- Perform a full server restart.
Only the resources receiving patches need to be clean and unmodified. A new server or empty database is not required.
Migration has been tested on an existing populated server and does not remove or replace character records.
- Invalid permanent IDs are rejected and are never treated as FiveM source IDs.
- Do not manually edit issued IDs, identity records, or sequence values in SQL.
- Do not change the identity namespace or anchor column after IDs have been issued.
After installation, perform a full server restart and follow the verification steps in the guide for your framework:
This project is licensed under GPL-3.0. See LICENSE.
Third-party patch context remains subject to the upstream licenses listed in THIRD_PARTY_NOTICES.md.
For security issues and vulnerability reporting, see SECURITY.md.
Copyright (C) 2026 RaffLab.