LogoLogo
SupportServer Hosting
  • Sonoran CAD
  • 📱Download The App
    • Steam Browser - Workaround
    • Web Browser - Clear Cache
    • Desktop App - Clear Cache
    • GTA RP Tablet - Clear Cache
    • Steam Browser - Clear Cache
  • Why Choose Sonoran CAD?
    • 🏆Why Choose Sonoran CAD?
  • Other Products
    • 🖥️FiveM Hosting
    • 📝Sonoran CMS
    • 📡Sonoran Radio
  • Tutorials
    • Getting Started
      • Registering Your Account
      • Registering Your Community
      • Inviting Users to Your CAD
      • Granting Account Permissions
      • View Your Limits
      • Community ID and API Keys
      • Troubleshooting
    • Customization
      • Custom Domain & Login Page
      • Customizing Your Layout
      • Community Branding and Settings
      • Creating Custom Record and Report Types
      • Sharing Custom Records
      • Custom Search Types
      • Geographical Settings
      • Penal Codes
      • 10-Codes
      • Addresses and Street Names
      • Unit Status Codes
      • Tone Board
      • Custom Audio Notifications
      • Custom Emails
      • Quick Links
      • Custom Page Colors
      • User Account Restrictions
      • Configuring Multiple Servers
      • Advanced Query Strings
    • Dispatching
      • Creating a Call
      • Self Dispatch
      • Timers
      • Command Line Interface (CLI)
    • Records Management
      • Record Lookups
      • Adding a Record
      • PDF Records
      • Scene Diagram Builder
    • Administration
      • System Logs
      • Remove User Account
      • Deleting or Transferring your CAD
    • Other Features
      • Configurable Hotkeys
      • Voice Commands
      • Volume and Language
  • Integration Capabilities
    • 🗃️Paid Integration Resources
      • Mobile Command Center
      • ATM Robbery
      • In-Vehicle Radar
      • Evidence Camera
      • Power Grid
      • Speed Cameras
      • Shot Spotter
    • 🛠️Integrated Vendors
    • 📺Twitch Bodycam, Bot, & Lighting Integration
    • Database Sync and Merge
      • Database Sync Credentials
      • QB Core Mapping Tutorial
      • Troubleshooting
    • Discord Bot Integration
    • Discord Rich Presence
    • Discord Webhooks
    • TeamSpeak 3 Integration
    • Stream Deck Integration
    • 🎮FiveM
      • FiveM Installation
        • Submodule Configuration
          • Submodule Troubleshooting
          • Submodule Configuration Updates
        • FiveM Submodules
          • Body Camera
          • Call Commands
          • Check API ID
          • Civilian Integration
          • Dispatch Notify
          • Emergency Response Simulator (ERS)
          • Framework Support (ESX/QBCore) and Auto Fines
          • FivePD
          • ForceReg
          • Kick
          • Locations
          • Live Map
          • Lookups
          • Postals
          • Smart Signs
          • Sonoran Radio (sonrad)
          • Station Alert
          • Tablet & Mini-CAD
          • TeamSpeak 3
          • Traffic Stop
          • Unit Status
          • VehReg
          • WraithV2
      • FiveM Development Documentation
        • Client Functions
        • Shared Functions
        • Server Functions
        • Server Events
        • HTTP Request Handling
      • Error Codes
    • 🎮Roblox ER:LC
  • Developer API Documentation
    • 📖API Integration
      • Getting Started
        • Retrieving Your Credentials
        • Integration API ID
        • Account Secret ID
      • Push Events
        • Event Restrictions
        • Record Events
          • Record Added
          • Record Edited
          • Record Removed
        • Unit Events
          • Unit Panic
          • Unit Login
          • Unit Logoff
          • Unit Status Update
          • Unit Group Name Change
          • Unit Group Add
          • Unit Group Remove
        • Dispatch Events
          • New Dispatch
          • Modified Dispatch
          • Closed Dispatch
          • Dispatch Note
          • Attach Unit
          • Detach Unit
          • Toggle Bodycam
        • Event 911
        • Remove 911
        • Sign Updated
        • Tone Played
        • Civilian
          • Character Selected
        • ERS
          • New Callout
        • Station Alert
          • New Station Alert
      • API Endpoints
        • API Restrictions
        • Emergency
          • Identifiers
            • Get Identifiers
            • Modify Identifier
            • Set Identifier
            • Unit Panic
            • Kick Unit
            • Unit Status
            • Get Active Units
            • Update Unit Location
          • Dispatch and Emergency Calls
            • Get Calls
            • New Dispatch
            • Attach Unit
            • Detach Unit
            • Update Call Postal
            • Add Call Note
            • Update Call Primary
            • Close Dispatch
            • New 911 Call
            • Remove 911
          • Custom Blips
            • Get Map Blips
            • Add Blip
            • Modify Blip
            • Remove Blip
          • Street Signs
            • Set Street Sign Config
            • Update Street Sign
          • ERS
            • Set Available Callouts
          • Station Alert
            • Set Stations
        • Civilian
          • Set Character
          • Get Characters
          • New Character
          • Edit Character
          • Remove Character
          • DB Sync: Get Character Links
          • DB Sync: Link Character
        • General
          • Get Servers
          • Set Servers
          • Get Version
          • Set Penal Codes
          • Set API IDs
          • Custom Records
            • API Options for Adding and Modifying Records
            • Get Record Templates
            • New Record
            • Edit Record
            • Remove Record
          • Lookup By Value
          • Lookup Name or Plate
          • Get Account
          • Get Accounts
          • Check API ID
          • Apply Permission Key
          • Modify Account Permissions
          • Kick or Ban User
          • Verify Secret
          • Auth Street Signs
          • Set Postal Config
          • Set Clock Time
          • Send Photo
          • Leave Community
          • Join Community
        • Local Endpoints
          • Smart Lighting
        • Internal
          • FiveM Download
      • API Examples
        • Emergency
          • LUA Examples
            • Dispatch and Emergency Calls
              • New 911 Call
              • Remove 911
              • Add Call Note
              • Set Call Postal
            • Custom Blips
              • Add Blip
              • Add Blips
              • Add Temp Blip
              • Get Map Blips
              • Remove Blip
              • Remove Blip With Subtype
            • General
              • Lookup Name or Plate
          • JavaScript Examples
            • Dispatch and Emergency Calls
              • New 911 Call
              • Remove 911
              • Add Call Note
              • Set Call Postal
            • Custom Blips
              • Add Blip
              • Add Blips
              • Add Temp Blip
              • Get Map Blips
              • Remove Blip
              • Remove Blip With Subtype
            • General
              • Lookup Name or Plate
      • Development Branch
    • 💵Developer Bounties
    • 🌎Translation Support
  • Pricing
    • Pricing FAQ
      • Military and First Responder Discount
      • Expert Installation
      • Accessing the Payment Center
      • Create and Manage a Subscription
      • Request Discord Role
    • View and Compare Plans
  • Roadmap
    • 📋Changelog
  • Other
    • AI QA
    • Contact Us
    • Policy
      • Rocket CAD Closure
      • Terms of Service
      • Privacy Policy
      • Refund and Purchase Policy
      • Discord Bot
    • Archive
      • Fire Siren
