Blacklists

Restrict specific clothing items, props, or ped models to certain players based on jobs, gangs, CitizenIDs, or ACE permissions.

Component & Prop Blacklists

Blacklists are defined in shared/blacklist.lua per gender. Items in the blacklist are hidden from all players except those who match the filter criteria.


Config.Blacklist = {
    male = {
        components = {
            masks = {
                {
                    drawables = { 1, 2, 3 },
                    jobs = { "police", "ambulance" },
                },
                {
                    drawables = { 10 },
                    textures = { 0, 1, 2 },  -- Only block specific textures
                    gangs = { "vagos" },
                },
                {
                    drawables = { 50 },
                    citizenids = { "ABC12345" },
                },
                {
                    drawables = { 100 },
                    aces = { "vip.clothing" },
                },
            },
            -- upperBody, lowerBody, bags, shoes, scarfAndChains,
            -- bodyArmor, shirts, decals, jackets
        },
        props = {
            hats = {},
            glasses = {},
            ear = {},
            watches = {},
            bracelets = {},
        },
        hair = {},
    },
    female = {
        -- Same structure as male
    },
}

Filter Types

Each blacklist item can use one or more of these filters. A player only needs to match one filter to be allowed:

Filter	Description
`jobs`	List of job names
`gangs`	List of gang names
`citizenids`	List of CitizenIDs / identifiers
`aces`	List of ACE permission strings

ACE Permissions

To use ACE-based blacklists, register your ACE names in config:


Config.Aces = { "vip.clothing", "premium.hats" }

Then assign ACEs to players in your server.cfg:


add_ace identifier.license:abc123 vip.clothing allow

Ped Model Restrictions

Restrict which ped models are available in the character creator:


-- In shared/peds.lua
Config.Peds = {
    pedConfig = {
        {
            peds = { "mp_m_freemode_01", "mp_f_freemode_01" },
            -- No filter = available to everyone
        },
        {
            peds = { "s_m_y_cop_01" },
            jobs = { "police" },
        },
        {
            peds = { "u_m_y_juggernaut_01" },
            aces = { "admin.peds" },
        },
    },
}