Cobalt Essentials Permissions

Cobalt Essentials uses a role-based permissions system. Every player is assigned a role that determines which commands they can run and what they can do on the server.

Default Roles

Role	Description
`owner`	Full access to all commands and settings. Typically just the server owner.
`admin`	Can kick, ban, manage permissions, and use most CE features.
`moderator`	Can kick, freeze, teleport, and use basic player management tools.
`whitelisted`	Trusted players with no special permissions - bypasses whitelist if enabled.
`guest`	Default role for all connecting players.

Editing Permissions

Roles and their assigned players are stored in CobaltDB/permissions.json.

DirectoryResources/
- DirectoryServer/
  - DirectoryCobaltEssentials/
    DirectoryCobaltDB/
    permissions.json
    config.json

Adding a Player to a Role

In your Vyper Hosting panel, go to Files → Resources → Server → CobaltEssentials → CobaltDB.
Open permissions.json.

Add the player’s BeamMP username (exact spelling, case-sensitive) to the appropriate array:

{
  "owner": ["YourUsername"],
  "admin": ["TrustedAdmin1", "TrustedAdmin2"],
  "moderator": ["Mod1"],
  "whitelisted": [],
  "blacklisted": []
}

Save the file and restart the server.

Assigning Roles In-Game

If you’re already connected with the owner role, assign roles via chat without editing the file:

/setrank PlayerName admin
/setrank PlayerName moderator
/setrank PlayerName whitelisted

Changes made in-game are saved to CobaltDB/permissions.json automatically.

Whitelist Mode

To restrict your server to whitelisted players only:

Open CobaltDB/config.json in the Files tab.
Set "whitelistActive": true.
Restart the server.

With whitelist mode active, only players in the owner, admin, moderator, or whitelisted arrays can join. All others are kicked with a message.

Add players to the whitelist:

Edit CobaltDB/permissions.json and add their username to "whitelisted".
Or use /whitelist PlayerName in-game.

Blacklisting Players

Add a player’s username to the "blacklisted" array to permanently ban them:

{
  "blacklisted": ["ToxicPlayer"]
}

Restart the server after editing.

Customising What Each Role Can Do

CE allows fine-grained command permission editing in CobaltDB/config.json. Each command entry includes a minRank field:

{
  "commands": {
    "kick": { "minRank": "moderator" },
    "ban": { "minRank": "admin" },
    "setrank": { "minRank": "owner" }
  }
}

Change minRank to any role name to adjust who can run each command.