Getting Started

This documentation is for the dnd_identitydocs resource.

What the resource does

dnd_identitydocs is an identity card, license, and document system for FiveM with:

• Desktop apps for staff / issuer flows
• Tablet flow for public requests
• Viewer + show nearby
• Photobooth + printer queue
• Archive + revoke/delete
• Holder mode or item mode
• Runtime DB-driven document templates
• Template Manager (Desktop MVP)

Core Flow

Identity / License

1. player submits request
2. request enters pending
3. staff approves / rejects
4. if required, player completes pass photo
5. request becomes ready_to_print
6. staff prints to target player
7. result is stored in holder DB or inventory item depending on mode
8. result can be viewed via viewer / archive / holder

STNK

1. player submits STNK request
2. staff approves
3. request goes directly to ready_to_print
4. STNK does not require pass photo
5. staff prints to target player
6. holder / viewer renders STNK as PLAT | NAMA MOBIL

Documents

1. staff selects document template
2. fills form fields
3. submits document
4. request goes directly to ready_to_print
5. document is printed
6. result is visible in archive / holder / viewer

Recommended first steps

1. Install dependencies
2. Import or verify database tables
3. Register ox_inventory items
4. Configure FiveManage and locale if needed
5. Decide storage mode:
   • Config.use_holder = true → holder DB-backed
   • Config.use_holder = false → item-based
6. Build frontend if changes were made in web/src
7. Run smoke test with at least 2 players before production

Recommended production defaults

• Config.Debug = false
• verify dnd_identitydocs_config seed data exists
• verify templates_json for default documents is present
• verify printer / photobooth / desktop / tablet interactions in-world