Org Admin Guide
Org Admin Guide
This guide walks you through everything needed to set up RoPerms for your Roblox experience — from creating an org and configuring departments to installing the Luau SDK and enabling every feature.
ℹWho this guide is for
This guide is for Roblox game developers or community owners who want to integrate RoPerms into their game. If you are a staff member using the dashboard, see the Staff Guide instead.
What does RoPerms provide?#
RoPerms is a back-end infrastructure layer for Roblox communities. Once integrated, your game can:
- Check and grant named permissions to players (e.g., vip, admin, whitelist).
- Enforce bans, kicks, chat bans, and tool bans in real time.
- Allow players to submit modcalls (in-game help requests) that appear in the dashboard.
- Log chat messages, track player activity sessions, and capture server replays.
- Accept Robux payments via Developer Products and mark them from inside the game.
- Submit and manage orders for services or products.
- Promote/demote players in your Roblox group automatically on session pass.
Your staff team manages everything from the RoPerms web dashboard — no Roblox Studio access required for day-to-day operations.
Key concepts#
- Organisation (org) — your tenant in RoPerms. All settings, staff, permissions, and data belong to one org.
- Place claim — you must register each Roblox Place ID that will use the SDK. The SDK key is tied to your claimed places.
- API key — a secret token your in-game scripts include in every SDK request for authentication.
- Department — a named bundle of capabilities assigned to staff members. Use departments to control which staff can do what.
- Capability — a granular permission key (e.g., users.ban,sessions.host) that gates specific dashboard actions.
What's in this guide#
- Setup & API Keys — create your org, claim places, get your API key, configure departments.
- SDK Installation — download the Lua files and add them to your game.
- Permissions & Moderation SDK Reference — every function in RoPerms.lua for permissions and bans.
- Modcalls & Enforcement — enable the modcall command and automatic ban enforcement.
- Activity & Replay — track play sessions, log chat, and capture server replays.
- Payments — accept Robux payments via Developer Products.
- Orders — in-game order submission and fulfilment tracking.
- Ranking Integration — auto-promote players in your Roblox group.
- Troubleshooting — common errors and how to fix them.