Unit Status

Allows you to change a unit's status in the CAD.

This plugin utilizes API endpoints that require the standard version of Sonoran CAD or higher. For more information, view our pricing page.

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

Installation Video

Click to view our unit status installation video.

Be sure you have already installed our plugin framework!

Installation Guide

1. Download and Install the Framework

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

2. Download the Plugin

1. Click HERE to download the unit status plugin .zip file.

3. Install the Plugin

1. Follow the standard plugin installation guide for the unit status plugin.

4. Set Your API ID

Don't forget to set your account API ID to properly link your in-game user to the CAD.

5. Setup User Permissions

This script provides a status set command by default. Players will need the command.setstatus ACE permission (or whatever you configure the command to be).

Example

add_ace builtin.everyone command.setstatus allow

This line in your config.cfg file will allow everyone to access the command. We highly reccomend creating proper ace permission groups to prevent users from spamming.

Configuration

Option	Description	Default
setStatusCommand	Command that will allow units to set their own status.	setstatus
statusCodes	Array of status codes, configurable to be community-specific	Default SonoranCAD setup

Usage

Commands

Command	Description
setstatus <STATUS>	Update your unit status in the CAD. Ex: setstatus AVAILABLE

Function

This is a server-side function only and is exported as cadSetUnitStatus. Use setUnitStatus if using with other plugins.

cadSetUnitStatus(<apiId>, <status>, [player])

• apiId: The identifier attached to the unit

• status: A status, can be the actual string or a number, based on configuration

• player (optional): server ID of the player, used to send a client event

Event

--[[
    Event Name: SonoranCAD::unitstatus:UpdateStatus
    Arguments:
        statusText: Text or number of the status to set
]]