X3D DeveloperX3D Developer
Contact on Discord
Docs

X3D Damage

Set every weapon's damage yourself, with bleed, slow, stun, knockdown and lifesteal effects. Weapon skins supported. ESX or standalone.

Buy / Get freeConfig builder

Installation

  1. Drop x3d_damage into resources/ and add ensure x3d_damage to server.cfg.
  2. Edit config/weapons.lua. Weapons not listed keep the game's own damage.

Config (config.lua)

Option What it does
Config.Framework 'auto' / 'esx' / 'standalone'
Config.Locale 'th' or 'en'
Config.Aliases { SKIN = 'BASE' } — a skin weapon uses its base weapon's row. X3D Inventory publishes its skins in GlobalState.x3dWeaponBase automatically
Config.Bleed.stopOnHeal Stop bleeding as soon as health goes up
Config.Bleed.screenFx Screen effect per bleed tick ('' = none)
Config.Lifesteal.range / .cooldownMs Server checks for lifesteal
Config.Controls.disableStealth Disable the stealth/duck control
Config.Controls.jumpHoldMs / .jumpBlockMs Holding jump jumpHoldMs blocks attacking until jumpBlockMs after the hold started (0 = off)

Weapon rows (config/weapons.lua)

damage, headshotKill, blockInstantKill (no heavy melee), blockHit (same as blockInstantKill; kept for imported tables), effects = { ... }. Every effect takes an optional chance (0–1) and headshotOnly.

Effect Parameters
knockdown pulses, headshotPulses, ejectBelowSpeed (pull out of slow vehicles)
bonus damage
pierce damage, minArmor — damage straight off health when armour ≥ minArmor
lifesteal heal, healChance
bleed perTick, ticks, intervalMs
slow mult (0–1), seconds
stun seconds, ragdollMs

Hooks (addons/hooks/client.lua)

Hooks.OnHeadshot(ped) — return true to block a headshot (e.g. a helmet):

function Hooks.OnHeadshot(ped)
    if exports.my_items:isHelmetOn() then exports.my_items:helmetBroken() return true end
    return false
end

Exports

Client: exports.x3d_damage:StopBleeding().

Note

Like every client-side damage script, the victim's own client applies the damage; pair it with an anticheat health check.

View product page