FiveM · Qbox · QBCore · ESX

SHORT DESCRIPTION

Design every ID card and license in-game, issue them from the police desk with real cash / bank payments, and show them to players in front of you — featuring automatic mugshots, signatures, barcodes, searchable records database, lost / stolen system, and work IDs from NPCs.

OVERVIEW

Give your city real documents.

xrisma ID Cards & Licenses is a complete document system for roleplay servers. Admins design every card in-game with a live preview, police issue them at the desk, citizens pay with cash or bank, and every card lives in your database — searchable, revocable, and permanently tied to its real owner.

• Zero config files for card design: colors, textures, logo, and every field are edited live in-game.

• Zero external image hosting: holder mugshots are captured automatically in-game at the moment of issue.

IN-GAME TEMPLATE CREATOR (Admins)

• Unlimited templates — create, edit, duplicate, toggle, or delete

• Live card preview while you type

• Every text editable: document name, header, title, subtitle, footer, watermark, issuing authority, signature labels, "no expiry" text, and status stamps

• 8 color presets + custom colors for background, accent, text, and labels

• 7 static background textures: guilloche, carbon, hex, waves, grid, lines, or none

• Custom server logo from URL (Imgur, Discord CDN, Fivemanage)

• Toggle card elements: photo, barcode, holder signature, issuer signature, chip, and MRZ zone

• 12 built-in fields (Name, Date of Birth, Sex, Nationality, Height, Job, Rank, Citizen ID, etc.)

• Up to 6 custom fields per card — officer-filled or fixed admin values

• Set price, re-issue price, expiration days, issuing job grades, and allowed holder jobs

• 5 ready-made templates included: Citizen ID, Firearms License, Driving License, Police ID, EMS ID

POLICE DESK — /idissue (Police Job Only)

• Issue tab: select a nearby citizen and document with a live final card preview

• Read-only character data protection — officers cannot tamper with player info

• Applications tab: real-time queue for pending citizen requests with 1-click approvals

• Records database: search by name, citizen ID, or card number with live filters

• Card controls: revoke, mark lost, mark stolen, or reactivate

• Instant citizen notifications when document status changes

• Configurable self-issue option for active duty officers

CITIZEN PORTAL — /idrequest

• Apply for any available license with an optional note

• "My Documents" menu: inspect every owned card, current status, and validity dates

• Report cards lost or stolen — the old physical item is permanently disabled

• Apply for document re-issues at a reduced fee

WORK IDs FROM NPCs (Police & EMS)

• Work badges are issued exclusively via dedicated job NPCs (no menu bypass)

• Local NPC is only visible to active employees of that job

• Server-verified job and distance checks

• Free or society-funded options (funds route directly to the job society)

• Auto-populates official service signature, holder's job, and current rank

• Validity check: cards can only be shown while actively holding the job

• Easily add unlimited custom job NPCs (e.g. Taxi Company) via config

IMMERSIVE CARD DISPLAY

• Physical hold-up animation paired with a realistic card prop

• Directional view: strictly visible to players in front and within range

• Synchronized display: press Backspace to lower the card for everyone

• Genuine ownership metadata stored inside the item

• Personal or shareable mode (lock to owner or allow physical inspection)

AUTOMATIC MUGSHOT PHOTO

• In-game mugshot captured automatically on issue and saved with the card

• No external links, manual screenshots, or web uploads required

• Displayed seamlessly in the hold-up prop, database records, and citizen UI

SMART PAYMENTS (Qbox, QBCore, ESX)

• Citizen choice between Cash or Bank payment

• Automatic balance fallback if cash is insufficient

• Split payments if neither account has full funds alone

• Full refund safety protection if inventory is full

• Direct society account integration (Renewed, qb-banking, qb-management, esx_addonaccount)

LOST / STOLEN / RE-ISSUE LOGIC

• Lost, stolen, and replaced cards never open again — even if the item is found

• Revoked and expired cards still open with VOID / EXPIRED visual stamps

• Re-issues cost a smaller fee; revoked cards cannot be re-issued

SECURITY & OPTIMIZATION

• 100% server-side validation for permissions, ranges, prices, and templates

• One-time action tokens preventing replay exploits and item duplication

• Rate limits, cooldowns, and sanitized inputs across all endpoints

• Automated Discord webhook logs for templates, issuing, records, and security audits

COMPATIBILITY

Frameworks: Qbox · QBCore · ESX (auto-detected)

Inventories: ox_inventory · qb-inventory (ps / lj) · qs-inventory · ESX default (item metadata requires ox / qb / qs)

Targeting: ox_target · qb-target · built-in marker + [E]

Notifications: built-in (8 screen positions) · ox_lib · framework · GTA native

Database: oxmysql

WHAT'S INCLUDED

• Complete script (Lua + NUI)

• Ready-to-paste item definitions for ox_inventory and qb-inventory

• 4 item images (.PNG)

• SQL file (tables are also created automatically)

• Comprehensive installation and configuration guide

QUICK INSTALLATION

1. Place the folder into your resources directory and add ensure xrisma_Creator_idcard to your server.cfg.

2. Add the items and images to your inventory resource.

3. Grant admin permission: add_ace group.admin xrisma.idcreator allow

4. Configure your language, prices, and NPC coordinates in config.lua.

DEVELOPER EXPORTS

exports.xrisma_Creator_idcard:HasValidCard(source, 'weapon')

exports.xrisma_Creator_idcard:GetCards(source)