Getting Started

This documentation will guide you through the setup and use of the dnd_identitydocs resource.

What the resource does

dnd_identitydocs is an advanced identity card, license, and document management system for FiveM. It provides a comprehensive set of features, including a user-friendly desktop UI, job-based access control, and customizable documents. Key functionalities include:

• Desktop Apps: Manage requests, licenses, documents, archives, printers, and templates with ease.
• Holder/Viewer Modes: Choose between DB-backed holder mode or inventory item-based mode.
• Dynamic Templates: Use runtime DB-driven document templates for maximum flexibility.
• DMV/STNK Support: Efficiently manage vehicle registrations.
• Radial Menu Integration: Quickly access document commands via qbx-radialmenu.

Core Workflows

Identity / License

1. Player submits request.
2. Request enters pending status.
3. Staff approves or rejects the request.
4. If required, player completes a pass photo.
5. Request becomes ready_to_print.
6. Staff prints the document to a target player.
7. Result is stored in either the holder DB or as an inventory item, depending on the chosen mode.
8. Players can view or show their documents using in-game commands.

DMV/STNK Registration

1. Player submits STNK request.
2. Staff approves the request.
3. Request goes directly to ready_to_print (no pass photo required).
4. Staff prints the document to the target player.
5. The system renders STNK documents as PLAT | NAMA MOBIL.

Document Creation

1. Staff selects a document template.
2. Fills out the required form fields.
3. Submits the document for printing.
4. Resulting document is available in archives, holders, or viewer modes.

New Features in 2026 Update

• Desktop UI: Includes a sidebar navigation menu and supports dynamic logos.
• Job/Grade-based Access Control: Restrict features based on player job and rank.
• Archive Filtering: Only show entries relevant to the player’s job.
• Quick Access Command: /holder_documents for instant document access.
• Enhanced Radial Menu: Faster and more intuitive document commands.
• Additional Apps: Name Change App (including holder persistence) & Printer App (photo validation included).
• Compatibility with ESX and QBox: Fully supported across both frameworks.

Recommended First Steps

1. Install all necessary dependencies.
2. Verify database table structure.
3. Configure the config.lua file according to your server’s requirements.
4. Optionally, register ox_inventory items needed for operation.
5. Test key workflows, such as printing and archive access, on a staging server with multiple testers.
6. Confirm that Config.use_holder is set to your preferred storage mode.

Production-Ready Settings

• Config.Debug = false
• Ensure database seeding has been completed for templates and configuration.
• Verify seamless operation for both desktop and in-world interactions.