DXRP-CAD Documentation

Beginner setup

Set up Dex Roleplay Bot for a new community.

Run /info help in Discord for a quick start, or follow the complete steps below. You do not need to code anything, but you should have Discord server management access and owner or staff access in the Dex CAD website.

01

Invite the bot

Run /info invite-bot for the official invite link. Keep the applications.commands scope enabled so slash commands appear in your Discord server.

02

Confirm Discord permissions

Make sure the bot can view channels, send messages, use slash commands, embed links, manage messages for sticky messages, and manage roles if you enable auto-role features. If you enable Discord Duty Nickname Sync, also grant Manage Nicknames and keep the bot role above the members whose nicknames it should update.

03

Run /setup

Open the setup panel in Discord and configure staff, bot admin, LEO, DMV, civilian, Fire/EMS, Tow, 911, CAD log, Twitter, and roleplay action channels. Once an LEO role is configured, police commands and law-enforcement roleplay actions require that role or staff permission. If no LEO role is configured, those commands remain open to everyone.

04

Create or open your CAD community

Log in to Dex CAD, create a community, and add your departments. Every Dispatch preset receives the complete Dispatch workspace automatically: call creation, assignment and clearing, unit status controls, read-only medical records, and full BOLO management. For a custom or renamed communications department, enable Dispatch Workspace in Department Rules to apply the same operational access.

05

Choose registry approval mode

Open Community Settings > Modules. Staff Vehicle Approvals and Staff Firearm Approvals are off by default, which means website firearm registrations and linked Discord or website vehicle registrations are approved immediately and appear on civilian records. Turn them on if staff should approve or deny submissions first.

06

Link Discord to CAD

In community settings, create a Discord link code. Run /community-link with that code in your Discord server so bot commands and website records share the same community data.

07

Set up departments

Use the website department editor or /add-department to create Dispatch, Police, Fire, EMS, Tow, Civilian, or custom departments with the right feature access. On the website, Dispatch Workspace is available for any custom department. In /add-department, including calls.manage gives a custom department the same workspace and required permissions. Callsigns are limited to five characters.

08

Optional: enable Discord Duty Nickname Sync

By default, the bot does not change member nicknames. Community owners and admins can enable Discord Duty Nickname Sync from Community Settings > Modules. When enabled, going on duty sets the nickname to Civilian Name | Department or Sub-Department | Callsign. The nickname never exceeds Discord's 32-character limit; the civilian name is shortened first, while the department and callsign remain visible.

09

Configure channels

Choose where 911 calls, CAD logs, server startup notices, sticky messages, Twitter posts, and roleplay action messages should post. Staff can also set the Twitter channel directly with /twitter-channel. Test each workflow from a private staff channel first.

10

Test member flow

Have one dispatcher and two fake or real units go on duty. Create Low, Medium, and High test incidents, build a grouped callsign, assign primary and backup units, change their statuses, and verify the same priority and assignment data appears in CAD logs and Discord sync.