Configuration

Script Adjustments & Configuration

Here you can choose whether the player’s mask is removed while inside a vehicle or delayed until they exit the vehicle.

Config.SkipRemovalInVehicle = true

When set to false, helmets will not be removed, only masks will be affected by the script.

Config.RemoveHelmet = true

When enabled, a single animation will remove both mask and helmet together if the player is wearing both. When disabled, each item will be removed with its own separate animation.

onfig.UnifiedHeadgearRemoval = true

This option enables or disables the face camera during headgear animations. When enabled, a zoomed-in face camera will be shown while putting on or removing a mask/helmet. When disabled, the animations play without any camera changes.

Config.CameraAnimation = true

Common helmet drawable ranges (edit to fit your server clothes pack)

Config.HelmetModels = {
    -- Freemode Male Ped
    ['mp_m_freemode_01'] = {
        {36, 44},   
        {45, 63},   
    },
    -- Freemode Female Ped
    ['mp_f_freemode_01'] = {
        {36, 44},
        {45, 63},
    }
}

Define zones where masks will be automatically removed when players enter them.

Config.MaskZones = {
    {
        label = "Police Station",
        center = vector3(-567.89, -426.86, 45.52),
        radius = 45.0
    },
    {
        label = "Pillbox Hospital",
        center = vector3(297.13, -578.77, 49.75),
        radius = 50.0
    },
    {
        label = "Hotel",
        center = vector3(-1007.16, -428.64, 40.51),
        radius = 50.0
    }
    
}

Specify the jobs that are exempt from mask removal. Use the exact job names from your server.

Config.WhitelistedJobs = {
    ['police'] = true,        -- Police officers
    ['lspd'] = true,          -- LSPD 
    ['ambulance'] = true,     -- EMS personnel
    ['doctor'] = true,        -- Doctors
    ['sheriff'] = true,       -- Sheriff's department
    ['fib'] = true,           -- FIB
    ['admin'] = true,         -- admin
}

Configure the notification messages that players will see when masks or helmets are removed or applied.

Config.MaskRemovedNotify = "You entered a safe zone. Your mask has been removed"
Config.MaskRestoredNotify = "You exited the safe zone. Your mask has been restored"
Config.WhitelistNotify = "Your job requires you to keep your mask on"