Upgrade Scripts Docs

#Installation

#Drop the files in your server

Start by dropping the files included in the resource from keymaster into your resources folder, make sure to ensure the resource in your server.cfg

ensure upgrade-damage

#Setup Config

The config is relatively simple to setup. Then you can setup the damage multiplier and/or critical multipliers for each weapon.

Config = {
    -- General settings
    enableLogging = false,
    defaultModifier = 0.1,
    
    -- Critical hit settings
    criticalHits = {
        enabled = true,
        chance = 0.15,    -- 15% chance for critical hit
        multiplier = 1.5  -- Critical hits do 1.5x damage
    },
    
    -- Weapon configurations
    Weapons = {
        -- Melee Weapons
        [`WEAPON_UNARMED`] = {model = `WEAPON_UNARMED`, modifier = 0.2, canCrit = true},
        [`WEAPON_NIGHTSTICK`] = {model = `WEAPON_NIGHTSTICK`, modifier = 0.1, canCrit = true},
        [`WEAPON_FLASHLIGHT`] = {model = `WEAPON_FLASHLIGHT`, modifier = 0.1, canCrit = true},
        [`WEAPON_KNIFE`] = {model = `WEAPON_KNIFE`, modifier = 0.1, canCrit = true},
        [`WEAPON_KNUCKLE`] = {model = `WEAPON_KNUCKLE`, modifier = 0.1, canCrit = true},
        [`WEAPON_HAMMER`] = {model = `WEAPON_HAMMER`, modifier = 0.1, canCrit = true},
        [`WEAPON_BAT`] = {model = `WEAPON_BAT`, modifier = 0.1, canCrit = true},
        [`WEAPON_GOLFCLUB`] = {model = `WEAPON_GOLFCLUB`, modifier = 0.1, canCrit = true},
        [`WEAPON_CROWBAR`] = {model = `WEAPON_CROWBAR`, modifier = 0.1, canCrit = true},
        [`WEAPON_BOTTLE`] = {model = `WEAPON_BOTTLE`, modifier = 0.1, canCrit = true},
        [`WEAPON_DAGGER`] = {model = `WEAPON_DAGGER`, modifier = 0.1, canCrit = true},
        [`WEAPON_HATCHET`] = {model = `WEAPON_HATCHET`, modifier = 0.1, canCrit = true},
        [`WEAPON_MACHETE`] = {model = `WEAPON_MACHETE`, modifier = 0.1, canCrit = true},
        [`WEAPON_SWITCHBLADE`] = {model = `WEAPON_SWITCHBLADE`, modifier = 0.1, canCrit = true},
        [`WEAPON_POOLCUE`] = {model = `WEAPON_POOLCUE`, modifier = 0.1, canCrit = true},
        [`WEAPON_PIPEWRENCH`] = {model = `WEAPON_PIPEWRENCH`, modifier = 0.1, canCrit = true},

        -- Throwables
        [`WEAPON_PROXMINE`] = {model = `WEAPON_PROXMINE`, modifier = 0.1, canCrit = false},
        [`WEAPON_BZGAS`] = {model = `WEAPON_BZGAS`, modifier = 0.1, canCrit = false},
        [`WEAPON_SMOKEGRENADE`] = {model = `WEAPON_SMOKEGRENADE`, modifier = 0.1, canCrit = false},
        [`WEAPON_MOLOTOV`] = {model = `WEAPON_MOLOTOV`, modifier = 0.1, canCrit = false},

        -- Pistols
        [`WEAPON_REVOLVER`] = {model = `WEAPON_REVOLVER`, modifier = 0.1, canCrit = true},
        [`WEAPON_PISTOL`] = {model = `WEAPON_PISTOL`, modifier = 0.1, canCrit = true},
        [`WEAPON_PISTOL_MK2`] = {model = `WEAPON_PISTOL_MK2`, modifier = 0.1, canCrit = true},
        [`WEAPON_COMBATPISTOL`] = {model = `WEAPON_COMBATPISTOL`, modifier = 0.1, canCrit = true},
        [`WEAPON_APPISTOL`] = {model = `WEAPON_APPISTOL`, modifier = 0.1, canCrit = true},
        [`WEAPON_PISTOL50`] = {model = `WEAPON_PISTOL50`, modifier = 0.1, canCrit = true},
        [`WEAPON_SNSPISTOL`] = {model = `WEAPON_SNSPISTOL`, modifier = 0.1, canCrit = true},
        [`WEAPON_HEAVYPISTOL`] = {model = `WEAPON_HEAVYPISTOL`, modifier = 0.1, canCrit = true},
        [`WEAPON_VINTAGEPISTOL`] = {model = `WEAPON_VINTAGEPISTOL`, modifier = 0.1, canCrit = true},
        [`WEAPON_FLAREGUN`] = {model = `WEAPON_FLAREGUN`, modifier = 0.1, canCrit = false},
        [`WEAPON_MARKSMANPISTOL`] = {model = `WEAPON_MARKSMANPISTOL`, modifier = 0.1, canCrit = true},

        -- SMGs
        [`WEAPON_MICROSMG`] = {model = `WEAPON_MICROSMG`, modifier = 0.1, canCrit = true},
        [`WEAPON_MINISMG`] = {model = `WEAPON_MINISMG`, modifier = 0.1, canCrit = true},
        [`WEAPON_SMG`] = {model = `WEAPON_SMG`, modifier = 0.1, canCrit = true},
        [`WEAPON_SMG_MK2`] = {model = `WEAPON_SMG_MK2`, modifier = 0.1, canCrit = true},
        [`WEAPON_ASSAULTSMG`] = {model = `WEAPON_ASSAULTSMG`, modifier = 0.1, canCrit = true},
        [`WEAPON_COMBATPDW`] = {model = `WEAPON_COMBATPDW`, modifier = 0.1, canCrit = true},

        -- MGs
        [`WEAPON_MG`] = {model = `WEAPON_MG`, modifier = 0.1, canCrit = true},
        [`WEAPON_COMBATMG`] = {model = `WEAPON_COMBATMG`, modifier = 0.1, canCrit = true},
        [`WEAPON_COMBATMG_MK2`] = {model = `WEAPON_COMBATMG_MK2`, modifier = 0.1, canCrit = true}
    }
}