Troubleshooting

This guide covers common issues and their fixes.

1. Installation Errors

Error: Missing oxmysql dependency

• Cause: oxmysql isn’t running as a server resource.
• Fix: Ensure oxmysql appears in your server.cfg:

  ensure oxmysql

Database table doesn’t exist

• Cause: Missing or incomplete setup scripts.
• Fix: Rerun SQL setup for dnd_identitydocs_holders and dnd_identitydocs_config.

Error: screenshot-basic compatibility

• Cause: screenshot-basic is missing or outdated.
• Fix: Ensure the screenshot-basic resource is compatible with your runtime.

2. Configuration Issues

Debug mode accidentally left on

• Cause: Config.Debug = true remains active.
• Fix: Set to false for all production environments:

  Config.Debug = false

Cannot view holder documents

• Cause: Access control is misconfigured.
• Fix: Check the Config.AccessControl table to verify player permissions.

  Config.AccessControl = {
    ['police'] = 2  -- Ensure proper jobs & grades are listed
  }

3. Feature Bugs

Player can’t open radial menu

• Cause: qbx-radialmenu isn’t installed/enabled.
• Fix: Add qbx-radialmenu to server.cfg and ensure it’s operational.

Archive filters not working

• Cause: Config.ArchiveFilterByJob value misconfigured.
• Fix: Set the value to true to enforce role-specific entries.

  Config.ArchiveFilterByJob = true

4. Compatibility Problems

Error with legacy ESX

• Cause: ESX version compatibility issues.
• Fix: Update ESX or use QBox compatibility mode for seamless integration.

Document commands not responding

• Cause: Missing custom command bindings.
• Fix: Add HolderDocuments to the config.lua:

  Config.CustomCommands = {
    HolderDocuments = '/holder_documents'
  }

General Debugging Tips

1. Check the server console for errors.
2. Verify the latest database seed scripts are applied.
3. Consult the Config table against the newest documentation.