Powered by GitBook
On this page
  • Showcase Video
  • Activation Guide
  • 1. Download and Install the Core
  • 2. Activate the Submodule and all Dependencies
  • 3. Configuration
  • 4. Custom Record Handling
  • 5. Set Your API ID
  • Usage
  • Sonoran wk_wars2x
  • Additional Features
  • Realistic Plate Scanning
  • Custom Alert Tones
  • Troubleshooting
  • AI Cars are Spamming the Reader
  • Vehicles Aren't Being Flagged
  • Error: attempt to index a nil value (local 'vehicle')

Was this helpful?

Edit on GitHub
  1. Integration Capabilities
  2. FiveM
  3. FiveM Installation
  4. FiveM Submodules

WraithV2

Implements the Wraith ARS 2X plate reader for automated plate reading.

PreviousVehRegNextFiveM Development Documentation

Last updated 5 months ago

Was this helpful?

This submodule utilizes API endpoints that require the Plus version of SonoranCAD or higher. For more information, view our page.

Looking for VPS, web, or dedicated hosting? Check out our official !

This submodule is for sending plate reads to other submodules.

Showcase Video

View our !

Activation Guide

1. Download and Install the Core

If you haven't already, be sure to install and configure the first.

2. Activate the Submodule and all Dependencies

Follow the for the required submodules.

  1. Ensure the third-party addon is installed.

3. Configuration

In the config_wraithv2.luafile, set isPluginEnabled in the to true.

Config Option

Description

useExpires

use vehicle registration expirations, or not

useMiddleInitial

use middle initials?

alertNoRegistration

alert if no registration was found on scan?

statusUid

Custom record field UID containing the status

expiresUid

Custom record field UID containing the expiration date

flagOnStatuses

List of statuses to flag/alert on

vehTypeFilter

List of Classes that will NOT get ran through CAD

notificationTimers

Time in MS, for how long each alert type will last via pNotify

4. Custom Record Handling

The in-game radar can alert you about expired registrations, BOLOs, warrants, and more:

Alert on Vehicle Status (Expired, Stolen, etc.)

When a vehicle is scanned by your radar, you can be notified if the vehicle registration status is inactive, expired, etc.

