DXRP-CAD Documentation

Beginner setup

Set up Dex Roleplay Bot for a new community.

Follow these steps in order. 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

Use the official invite link and 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. Use department features to decide who can view calls, use lookup, manage reports, handle warrants, or open medical tools.

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. 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 staff member go on duty, create a test 911 call, create a Twitter account with /create-twitter, post a test /tweet, run a lookup command, and verify the same data appears correctly inside the website CAD.