AwareCAD
Sign in →

Roblox groups & auto-enroll

Map a Roblox group rank to an AwareCAD rank.

Link a Roblox group to AwareCAD so a player's group rank automatically becomes their AwareCAD rank. When you promote someone in your Roblox group, their AwareCAD role updates the next time they sign in — no invite token, no manual assignment.

Set up the Roblox API credential

AwareCAD uses Roblox's Open Cloud to read group rosters. You'll need an Open Cloud API key with the group:read scope and the group(s) you want to bind.

Admin → Roblox groups → Credential. A scope-warning callout flags that the Open Cloud key grants both read and write on group memberships, with a link out to the Roblox Creator Hub credentials page. Below the warning, two fields: API key (stored server-side, never returned to the browser) and a test Roblox group ID used to validate the key.
Admin → Roblox groups → Credential. Paste the Open Cloud key once; AwareCAD stores only a SHA-256 hash server-side.
  1. On the Roblox creator dashboard, go to Credentials → API Keys.
  2. Create a key. Add the group API system, grant the group:read scope, and add your group(s) to the resource list.
  3. Copy the API key. In AwareCAD, open admin.awarecad.com/integrations → Roblox tab → Set API key and paste it.

Bind a Roblox group to AwareCAD

  1. Click Add binding. Paste the group's Roblox ID (the number in the URL of the group page).
  2. Pick the default department for this group, the default role (officer / dispatcher / civilian), and an optional default rank. These apply when a member's Roblox group rank doesn't match a more specific row in the rank map.
  3. Click into the binding to see the rank map grid. Each Roblox rank (numbered 0–255 by Roblox) can map to a specific AwareCAD role, department, and rank — that's how a Lieutenant in your Roblox group becomes a Lieutenant in AwareCAD, but a Recruit stays a Recruit.

What happens when a user signs in

On every AwareCAD sign-in, the auto-enroll service:

  1. Reads the user's Roblox group memberships via Open Cloud.
  2. For each binding the user is in, resolves the rank → AwareCAD role/dept/rank.
  3. Upserts their community_member row.
  4. Removes them from communities they've left on the Roblox side.

Mappings are additive — if a user is in multiple bindings across multiple communities, they end up as a member of each one.

Gotchas

  • Roblox API rate limits. If you have a large group (thousands of members), the first sync is slow. Subsequent syncs only re-read deltas via the Group Roles API.
  • Group visibility. Your group has to be either public, or the API key has to have explicit access to it. Private groups without API access show "binding paused" in the UI.
  • Civilian role gotcha. If a member's effective mapped role is civilian, they can't fire ;commands from ER:LC — those require officer+ role. This is intentional; civilians shouldn't be able to open traffic stops.

Last updated May 19, 2026.