Skip to content

Permission reference

Every privileged action in BeamJoy is gated on one of 34 named keys. This page is all of them, in the order the mod itself lists them, with the group that holds each by default.

A player in the default group or any group above it may take the action. An owner can move any key to any group from Config → Permissions — see Groups and permissions for how the hierarchy works and Players and moderation for the rank rule that applies on top of these.

Key Default What it gates
SendPrivateMessage default Nothing — see below. /pm is open to everyone.
TeleportTo player Teleporting yourself to another player. Rate-limited, and refused mid-race.
VoteMap player Starting a map vote. Joining or cancelling one is ungated.
VoteKick player Starting a kick vote. Joining or cancelling one is ungated.
Key Default What it gates
SpawnTrailers vip Spawning trailers from the vehicle selector.
Key Default What it gates
SpawnProps mod Spawning the game’s prop objects from the vehicle selector.
BypassModelBlacklist mod Spawning a model the server has blacklisted.
TeleportFrom mod Summoning another player to you.
DeleteVehicle mod Nothing — see below. Removing a car needs only that you are staff.
Kick mod Kicking a player, in game or with /kick.
Mute mod Muting and unmuting.
TempBan mod Banning for a set time.
FreezePlayers mod The /freeze command. The player-list button needs only staff.
EnginePlayers mod The /engine command. Same caveat.
SetGroup mod Promoting and demoting, and /setgroup.
Whitelist mod The whitelist section of Config → General, and the whitelist itself.
SwitchMap mod Switching the map outright with /map, without a vote.
EditRaces mod The Races tab: the race editor, and saving or deleting a race.
EditSafeZones mod The Safe Zones tab.
EditVehiclePresets mod The Vehicle Presets tab, and shared builds.
EditHunterArenas mod Hunter arenas in the Arenas tab.
EditInfectedArenas mod Infected arenas in the Arenas tab.
EditDerbyArenas mod Derby arenas in the Arenas tab.
EditFreeroamData mod The Freeroam tab: stations and garages, deliveries, drift spots, dragstrips.
EditBusLines mod Bus lines, in that same tab.
Key Default What it gates
SetConfig admin Almost all of Config → General: freeroam rules, deliveries, pits, voting, Discord, the welcome screen, chat, the vehicle blacklist, traffic, broadcasts and the race-editor restrictions.
SetEnvironment admin Time, weather and gravity, and pausing or slowing the simulation.
SetMaps admin The Maps tab: which maps exist and what they are called.
Ban admin Banning permanently, and unbanning.
DatabasePlayers admin The Database tab: players who are not connected.
EditPluginConfig admin Config tabs added by server plugins.
Key Default What it gates
SetPermissions owner The Permissions tab — the groups themselves, and which group holds every key on this page.
SetCore owner The Core Config tab, Legacy Import, and /bjupdate.
SetCEN owner Nothing — see below.

Three of the 34 are declared and given a default group, and then nothing in the mod ever asks for them. They appear in the Permissions tab and moving them has no effect:

Key What actually governs it
SendPrivateMessage Nothing. /pm is available to every player, guests included.
DeleteVehicle Being staff. Remove, Explode and Launch in the player list check the staff flag on your group and no permission.
SetCEN SetConfig, like every other config value.

This is recorded here because the Permissions tab shows all three, and a server owner tightening DeleteVehicle would otherwise believe they had changed something.

  • A permission is not the whole check. Moderation also requires that you are staff and that your group outranks the target’s. See the rank rule.
  • The console has no permissions at all. bj commands bypass this entire page.
  • Three keys open a config tab between them that can hand over the server: SetPermissions, SetCore and SetGroup. Everything else an owner can undo.
  • The defaults above are what BeamJoy ships; your server’s live values are in permissions.json — see where your data lives.