The Lab ID
Census offices and identity cards for RedM (RDR3). Works with VORP, RSG, RedEM:RP and standalone (auto-detected). Everything gameplay related is configured in game, with no config file to edit.
Highlights
- Census NPCs in every town you want. Same interaction as tlb-telegram: hold right click on the NPC, then E to register or G to read the registry.
- Fill in the card: name (locked to the character by default), date and place of birth, sex, height, weight, eyes, hair, distinguishing marks.
- ID photo from an image link (whitelist of allowed sites) or a picture imported in game: pasted (Ctrl+V) or picked from a file, stored with the card so no image host is needed.
- Card backgrounds: four bundled, add your own from the admin panel (bundled file or https link).
- Free or paid, per office.
- The town is printed on the card: it shows where the census was taken. Registering in another town destroys the previous card (database and item) after a confirmation.
- Show your card to the closest player. It appears on their screen without taking their focus and fades out on its own.
- Census registry: sheriffs, town hall and any jobs chosen per office read the list of residents from the NPC, and can take a copy of the registry as an item.
- 14 languages included, English by default, switchable in game, every text translated.
Requirements
- RedM, with OneSync on (used to validate distances on the server).
- oxmysql.
- One of: VORP (vorp_core + vorp_inventory), RSG (rsg-core + rsg-inventory), RedEM:RP (redem_roleplay + redemrp_inventory), or nothing (standalone).
Installation
- Drop
tlb-idinto your resources. - Add the items:
- VORP: import
installation/vorp-items.sql, then restartvorp_inventory. - RSG: copy the entries of
installation/rsg-items.luaintorsg-core/shared/items.lua. - Standalone: nothing, cards live in the database and open with
/idcard. - Copy the images from
installation/item-images/into your inventory image folder (vorp_inventory/html/img/items/orrsg-inventory/html/images/).
- Give admins the permission (VORP
admingroups and RSGadmin/godare also accepted):
add_ace group.admin tlb-id.admin allow
- In
server.cfg, after the framework:
ensure oxmysql
ensure tlb-id
- Start the server, join, type
/idadminand add your census offices (Offices, then "add at my position", then Save).
The tlb_id_cards table is created automatically on first start.
Configuration (in game: /idadmin)
There is no config file. Everything is set in game and applied live to every player.
| Tab | What you set |
|---|---|
| Offices | Town (printed on the card), NPC model, position and heading, blip, paid and price, jobs allowed to read the registry. |
| Card backgrounds | Name, image (assets/cards/... or https://...), offered or not. |
| Cards | Every issued card, all towns: search, correct any field, photo or background, revoke (the holder's item is removed if online). |
| Texts | Every text of every language, editable; only edited texts are stored, "reset" restores the original. |
| General | Language, card as an item, portable registry, striking off from the registry, locked name, photo required, displayed year, default NPC model, show distance, display time, allowed photo sites. |
| System | Framework, admin permission (ACE), command names, item names, prompt keys, blip icon and size, max distance to the NPC, debug mode. |
Settings are saved to data/settings.json (created on first start). Do not edit it while the server runs. If a wrong value locks you out (for example an ACE nobody has), stop the server and delete the "system" block of that file to restore defaults.
Languages
Included: English (default), Francais, Deutsch, Espanol, Italiano, Portugues, Polski, Nederlands, Russian, Turkce, Cestina, Magyar, Romana, Svenska.
- Pick the language in
/idadmin> General. - Edit any text in
/idadmin> Texts. - Add a language: copy
locales/en.jsontolocales/<code>.json, translate the values and keep the{0},{1}placeholders. Missing keys fall back to English.
Frameworks
A small adapter per framework lives in bridge/server/frameworks/, the only open Lua files, so you can add your own. Copy standalone.lua, fill in the listed functions (getCharacter, addMoney, removeMoney, isAdmin, notify, addItem, removeItems, registerUsableItem), set a resource field for auto-detection, and pick it in /idadmin > System. Tested on VORP; test the RSG and RedEM:RP adapters on your own server before going live.
What's included
- Server and client Lua (protected by escrow) and the pre-built interface (
app/): no build step, just drop the resource in and start it. - Framework adapters (
bridge/server/frameworks/, open). - Translations (
locales/, 14 languages). - Item SQL and item list (
installation/).