Docs · mod build 5.7

Roles and permissions

Ranks, per-person permissions, and who can change what.

Ranks

There are three ranks: owner, admin and moderator. A rank only decides who can manage whom. What someone can actually do comes from their own permissions, so two admins can be allowed completely different things.

The rules for changing staff are simple:

You can only add, change or remove people ranked below you.
You can't give anyone a permission you don't have yourself.
Owners can only be added or removed in admins.json on the server. Nobody can make or remove an owner from inside the game.

So an owner manages admins and moderators, an admin manages moderators, and a moderator manages nobody. Managing staff also needs the Manage lower ranked staff permission.

Starting permissions

When you give someone a rank, they start with that rank's usual set. You can then switch any of them on or off for that person on the Admin Permissions tab.

Rank	Starts with
Moderator	Dashboard, online players, heal/revive, teleport, spectate and markers, warn and mute, kick, the killfeed, teleporting on the map
Admin	Everything a moderator has, plus IDs, self toggles, kill/respawn, inventory, vehicles, faction and rank, ban, give Game Master, notifications, monitoring, managing moderators, server messages, welcome screen, god mode and invisible on others, player and vehicle map markers, ESP, no spray and no recoil on others, the Asset Spawner and bypassing its budget, the Environment tab
Owner	Everything

A few permissions are owner only to start with: system settings, logging, panel settings, maintenance, and linking the server to Reforgedmin. An owner can still hand them to anyone below.

Every permission

These are the keys used in admins.json. Each one is true or false.

Key	What it allows
`view_dashboard`	See the dashboard
`view_players`	See the online players list
`view_identities`	See other players' GUIDs and Steam IDs
`self_actions`	God mode, invisible and the other toggles on yourself
`player_care`	Heal, revive, unstick
`player_punish`	Kill, force respawn
`teleport`	Teleport and freeze
`inventory`	Change inventories
`vehicles`	Vehicle actions, including refilling vehicle ammo
`faction_rank`	Faction and rank
`spectate`	Spectate players through Game Master
`warn_mute`	Warn and mute
`kick`	Kick
`ban`	Ban
`give_gm`	Give Game Master
`edit_notifications`	Change Discord notifications
`edit_monitoring`	Change player monitoring
`manage_staff`	Manage lower ranked staff
`edit_system`	Change system settings
`edit_logging`	Logging settings and reading the admin log
`edit_panel`	Panel settings
`run_maintenance`	Reload configs, backups
`edit_server_messages`	Server messages and broadcasts
`edit_welcome_screen`	Welcome screen
`link_server`	Link the server to Reforgedmin
`god_mode_others`	God mode on other players
`invisible_others`	Invisible on other players
`view_player_locations`	See every player on your map
`view_vehicle_locations`	See every vehicle on your map
`view_esp`	See players and AI through walls (ESP), and track a player on it
`weapon_tweaks_others`	No spray and no recoil on other players
`spawn_assets`	The Asset Spawner, which lends Game Master to place things
`view_killfeed`	See the Killfeed tab
`bypass_budget`	Tick "Bypass budget?" on the Asset Spawner, so Game Master's budget doesn't stop them placing
`edit_environment`	The Environment tab: time, weather, rain, fog and wind
`teleport_map`	Teleport on the Operator tab: open the map and click where to go

Tabs and buttons you don't have permission for aren't drawn at all. That's only cosmetic, though. The server checks the permission again for every single action.

Changes apply straight away

When someone's rank or permissions change, whether from the panel or by editing the file and reloading, everyone online is re-checked on the spot. A removed admin loses the panel without having to rejoin.

Vanilla admins

By default, being logged in with #login or listed as an admin in the server config gives you nothing here. The staff list is meant to be the only way in. If you'd rather have vanilla admins treated as admins, set this in admins.json:

"allowVanillaAdmins": true