A full melee combat system while riding a bike. Pull out any melee weapon from your inventory, swing left or right with intuitive LMB / RMB (or LT / RT on gamepad), cycle through everything you carry, and throw the weapon at your target. Built for biker gangs, chases and street brawls.
Attack from either side of the bike — LMB and RMB mapped naturally so you can hit riders on both flanks
Different damage profiles for blade and blunt weapon types
Optional knock-off effect — eject the target ped from their bike on contact
Tap G to enter throw mode
Aim with the camera and release with LMB to launch the weapon
Configurable throw speed, gravity, arc steps for realistic trajectory
[ and ] cycle through every melee weapon you own
Backspace swap between two recently-used weapons
Picks up automatically from inventory based on configured priority
Connect with another vehicle and apply configurable damage on impact
Combine with knock-off for forced dismounts on chase escapes
Center-screen weapon indicator showing the active weapon
Auto-vanishes when not in use
Fully toggleable in config
11 melee weapons supported out of the box, each with its own in-hand prop and damage type:
🥢 Bat — blunt
🪛 Crowbar — blade
🏌 Golf Club — blunt
🔨 Hammer — blunt
🪓 Hatchet — blade
🔪 Knife — blade
🗡 Machete — blade
🥢 Nightstick — blunt
🎱 Pool Cue — blunt
🔪 Switchblade — blade
🔧 Wrench — blunt
Add your own via a single Lua line — just map an inventory item to a prop model.
Server owners can tune nearly every behaviour:
Controls
Remap every input — attack keys, swap, throw mode, toggle
Keyboard + gamepad both supported
Combat Tuning
vehicleDamage on impact
kickForwardVelocity & kickUpwardVelocity for knock-off intensity
throwSpeed, throwGravity, throwMaxSteps for thrown weapon physics
Restrictions
onlyMeleeOnUnarmed — block firearms while system is active
ejectPedOffBike — toggle the knock-off effect
swapBetweenGunsAndMelee — let players seamlessly switch between guns and melee
UI
drawWeaponUI, weaponUICenter, weaponUIVanish — fine-grained UI control
Performance
Idle usage: 0.00 – 0.01 ms
Active combat: 0.04 – 0.05 ms
Supported Systems
Framework: ESX, QB-Core, Qbox (auto-detect)
Inventory: ox_inventory, qs-inventory, codem-inventory, core_inventory, tgiann-inventory, origen_inventory, one_inventory, jpr-inventory, qb-inventory, ps-inventory
Notify: ox_lib, qb, esx, okokNotify, ps-ui
Library: ox_lib
Logging
Discord webhook logging — track every kill / knock-off / throw
If your inventory/notify system is not on this list, ping us and we add it.
