fxManager
FXServer Integration

Permissions

How permissions are managed in FXServer via fxManager.

The bitfield permissions in fxManager are syncronized in the game and made readily available to all server side scripts using fxServer's native ACE commands.


How to use the permissions

Two options are offered to check permissions:

  1. Using the native IS_PLAYER_ACE_ALLOWED
  2. Using the export from fxManager resource: exports.fxmanager:hasPermission(source, permission)
    • source: string | number
    • permission: string

Code example:

-- using the export
local hasPermission = exports.fxmanager:hasPermission(source, "players.kick")

-- using the native
local hasPermission = IsPlayerAceAllowed(source, "fxmanager.players.kick")

Permission values

Master Override

Users with the MASTER permission bypass this list entirely. They are granted a universal fxmanager root ACE, giving them implicit access to every node listed below.

Using the export

If using the native, remember you need to prefix the acepermission with fxmanager. !


Moderation

Permissions related to active player management and policy enforcement.

PermissionFunctionality
players.kickDisconnect players from the server.
players.banPrevent players from reconnecting.
players.warnIssue formal warnings to users.
players.revoke_kickClear kick history for players.
players.revoke_banUnban players from the server.
players.revoke_warnRemove warnings from player profiles.

Access Control

Permissions regulating server whitelist registration and entry authorization.

PermissionFunctionality
players.whitelistGrant whitelist access to players.
players.revoke_whitelistStrip whitelist access from players.

Reporting

Permissions mapping directly to the player-to-staff communication ticket flow.

PermissionFunctionality
reports.viewRead incoming player reports.
reports.replySend messages within report threads.
reports.closeMark reports as closed or resolved.

System Controls

Permissions facilitating immediate interaction with the underlying FXServer environment and command stream.

PermissionFunctionality
control.serverStart, stop, or restart the server instance.
console.viewRead-only access to live server stdout logs.
console.writeRun raw commands directly via the server console input.

Administration

Permissions regarding structural layout changes, file access, and staff hierarchy tracking.

PermissionFunctionality
system.audit_logView historical logs of staff actions and system triggers.
system.performanceView live server runtime resource metrics and performance snapshots.
commands.resourcesStart, stop, and restart specific game resources.
settings.writeModify global web panel and API properties.
server.cfg_editorLive file modification of server.cfg and nested includes.
manage.adminsCreate, update roles, or delete dashboard administrators.

On this page