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
| Permission | Used by | What it unlocks |
|---|---|---|
| dh_restaurants.admin | Restaurants | /restaurantcreator, restock and owner commands |
| halo_backrooms.admin | Halo Backrooms | /hbcheck, /hbreset, /hbrestock |
| dh.vipcoins | House of Noir | /checkvipbalance |
| dh.admin | dh_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
statusin 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.