Clothing & Hair

The illenium-appearance resource provides functionality for blacklisting specific clothing items and hairstyles based on certain criteria. This feature allows you to restrict certain items based on:

• Jobs
• Gangs
• ACEs (Access Control Entries)
• CitizenIDs (Player Identifiers)

How It Works

To blacklist specific items, you need to modify the configuration in the shared/blacklist.lua file. This file contains a list of component names and drawable IDs that you can blacklist for male and female players.

By using the following format, you can restrict specific clothes or hairstyles based on certain conditions.

Example Use Case

For example, if you wanted to blacklist the following items:

• Jackets:
  • 10, 12, 13, 18 (All Textures)
  • 11 (Textures: 1, 2, 3)
  • 25, 30, 35 (Accessible only to "police" job)
• Masks:
  • 10, 11, 12, 13 (All Textures)
  • 14 (Textures: 5, 7, 10, 12, 13)
• Hats:
  • 41, 42, 45 (Accessible only to the "ballas" gang)
• Scarfs & Chains:
  • 5, 6, 7 (Accessible only to "vip" ACE)
• Shirts:
  • 16 (Accessible only to CitizenID "ZUM10723")
• Hair:
  • 15 (All Textures)

Configuration Example

Config.Blacklist = {
    male = {
        hair = {
            {
                drawables = {15} -- All textures of hair ID 15 are blacklisted
            }
        },
        components = {
            masks = {
                {
                    drawables = {10, 11, 12, 13} -- Blacklist masks with drawables 10, 11, 12, 13
                },
                {
                    drawables = {14},
                    textures = {5, 7, 10, 11, 12, 13} -- Blacklist mask 14 with specific textures
                }
            },
            upperBody = {},
            lowerBody = {},
            bags = {},
            shoes = {},
            scarfAndChains = {
                {
                    drawables = {5, 6, 7},
                    aces = {"vip"} -- Only available to players with the "vip" ACE
                }
            },
            shirts = {
                {
                    drawables = {16},
                    citizenids = {"ZUM10723"} -- Only accessible to player with CitizenID "ZUM10723"
                }
            },
            bodyArmor = {},
            decals = {},
            jackets = {
                {
                    drawables = {11},
                    textures = {1, 2, 3} -- Only textures 1, 2, and 3 for jacket 11 are blacklisted
                },
                {
                    drawables = {10, 12, 13, 18} -- Blacklist these jackets for all players
                },
                {
                    drawables = {25, 30, 35},
                    jobs = {"police"} -- Accessible only to players with the "police" job
                }
            }
        },
        props = {
            hats = {
                {
                    drawables = {41, 42, 45},
                    gangs = {"ballas"} -- Only accessible to the "ballas" gang
                }
            },
            glasses = {},
            ear = {},
            watches = {},
            bracelets = {}
        }
    },
    female = {
        components = {
            masks = {},
            upperBody = {},
            lowerBody = {},
            bags = {},
            shoes = {},
            scarfAndChains = {},
            shirts = {},
            bodyArmor = {},
            decals = {},
            jackets = {}
        },
        props = {
            hats = {},
            glasses = {},
            ear = {},
            watches = {},
            bracelets = {}
        }
    }
}

Config Breakdown

Male / Female

The blacklist configuration can be applied separately to male and female players. Ensure you modify the right section of the config for the desired player model.

Components

You can blacklist clothing components like jackets, masks, and shirts using drawables and textures. These are specified by their component IDs.

• drawables: The drawable ID of the item.
• textures: Specific texture IDs for items that have multiple textures (e.g., jackets).
• jobs: Restrict items to specific jobs (e.g., police).
• gangs: Restrict items to specific gangs (e.g., ballas).
• aces: Restrict items to users with a specific ACE (e.g., vip).
• citizenids: Restrict items to players with a specific CitizenID (e.g., ZUM10723).

Props

This section handles items like hats, glasses, and accessories. The logic is the same as with clothing components, where you can use drawables and restrict based on gangs, ACEs, or jobs.

Customizing the Blacklist

You can easily modify the blacklist to suit your server's needs:

1. Add new restrictions by including the desired components (e.g., jackets, masks) and specifying which drawables or textures you want to blacklist.
2. Assign roles: Use the jobs, gangs, aces, and citizenids tables to ensure specific clothes are accessible only to players with the appropriate role or ID.
3. Separate male and female configurations: If you want different blacklisting rules for male and female players, ensure the configuration is placed under the respective sections (male or female).