The Lab

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

  1. Drop tlb-id into your resources.
  2. Add the items:
  • VORP: import installation/vorp-items.sql, then restart vorp_inventory.
  • RSG: copy the entries of installation/rsg-items.lua into rsg-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/ or rsg-inventory/html/images/).
  1. Give admins the permission (VORP admin groups and RSG admin/god are also accepted):
   add_ace group.admin tlb-id.admin allow
   
  1. In server.cfg, after the framework:
   ensure oxmysql
   ensure tlb-id
   
  1. Start the server, join, type /idadmin and 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.

TabWhat you set
OfficesTown (printed on the card), NPC model, position and heading, blip, paid and price, jobs allowed to read the registry.
Card backgroundsName, image (assets/cards/... or https://...), offered or not.
CardsEvery issued card, all towns: search, correct any field, photo or background, revoke (the holder's item is removed if online).
TextsEvery text of every language, editable; only edited texts are stored, "reset" restores the original.
GeneralLanguage, 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.
SystemFramework, 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.json to locales/<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/).