For the complete documentation index, see llms.txt. This page is also available as Markdown.

Permissions

How to grant admin access to op-clothing features.

Every admin feature - the thumbnail generator, /clothingadmin, the shop editor, the job locker editor and custom ped management - shares one permission gate configured in config/MainConfig.lua under Config.Permissions.

The gate

Config.Permissions = {
    AcePermission = 'op_clothing.admin',            -- ACE permission object
    AllowedGroups = { 'admin', 'superadmin', 'god' }, -- framework groups
}

A player passes the gate when any of these is true:

  • They hold the AcePermission ACE, or

  • Their framework group is in AllowedGroups, or

  • The command is run from the server console.

ACE works on every framework and is independent of in-game jobs/groups. Add this to your server.cfg:

# allow a whole group
add_ace group.admin op_clothing.admin allow

# or allow a single identifier (license, steam, etc.)
add_principal identifier.license:xxxxxxxxxxxxxxxx group.admin

Option B - framework groups

If you'd rather gate by your framework's group/permission, leave AcePermission as-is and edit AllowedGroups to match your setup:

  • ESX - matches the player's group (admin, superadmin, ...).

  • QBCore / Qbox - matches the player's permission level (admin, god).

Custom ped permission (separate)

Granting players access to custom peds is intentionally a different, narrower permission so you can hand it out without full admin rights. It lives in config/CustomPeds.lua:

Holders of this ACE (or anyone who passes the main admin gate) can pick custom peds. Per-player grants are stored in the database and managed through these exports:

What each feature checks

Feature
Command
Gate

Clothing admin hub

/clothingadmin

Config.Permissions

Thumbnail generator

/op_clothing_thumbs

Config.Permissions

Shop editor

/clothingadmin shops

Config.Permissions

Job locker editor

/clothingadmin lockers

Config.Permissions

Custom peds

/charmenu

Config.Permissions or CustomPeds.AllowAce

Troubleshooting

  • "No access" in-game - confirm the ACE line is in server.cfg and the player is in the right group, then refresh / reconnect.

  • Works in console but not in-game - the console always passes; your in-game player is missing the ACE or group.

  • Changed the config but nothing changed - restart op-clothing so the new Config.Permissions is loaded.

Last updated