# 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.

<div className="fd-steps [&_h3]:fd-step">
  ### Steps to Enable ACE Permissions [#steps-to-enable-ace-permissions]
  1. **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`:

     ```lua
     add_ace resource.illenium-appearance command.list_aces allow
     ```

  2. **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`:

     ```lua
     Config.EnableACEPermissions = true
     ```

  ### Example of Creating ACEs [#example-of-creating-aces]
  Once ACE permissions are enabled, you can create and assign ACE roles to players.

  #### Creating an ACE for VIP Players [#creating-an-ace-for-vip-players]
  1. **Create the ACE Role**  
     In your `server.cfg`, add the following line to create an ACE role called `vip`:

     ```lua
     add_ace group.vip vip allow
     ```

  2. **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:

     ```lua
     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 [#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:

  ```lua
  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 [#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.

```lua title="blacklist.lua"
  Config.Blacklist = {
      male = {
          components = {
              scarfAndChains = {
                  {
                      drawables = {5, 6, 7},
                      aces = {"vip"}  -- Accessible only to VIP players
                  }
              }
          }
      }
  }
  ```
</div>

<Callout type="info">
### Notes [#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.
</Callout>
