Installation

Prerequisites

Make sure your server includes the dependencies below before installing dnd_identitydocs:

• oxmysql: Database interactions.
• ox_lib: Enhanced utilities for FiveM.
• ox_inventory: Inventory management (item-based mode).
• screenshot-basic: For photo validation workflows.
• qbx-radialmenu (optional): For advanced radial menu integration.

Installation Steps

Step 1: Resource Placement

Place the dnd_identitydocs folder in your server’s resources directory:

resources/[local]/dnd_identitydocs

Step 2: Configure server.cfg

Insert the following lines into your server.cfg file:

ensure oxmysql
ensure ox_lib
ensure ox_inventory
ensure screenshot-basic
ensure dnd_identitydocs

If you want full radial menu support, add:

ensure qbx-radialmenu

Step 3: Database Setup

Import the SQL scripts provided with the resource:

./resources/dnd_identitydocs/database/structure.sql
./resources/dnd_identitydocs/database/templates.sql

Step 4: Ox Inventory Items

Register the necessary items for ox_inventory (if applicable):

['identity_card'] = {
    label = 'Identity Card',
    weight = 50,
    stackable = false
},
['driver_license'] = {
    label = 'Driver License',
    weight = 50,
    stackable = false
},

Step 5: Configuration

Refer to our Configuration Guide for details on:

• Debug mode
• Storage modes (holder vs item-based).
• Access controls.

Step 6: Test Installation

Perform the following tests:

1. Holder/Item View Testing: Verify you can print, show, and view identities correctly.
2. Photobooth Workflow: Ensure image capture and validation work reliably.
3. Desktop UI Validation: Test sidebar navigation and apps in the desktop interface.

Optional Tebex Integration

If you monetize server items or features, ensure compatibility with Tebex by integrating wallet transactions into the holder or inventory systems.

---

Your dnd_identitydocs resource is now ready for use.