Discord Store
General

Permissions

Some Dirty Halo scripts use FiveM's ACE permission system to lock admin commands. This page explains how ACE works and lists every permission our scripts use.

How ACE permissions work

ACE (Access Control Entries) is FiveM's built-in permission system. You grant a named permission to a group, then put players in that group. Scripts check whether a player has a permission before allowing an action.

The two lines you'll use most:

server.cfg
# Give a group access to a permission
add_ace       group.admin  some.permission  allow

# Add a player to that group by their identifier
add_principal identifier.steam:110000xxxxxxxx  group.admin

Dirty Halo permission names

PermissionUsed byWhat it unlocks
dh_restaurants.adminRestaurants/restaurantcreator, restock and owner commands
halo_backrooms.adminHalo Backrooms/hbcheck, /hbreset, /hbrestock
dh.vipcoinsHouse of Noir/checkvipbalance
dh.admindh_bridge (Restaurants, Backrooms)Counts as an admin in any script that asks dh_bridge
Some scripts use your framework's admin group instead of ACE — Admin Tools (ESX group / QBCore permission admin) and Starter's guidebook (Config.GuideBook.AdminPermissions).

Recommended setup

Grant the permissions to a group, then add your admins to that group. That way each admin only needs one line.

server.cfg — recommended setup
# Grant Dirty Halo permissions to your admin group
add_ace group.admin dh.admin              allow
add_ace group.admin dh_restaurants.admin  allow
add_ace group.admin halo_backrooms.admin  allow
add_ace group.admin dh.vipcoins           allow

# Add your admins
add_principal identifier.steam:110000xxxxxxxx group.admin
add_principal identifier.steam:110000yyyyyyyy group.admin
If you already have a group.admin for txAdmin or another resource, just add the add_ace lines to it.

Finding your identifier

  • Run status in the txAdmin console while connected — it lists every player's identifiers
  • Use a site like steamidfinder.com for your Steam64 ID, then convert it to hex with a steam: prefix
  • Or use your license: identifier instead: add_principal identifier.license:xxxx group.admin

Troubleshooting

Command says "no permission" — Check the identifier in server.cfg matches exactly, then do a full restart — server.cfg changes don't apply to a running server.
Works in console but not in game — The server console always has full permissions. In game, ACE is checked, so your add_principal line must use your real identifier.
Using txAdmin? — txAdmin has its own permissions alongside ACE. Being a txAdmin admin doesn't give you ACE permissions — you still need the add_principal line.