Roles
Roles, not ranks¶
v1 locked you into a fixed ladder of six ranks with limited permissions. v2 replaces them with named roles that you can create, reorder and edit freely so your structure can be whatever suits your game. Each role includes the commands its members can use, the permissions they hold, and the panel pages they can view or edit.
Info
The order of the roles list matters. A role's rank comes from its position rather than a fixed number, so dragging a role up the list makes it more senior.
The default roles¶
You start with six roles:
| Role | What it can do |
|---|---|
| Owner | Has every permission. The game creator receives it automatically |
| Dev | Can edit roles and game settings, and use global modifiers |
| Admin | Can use admin commands, cancel tasks, and use abusive modifiers like loop |
| Mod | Can use moderation commands and pages like Bans, Warns and Logs |
| Fun | Can use fun commands, ideal as a sellable perk |
| Player | Given to everyone, with minimal commands |
Giving people roles¶
There are three easy ways to give and take roles in-game:
-
Automatic 'givers'. See Link commands to roles below for more info.
-
Profile page. Type
;profile <user>, or in the panel go to MenuRolesServer or Permanent and click into a user (or add a new one). Add a role, then choose whether it applies permanently or just for the current server. -
Commands. For example:
;givePermRole @foreverhd mod
;giveServerRole @foreverhd mod
;takeRole @foreverhd
Link commands to roles¶
After applying tags and deciding what commands to load in-studio, or even after creating your own, you can now easily link commands to roles in-game. Simply open the settings of your desired role and scroll down to Role SettingsCommands. You can then customise your role to inherit commands three ways:
| Setting | What it grants |
|---|---|
| From Roles Below | The commands of every role ranked below this one |
| From Tags | Any command carrying one of the chosen tags, such as the pack tags from your loader (Admin, Fun, etc) |
| From Names | Individually chosen commands |
These stack, so a role holds the combined commands of all three. You can then click View Commands to see the full list of commands that role can use.
Permissions¶
Anyone with permission can view and change the settings of a role in-game, and edits save automatically and sync to every server within seconds:
| Permission | What it does |
|---|---|
| All command permissions | Grants every command permission below. Dangerous |
| Targeting Others | Run commands on other players, not just yourself (like ;jump @ForeverHD) |
| Multiple Targets | Target more than one player in a single run (like ;fly others) |
| Modifiers Abusive | Use potentially abusive modifiers like loop, spawn and delay |
| Modifiers Global | Use the cross-server modifiers global, perm and join. Extremely dangerous |
| Bypass Limits | Ignore rate, size and command-specific limits. Dangerous |
| From Roles Below | Use the commands of every role ranked below this one |
| From Tags | Use any command carrying one of the listed tags |
| Commands Per Minute | How many commands a member can run each minute |
| Requests Per Second | How many requests a member can send each second |
| Preview Roles | Preview and act as any role at or below this one |
| All view permissions | Grants every view permission |
| Icon | Whether the topbar icon shows, and which page it opens |
| Pages | Which panel pages the role can open |
| Unavailable Commands | Show commands the member can't use, buy or unlock |
| All edit permissions | Grants every edit permission. Dangerous |
| Edit Roles | Create, edit, delete and reorder roles below this one |
| Edit Tasks | Pause, resume and cancel any running task |
| Edit You Settings | Edit personal settings like theme, prefix and sound |
| Edit Game Settings | Make universe-wide setting changes. Dangerous |
| All Prompts | Show every notice to members |
| Warnings | Show warning notices like invalid command or missing permission |
| Welcome | Show the welcome notice on join |
Tip
Roles no longer have to inherit all commands below them, and you can customise permissions like 'can players of this role target other players'.
Previewing roles¶
Users with permission can preview other roles. This means they can act as any role at or below their own rank, to see exactly what a different role experiences. This is useful for example for testing what players can unlock after setting up gamepasses. Previewing never escalates anything. Safety checks always use your real roles, so previewing can't be used to slip past rank checks in either direction.
