Blacklisting

Before you can apply ACE-based restrictions in the illenium-appearance blacklist configuration, you must first enable ACE permissions on your server. Follow the steps below to set up ACE permissions properly.

Steps to Enable ACE Permissions

Add the ACE Command to server.cfg
To allow the server to recognize ACE permissions, you need to add the following line to your server.cfg:
```
add_ace resource.illenium-appearance command.list_aces allow
```
Enable ACE Permissions in shared/config.lua
Next, you need to enable ACE permissions in the shared/config.lua configuration file. Locate the Config.EnableACEPermissions setting and set it to true:
```
Config.EnableACEPermissions = true
```

Example of Creating ACEs

Once ACE permissions are enabled, you can create and assign ACE roles to players.

Creating an ACE for VIP Players

Create the ACE Role
In your server.cfg, add the following line to create an ACE role called vip:
```
add_ace group.vip vip allow
```
Assign Players to the VIP Role
To assign a specific player to the VIP role, use the add_principal command, specifying their unique license identifier. For example:
```
add_principal identifier.license:xxxxxxxxxxxxxxxxxx group.vip
```
Replace xxxxxxxxxxxxxxxxxx with the actual license of the player. You need to add the above add_principal line for each player you wish to assign the VIP role to.

Example for Multiple Players

If you want to assign the vip role to multiple players, just repeat the add_principal line with each player's unique license. For example:

add_principal identifier.license:abc123 group.vip
add_principal identifier.license:def456 group.vip
add_principal identifier.license:ghi789 group.vip

This assigns the vip ACE to the players with those specific license identifiers.

Final Steps

Once you have enabled ACE permissions and created the necessary roles, you can use the ACE-based restrictions in the illenium-appearance blacklist configuration.

For example, you can blacklist certain clothing or ped models to only be accessible by players with the vip ACE by using the aces key in the blacklist configuration.

blacklist.lua

  Config.Blacklist = {
      male = {
          components = {
              scarfAndChains = {
                  {
                      drawables = {5, 6, 7},
                      aces = {"vip"}  -- Accessible only to VIP players
                  }
              }
          }
      }
  }

Notes

Ensure that ACE permissions are properly set up before trying to use them in the blacklist configuration.
If you have multiple ACE roles, you can assign them to players in the same way and use them to apply more granular access control.