Advanced IDs

Overview

Authorized employees issue permanent ID cards with a real photo of the recipient. Cards live in a 6-slot wallet container (ox_inventory), persist in MySQL with a unique serial, and are shown to nearby players with a 3D card prop — including through vehicle windows. Includes 25 built-in card types, a visual card designer, a Records Office NPC for self-service purchases and reissues, and a separate forged-documents flow.

Installation

Install the dependencies first, keep the resource folder named exactly iconix-advancedids, and start everything in the right order.

1. Install and start ox_lib, oxmysql and screenshot-basic, plus your framework and inventory. All three are hard dependencies.
2. Keep the folder name exactly iconix-advancedids — the supplied item definitions call exports under that name.
3. Register the inventory items from the install/ folder (see the next section) — these files are merge templates, do not ensure them.
4. Import install.sql once, or leave AutoCreate enabled and grant the oxmysql account CREATE TABLE for first start. Manual import is preferred on production databases.
5. Grant issuer access: the government job (grade 0+) or the ACE iconix-advancedids.issue (see Permissions).
6. Order your server.cfg as shown below, then run the two-player test checklist before going live.

ensure oxmysql
ensure ox_lib
ensure screenshot-basic
ensure your_framework
ensure your_inventory
ensure iconix-advancedids

Inventory items

Merge the supplied item definitions into your inventory before first start — the wallet and every card type are items.

1. ox_inventory: merge install/ox_inventory_items.lua into ox_inventory/data/items.lua (wallet + card types, stack = false).
2. qb-inventory: merge install/qbcore_items.lua into QBShared.Items (unique = true) and copy the item images into your inventory image folder.
3. Restart the FULL server after changing ox_inventory items — restarting only this resource does not rebuild the item registry.

Permissions

Issuing is granted by job name + minimum grade or by ACE; the card designer and unrestricted checks are admin-gated.

add_ace group.idissuer iconix-advancedids.issue allow
add_principal identifier.license:YOUR_LICENSE group.idissuer
add_ace group.admin iconix-advancedids.admin allow
add_ace group.admin iconix-advancedids.design allow

Commands

All actions are command- or item-driven; every command name is configurable via Config.Commands.

• /issueid [player id] [card type]
  issue a permanent card as an authorized employee; photographs the recipient.
• /idcard [type] [serial]
  view one of your own cards.
• /showid [type] [serial]
  present a card to nearby players with the 3D prop.
• /checkid [player id]
  inspect a nearby player's card (authorized jobs; admins unrestricted).
• /idcards
  open the owned-cards menu.
• /idadmin
  open the visual card designer (admin/ACE only).

Key configuration

config.lua stays editable (escrow-ignored). The options server owners most often change:

• Config.IssuerName
  the issuing authority printed on cards.
• Config.CardTypes
  25 built-in types (identity, license and badge templates); add new types with a config entry plus an item definition.
• Config.EmployeeIssuing
  issuer jobs/ACEs, 3 m proximity, 30 s photo token, per-type allowlist.
• Config.Wallet
  wallet item, 6 slots; issuance fails and rolls back rather than dropping cards loose (FallbackToPlayer = false).
• Config.Issuing
  the Records Office NPC: location, prices, payment account, blip and targeting.
• Config.Locale
  en, es, fr, de, pt, nl or tr.

Developer API

Server and client exports for integrating your own resources — issue, remove and check cards, read records, and react to issuance events. Server exports must be called server-side.

-- server-side
local ids = exports['iconix-advancedids']

local result = ids:issueCardToPlayer(source, 'driver_license', {
    show = true -- present the card right after issuing
})
if not result.ok then
    print(result.code, result.message)
end

if ids:hasCard(source, 'weapon_license') then
    -- player carries a weapon license card
end

AddEventHandler('iconix-advancedids:cardIssued', function(card)
    print(('card %s issued to %s'):format(card.cardType, card.source))
end)

Testing checklist

Run the two-player verification from the bundled installation guide before production.

1. As an authorized employee, run /issueid on a second player — only the recipient should enter the portrait scene.
2. Confirm the card lands in the wallet (ox_inventory) or personal inventory (qb-inventory) and the hover shows exactly seven fields.
3. Check /idcard shows the recipient's photo and a row exists in iconix_advancedids_cards.
4. Reconnect and restart the server — the photo and card must survive both.
5. Confirm an unauthorized player's /issueid is rejected.