Staff & Ranks

Staff access is stored in the database, not in config files. Every staff member belongs to one rank (called a tier in the console command), and the rank decides what they can do. Everything is checked server-side: the panel only hides what a staff member can’t use.

Manage both on the Staff page of the panel. You need the Manage Staff permission (roles.manage) to open it.

Default ranks#

On first start the resource creates four ranks. You can edit, rename or delete them like any other rank.

Ranks#

A rank can only be deleted when nobody is in it.

Discord role sync#

When a rank has a Discord Role ID and the role sync is set up in Settings → Discord (it needs the bablo_admin_discord_token convar, see Installation), players with that Discord role get the rank when they join, and lose it when the role is gone. Changing a synced member’s rank by hand stops syncing that member. See Discord role sync.

Staff members#

A staff member is a display name, a rank and one or more identifiers: license2, discord, steam, fivem. A license2 or a discord identifier is required. When you add a member you can type a name or pick an online player, which fills the identifiers for you.

When a staff member joins, any identifiers missing from their record (Discord, Steam, FiveM) are filled in automatically. A member is matched in this order: license2, fivem, discord, steam.

An identifier can only belong to one staff member.

Hierarchy rules#

Permissions alone aren’t enough, rank matters too:

• You can only edit or delete ranks below your own hierarchy, and only edit, move or remove members whose rank is below yours. Staff with full access (*) can also act on their own level.
• You can only move members into ranks below your own, and you can’t give a rank a hierarchy above your own.
• You can only turn on or off permissions you have yourself. Only full-access staff can give or take full access, or change a rank’s ACE rules.
• You can’t change your own rank or remove yourself.
• The last member of a full-access rank can’t be removed or moved out of it.
• Kicks, bans, jails, troll actions, inventory and vehicle actions and screenshots on another staff member need a higher hierarchy than theirs.

Permission keys#

Quick menu tools that change something for others still need their own permission. For example spawning a vehicle needs Manage Vehicles and Blackout needs World Control.

Some things need no permission: opening the panel, the dashboard, browsing players, vehicles and items, staff notes on players, messaging a player and answering reports.

Full access#

A rank with * has every permission, including ones added in future updates. The default Owner rank has it.

Web Panel and Discord Bot#

These two decide where a staff member can use the panel outside the game:

• Web Panel (web.access) lets the member sign in to the web panel with Discord. See Give your staff web access.
• Discord Bot (discord.access) lets the member use the Discord bot.

Both need a Discord identifier on the member’s record, since that is how they are recognised. What they can do there still follows their rank’s other permissions. Owners from Config.Owners with a discord: identifier always get both.

Creating the first owner#

On a fresh install nobody is staff. The console says so on every start and lists the ways in. Any one of these makes you an owner:

ACE mirroring#

Each rank can give its online members ACEs and commands, so other resources that check ACEs (for example /car or /tpm) follow your staff ranks. Fill them in under Advanced ACE rules in the rank editor:

* in Allowed Commands allows every command. Online members are added to their rank’s principal (add_principal player.<id> bablo-admin.tier.<rank id>) and removed when they leave, change rank or the resource stops.

For this to work the resource must be allowed to change ACEs. Add these lines to server.cfg:

add_ace resource.bablo-admin command.add_ace allow
add_ace resource.bablo-admin command.remove_ace allow
add_ace resource.bablo-admin command.add_principal allow
add_ace resource.bablo-admin command.remove_principal allow

Without them, the console prints these lines once when a rank has ACE rules, and nothing is applied.

Staff tags#

A staff tag is a name tag above a staff member’s head that every player within Config.QuickMenu.StaffTagRange (30 m by default) can see.

• The rank decides whether its members can show one (Gamer Tag) and in which colour.
• Each staff member turns their tag on for the session from the quick menu, or always from Settings → Name tags → Show my staff tag.
• The tag text is the same for every staff member and is set in Settings → Name tags → Staff tag by staff with Manage Staff. The default is {group} [{svid}] {name}.

Empty [] brackets are removed when a token has no value.