Brick Outfit Stealer configuration

Interaction

Edit brick_outfit_stealer/config.lua, then restart brick_outfit_stealer to apply file changes.

Config.Interaction = {
    Label      = 'Steal outfit',
    Icon       = 'fa-solid fa-shirt',
    Distance   = 2.0,
    DurationMs = 10000,
}

• Label is shown by the selected target provider.
• Icon must be a Font Awesome icon supported by that provider.
• Distance is the maximum interaction distance.
• DurationMs is the theft duration; use 0 for an instant interaction.

The search animation remains active for the configured duration, so shorter and longer values do not require matching animation lengths.

Hands-up eligibility

Config.HandsUp = {
    Enabled = true,
    Animations = {
        { Dict = 'missminuteman_1ig_2', Clip = 'handsup_base' },
        { Dict = 'random@mugging3', Clip = 'handsup_standing_base' },
    },
}

• Enabled = true allows theft from players using any listed animation as well as incapacitated players.
• Enabled = false restricts theft to players reported as incapacitated by the selected Medical provider.
• Each animation entry requires its exact animation dictionary in Dict and clip name in Clip.
• Add or remove entries to match the hands-up resource or emote menu installed on the server.

The complete default list in config.lua covers several common hands-up animations.

Victim appearance

Choose exactly one Config.VictimAfterTheft mode:

Value	Result
family_friendly	Removes outerwear/accessories while retaining the current pants, shoes, and undershirt.
underwear	Applies standard freemode underwear components.
unchanged	Copies the outfit without changing the victim.

Face and hair are excluded from the copied disguise.

Custom clothing packs

Config.VictimAppearancePresets contains separate component values for the family-friendly preset and male/female underwear presets. Adjust these values when a custom clothing pack assigns different drawable IDs.

GTA freemode component slots used by the presets are:

Slot	Clothing component
1	Mask or face covering
3	Arms or torso
4	Pants or legs
5	Bag or parachute
6	Shoes or feet
7	Accessory or chain
8	Undershirt
9	Body armour
10	Decal or badge
11	Top or jacket

Each component accepts Drawable and Texture values of 0 or higher and a Palette from 0 through 3. ClearProps contains the prop slots removed from the victim: 0 hat, 1 glasses, 2 ears, 6 watch, and 7 bracelet.

Restore command

Config.RestoreCommandEnabled = true
Config.RestoreCommand = 'restoreoutfit'

Set RestoreCommandEnabled to false to disable restoration and stop the script from remembering previous appearances. Players must then use a clothing shop, skin-menu reload command, or another clothing flow to change back.

When enabled, /restoreoutfit restores the player’s locally remembered appearance from before their first successful theft or before their outfit was stolen. The command cannot be used while the player is downed or dead. RestoreCommand must remain a non-empty command name without the leading slash; it is ignored while restoration is disabled.

Reconnecting, restarting the resource or changing to another freemode model clears the saved restore point.

Locale

Config.Locale = 'en' selects a locale shipped in locales/. Edit those files to change prompts and notifications.