Face Coverage, Clothing & Tattoos

Three tables decide what a scanner can actually see: Config.FaceCoverage, Config.Clothing and Config.Tattoos, plus the two exposure helpers Config.ArmsExposure and Config.NakedSets.

#Face coverage

Categories = { full = 1.00, half = 0.60, eyes = 0.35, hat = 0.15 },
Stack = 'add',

#Items nobody has classified yet

Until Auto-scan (or a manual override) has seen an item, it is treated by slot:

UnknownBySlot = {
    ['comp:1'] = 'full',                                 -- unknown mask = full mask
    ['prop:0'] = { category = 'hat', hidesHair = true }, -- unknown hat / helmet = cap
    ['prop:1'] = 'eyes',                                 -- unknown glasses = sunglasses
},

#Per-item overrides

For addon or EUP items you want to pin by hand. Key is '<comp|prop>:<slot>:<collection>:<localIndex>' (collection '' = base game); value is a category name or a number 0.0–1.0.

Overrides = {
    m = {
        ['comp:1::52'] = 'half',               -- base-game mask 52 only covers the lower face
    },
    f = {
        ['prop:0:my_eup_pack:3'] = 0.0,        -- addon hat that hides nothing
    },
},

Admins can also set these from the panel. Use /recognition:tags in game to see exactly what the game reports for what you are wearing.

#Clothing

SlotWeights = { top = 30, pants = 20, undershirt = 10, shoes = 10,
                hat = 10, bag = 5, accessories = 5, hair = 10 },

Any positive numbers work — they are scaled to 100 % between them.

#Which component goes where

Component 0 (head/face) and component 3 (arms) are never clothing — arms are only used to work out sleeves and gloves.

#Hair and beard

#Tattoos

Zones = {
    hands = true, forearms = true, upperArms = true, torso = true,
    back = true, neck = true, face = true, legs = true,
},

Each zone only counts while it is visible right now:

Set a zone to false and tattoos there are ignored completely.

#Sleeves and gloves

Config.ArmsExposure is a manual override for the arms drawable (component 3). Most items are classified automatically at runtime from the game's shop tags and by Auto-scan; this table wins over both.

Config.ArmsExposure = {
    m = { [0] = 'short', [4] = 'none', [5] = 'sleeveless', [15] = 'bare' },
    f = { [0] = 'short', [4] = 'none', [5] = 'sleeveless', [15] = 'bare' },
}

Keys may also be '<collection>:<localIndex>' strings, with values { class = …, gloves = true|false }.

An arms drawable nobody has classified yet covers nothing on the arm: the top decides the sleeves (an unclassified top counts as Config.Classifier.UnknownTop, 'long' by default). Whether it covers the hands is Config.Classifier.UnknownGloves (default false = bare hands).

#"Nothing worn" drawables

Config.NakedSets lists the base-game drawables that mean nothing worn here, per gender. Shirtless = top and undershirt both in these lists.

Config.NakedSets = {
    m = { top = { 15, 252 }, undershirt = { 15 }, arms = { 15 }, legs = { 61 }, shoes = { 34 } },
    f = { top = { 15 },      undershirt = { 14 }, arms = { 15 }, legs = { 15 }, shoes = { 35 } },
}

#Unclassified items — the Auto-scan defaults

Until an item has been through Auto-scan, these decide what it counts as. The top and the pants err on the side of hiding more, because the alternative is that an unknown item is a free disguise. An unknown arms item hides nothing on the arm: the top decides the sleeves.

Head props are not in that list: Config.FaceCoverage.UnknownBySlot['prop:0'] and ['prop:1'] are the one place that decides what an unclassified hat, helmet or pair of glasses counts as.

#When new items appear

At every start the server counts how many clothing drawables and props each freemode model has and compares that with the stored baseline. Nothing changed → the script says nothing. New items → admins are told how many, per model and slot:

[5code-recognition] 42 new clothing/prop items found (mp_f_freemode_01: 12, mp_m_freemode_01: 30). Run Auto-scan from the admin panel to classify them.