Links
Comment on page

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

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. 1.
    Click HERE to download the unit status plugin .zip file.

3. Install the Plugin

  1. 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
]]
Last modified 2mo ago