Install a hit registration script for QBCore FiveM servers. Accurate hitreg, configurable damage zones, and server-side validation. Built for RP servers.
This utility script is designed for QBCORE-based FiveM servers.
Install a hit registration script for QBCore FiveM servers. Accurate hitreg, configurable damage zones, and server-side validation. Built for RP servers.
4 files included
Config = {}
-- Weapon multiplier table: weaponHash -> multiplier
Config.Weapons = {
-- Pistols
[GetHashKey('WEAPON_PISTOL')] = { label = 'Pistol', multiplier = 1.0 },
[GetHashKey('WEAPON_PISTOL_MK2')] = { label = 'Pistol MKII', multiplier = 1.1 },
[GetHashKey('WEAPON_COMBATPISTOL')] = { label = 'Combat Pistol', multiplier = 1.05 },
[GetHashKey('WEAPON_APPISTOL')] = { label = 'AP Pistol', multiplier = 0.85 },
[GetHashKey('WEAPON_STUNGUN')] = { label = 'Stun Gun', multiplier = 0.0 },
[GetHashKey('WEAPON_SNSPISTOL')] = { label = 'SNS Pistol', multiplier = 0.9 },
[GetHashKey('WEAPON_SNSPISTOL_MK2')] = { label = 'SNS Pistol MKII', multiplier = 0.95 },
[GetHashKey('WEAPON_HEAVYPISTOL')] = { label = 'Heavy Pistol', multiplier = 1.2 },
[GetHashKey('WEAPON_VINTAGEPISTOL')] = { label = 'Vintage Pistol', multiplier = 1.0 },
-- Submachine Guns
[GetHashKey('WEAPON_MICROSMG')] = { label = 'Micro SMG', multiplier = 0.8 },
[GetHashKey('WEAPON_SMG')] = { label = 'SMG', multiplier = 0.9 },
[GetHashKey('WEAPON_SMG_MK2')] = { label = 'SMG MKII', multiplier = 0.95 },
[GetHashKey('WEAPON_ASSAULTSMG')] = { label = 'Assault SMG', multiplier = 0.85 },
[GetHashKey('WEAPON_COMBATPDW')] = { label = 'Combat PDW', multiplier = 0.9 },
[GetHashKey('WEAPON_MG')] = { label = 'MG', multiplier = 1.0 },
[GetHashKey('WEAPON_COMBATMG')] = { label = 'Combat MG', multiplier = 1.1 },
[GetHashKey('WEAPON_COMBATMG_MK2')] = { label = 'Combat MG MKII', multiplier = 1.15 },
[GetHashKey('WEAPON_GUSENBERG')] = { label = 'Gusenberg', multiplier = 1.0 },
-- Rifles
[GetHashKey('WEAPON_ASSAULTRIFLE')] = { label = 'Assault Rifle', multiplier = 1.2 },
[GetHashKey('WEAPON_ASSAULTRIFLE_MK2')] = { label = 'Assault Rifle MKII', multiplier = 1.25 },
[GetHashKey('WEAPON_CARBINERIFLE')] = { label = 'Carbine Rifle', multiplier = 1.15 },
[GetHashKey('WEAPON_CARBINERIFLE_MK2')] = { label = 'Carbine Rifle MKII', multiplier = 1.2 },
[GetHashKey('WEAPON_ADVANCEDRIFLE')] = { label = 'Advanced Rifle', multiplier = 1.2 },
[GetHashKey('WEAPON_SPECIALCARBINE')] = { label = 'Special Carbine', multiplier = 1.2 },
[GetHashKey('WEAPON_SPECIALCARBINE_MK2')] = { label = 'Special Carbine MKII', multiplier = 1.25 },
[GetHashKey('WEAPON_BULLPUPRIFLE')] = { label = 'Bullpup Rifle', multiplier = 1.15 },
[GetHashKey('WEAPON_BULLPUPRIFLE_MK2')] = { label = 'Bullpup Rifle MKII', multiplier = 1.2 },
[GetHashKey('WEAPON_COMPACTRIFLE')] = { label = 'Compact Rifle', multiplier = 1.0 },
-- Sniper rifles
[GetHashKey('WEAPON_SNIPERRIFLE')] = { label = 'Sniper Rifle', multiplier = 2.0 },
[GetHashKey('WEAPON_HEAVYSNIPER')] = { label = 'Heavy Sniper', multiplier = 3.0 },
[GetHashKey('WEAPON_HEAVYSNIPER_MK2')] = { label = 'Heavy Sniper MKII', multiplier = 3.2 },
[GetHashKey('WEAPON_MARKSMANRIFLE')] = { label = 'Marksman Rifle', multiplier = 1.8 },
[GetHashKey('WEAPON_MARKSMANRIFLE_MK2')] = { label = 'Marksman Rifle MKII', multiplier = 1.9 },
-- Shotguns
[GetHashKey('WEAPON_PUMPSHOTGUN')] = { label = 'Pump Shotgun', multiplier = 1.5 },
[GetHashKey('WEAPON_PUMPSHOTGUN_MK2')] = { label = 'Pump Shotgun MKII', multiplier = 1.6 },
[GetHashKey('WEAPON_ASSAULTSHOTGUN')] = { label = 'Assault Shotgun', multiplier = 1.4 },
[GetHashKey('WEAPON_BULLPUPSHOTGUN')] = { label = 'Bullpup Shotgun', multiplier = 1.5 },
[GetHashKey('WEAPON_HEAVYSHOTGUN')] = { label = 'Heavy Shotgun', multiplier = 1.7 },
[GetHashKey('WEAPON_DBSHOTGUN')] = { label = 'Double Barrel Shotgun', multiplier = 2.0 },
[GetHashKey('WEAPON_AUTOSHOTGUN')] = { label = 'Auto Shotgun', multiplier = 1.3 },
[GetHashKey('WEAPON_SAWNOFFSHOTGUN')] = { label = 'Sawed-Off Shotgun', multiplier = 1.8 },
-- Melee & Thrown
[GetHashKey('WEAPON_KNIFE')] = { label = 'Knife', multiplier = 2.5 },
[GetHashKey('WEAPON_NIGHTSTICK')] = { label = 'Nightstick', multiplier = 1.2 },
[GetHashKey('WEAPON_HAMMER')] = { label = 'Hammer', multiplier = 1.5 },
[GetHashKey('WEAPON_BAT')] = { label = 'Baseball Bat', multiplier = 1.3 },
[GetHashKey('WEAPON_CROWBAR')] = { label = 'Crowbar', multiplier = 1.3 },
[GetHashKey('WEAPON_GOLFCLUB')] = { label = 'Golf Club', multiplier = 1.2 },
[GetHashKey('WEAPON_BOTTLE')] = { label = 'Bottle', multiplier = 1.0 },
[GetHashKey('WEAPON_DAGGER')] = { label = 'Dagger', multiplier = 2.0 },
[GetHashKey('WEAPON_HATCHET')] = { label = 'Hatchet', multiplier = 2.5 },
[GetHashKey('WEAPON_KNUCKLE')] = { label = 'Knuckle Duster', multiplier = 0.9 },
[GetHashKey('WEAPON_MACHETE')] = { label = 'Machete', multiplier = 2.2 },
[GetHashKey('WEAPON_FLASHLIGHT')] = { label = 'Flashlight', multiplier = 1.0 },
[GetHashKey('WEAPON_SWITCHBLADE')] = { label = 'Switchblade', multiplier = 2.0 },
[GetHashKey('WEAPON_POOLCUE')] = { label = 'Pool Cue', multiplier = 1.1 },
[GetHashKey('WEAPON_WRENCH')] = { label = 'Wrench', multiplier = 1.4 },
[GetHashKey('WEAPON_BATTLEAXE')] = { label = 'Battle Axe', multiplier = 3.0 },
-- Special
[GetHashKey('WEAPON_MOLOTOV')] = { label = 'Molotov', multiplier = 1.0 },
[GetHashKey('WEAPON_GRENADE')] = { label = 'Grenade', multiplier = 5.0 },
[GetHashKey('WEAPON_STICKYBOMB')] = { label = 'Sticky Bomb', multiplier = 5.0 },
[GetHashKey('WEAPON_PROXMINE')] = { label = 'Proximity Mine', multiplier = 5.0 },
[GetHashKey('WEAPON_PIPEBOMB')] = { label = 'Pipe Bomb', multiplier = 4.0 },
[GetHashKey('WEAPON_SMOKEGRENADE')] = { label = 'Smoke Grenade', multiplier = 0.0 },
[GetHashKey('WEAPON_FLARE')] = { label = 'Flare', multiplier = 0.0 },
-- Unarmed
[GetHashKey('WEAPON_UNARMED')] = { label = 'Fists', multiplier = 0.5 }
}
Config.DefaultWeaponMultiplier = 1.0
Config.HeadshotMultiplier = 2.5
Config.EnableDamageLogs = false
Download the standalone_spawner FiveM script for framework-free vehicle and weapon spawning. Uses native FiveM functions, no ESX or QBCore required. Easy setup, lightweight, and customizable.
Enhance your FiveM server with this QBCore teleport script for testing and debugging. Features configurable teleport points, server-client integration, and utility tools for developers.
Enhance your FiveM server with this QBCore test script. Features client/server functions, HTML UI, and easy configuration for seamless integration and testing.
Enhance your FiveM server with qb-blackvest, a QBCore script adding black vests for immersive roleplay. Easy installation, customizable config, and seamless integration.
Learn how to install and configure the qb-testscript for QBCore FiveM servers. This guide covers fxmanifest.lua, config.lua, and client/server setup for seamless integration.
Enhance your FiveM server with resix_firmenTablet: a customizable business tablet script for QBCore. Manage ads, control access, and streamline company operations with modern UI and SQL integration.
Yes — mato-hitreg is built specifically for the QBCore framework and uses QBCore's shared objects and event system. It is not compatible with other frameworks out of the box.
mato-hitreg is built for Server 5848+. Make sure your FiveM server artifacts are up to date before installing this utility script.
Download the script ZIP from this page, extract it into your server's resources folder, add the resource name to your server.cfg with "ensure", review the config.lua for any settings you'd like to change, and restart your FiveM server. The script will load automatically on the next start.
Yes — mato-hitreg is completely free to download and use on FiveM Script Creator. All scripts on the platform are open and free for the community.
Use our AI-powered FiveM Script Creator to generate custom scripts in minutes. No coding experience required!
Join thousands of FiveM server owners already using our platform