1. Get the Status field ID

In the custom record configuration panel, copy the field ID for your vehicle registration's status field. Typically this would be a dropdown (or "select") type field with options like "Active", "Pending", "Expired", etc.

2. Set the Field ID in your Config

Ensure the statusUid configuration value matches your status field ID from the custom record.

If your vehicle registration record has an expiration date value in it, be sure to set the expiresUid value to its field ID and set useExpires to true. This will display the registration expiration date in the notifications.

3. Set Status Flag Options

Customize the flagOnStatuses list to configure which vehicle registration statuses your radar will alter you on.

If the vehicle registration's status field (the record field ID that matches your statusUid) matches one of the flagOnStatuses values, your in-game radar will alert you.

Alert on BOLO or Warrant

When a vehicle is scanned by your radar, you can be notified of any active warrant or BOLO record with that license plate on it.

1. Ensure your Warrant or BOLO Record has a Status Field

In order for the radar to determine if the warrant or BOLO record is active, ensure your custom record has a status type field on it.

2. Ensure your Warrant or BOLO Record has a Plate Field

In order to match the vehicle plate with a record, ensure your custom record has a field with the field ID set to plate.

3. Receive In-Game Alerts

Your radar will alter you when a scanned vehicle matches:

  • A Warrant or BOLO record with the status type field of ACTIVE

  • A license plate matching the plate field ID of one of those active records

5. Set Your API ID

Usage

Sonoran wk_wars2x

Additional Features

  • Added the ability to blacklist certain vehicle classes via the config.lua, these blacklisted vehicles will show on the plate reader as the CONFIG.noPlateValue value (default: "NO PLATE").

  • Added the feature CONFIG.realisticPlateScanning. This feature is disabled by default due to certain vehicles having incorrect metadata causing this feature to display CONFIG.noPlateValue falsely. Behavior when enabled: when you are traveling toward/away from a vehicle that does not have a front/back plate the plate reader will not be able to scan it and will display the CONFIG.noPlateValue value.

  • Added custom sounds when a BOLO, Warrant or unregistered vehicle plate is scanned.

Realistic Plate Scanning

Set CONFIG.realisticPlateScanning to true to enable only scanning vehicles with the ALPR when they have a plate.

Note: Some vehicles may show a plate due to missing vehicle metadata or being able to remove the plate with extras.

Custom Alert Tones

Custom tones will now play when you scan a plate that is has either a BOLO, Warrant or is unregistered. These tones can be customized by replacing the existing files in the /sonorancad/submodules/wraithv2/sfx folder with your own. Please note the files names need to be the same as the ones you are replacing

Troubleshooting

AI Cars are Spamming the Reader

The framework ships with the wk_wars2x plate reader included. This will have the config.use_sonorancad set to true. When enabled, the plate reader will not run a lookup on any AI vehicle.

Vehicles Aren't Being Flagged

Status

Keep in mind that AI vehicles won't display or be ran unless there's a vehicle registration record added to the CAD with that plate.

Ensure that the flagOnStatuses array has the exact string/text values that match the options in your custom record template.

BOLO and Warrant

Ensure that your custom BOLO and Warrant records have a field with the type set to status. Otherwise, there's no way to determine if the BOLO/Warrant is active, closed, etc. The plate reader will warn of any active BOLO or Warrant records with the vehicle plate attached and the status type field set to active/open.

Error: attempt to index a nil value (local 'vehicle')

Some servers will see this error in their server console:

sv_wraithv2.lua:112 - attempt to index a nil value (local 'vehicle')

To fix this, navigate to your [sonorancad]/wk_wars2x folder, and rename config.dist.lua to just config.lua

Use of this submodule requires the Sonoran version of radar and plate reader to function. This resource is bundled with the latest SonoranCAD release as wk_wars2x.

You also need , a third party resource that is not bundled by default.

In order to have locked plate lookup results sent back to your CAD, don't forget to set your account .

For more information on using the in-game UI, please view the Sonoran version of the release information. Results are sent directly to your CAD when a license plate is locked.

These features are not found in the original wk_wars2x resource, and only come packaged with our version found .

Ensure that you've correctly followed and the statusUid and expirationUid fields have been set correctly, both in the CAD record template and the submodule config.

The config not being renamed is the most common cause of this error, however, if for some reason that doesn't fix it, feel free to open a with us.

🎮
Wraith ARS 2X
pNotify
API ID
Wraith ARS 2X
here
support ticket
pricing
server hosting
WraithV2 showcase video
SonoranCAD Core
pNotify
submodule activation guide
Wraith ARS 2X Controls
Sonoran wk_wars2x - Additional Config Options
Wraith - Use Sonoran CAD Config Option
step 5