Body Damage

Damage System API - LVS Inventory

GetPlayerDamage()

Retrieves the current damage state of the player by body parts.

Description

Returns an object containing damage data for 6 main body zones, providing a simplified structure for external use.

Syntax

local damageData = exports['lvs_inventory']:GetPlayerDamage()

Return Value

Type: table

Object with the following properties:

• head (table): Head damage data

• torso (table): Upper torso damage data

• leftArm (table): Left arm damage data

• rightArm (table): Right arm damage data

• leftLeg (table): Left leg damage data

• rightLeg (table): Right leg damage data

Each body part contains:

• percent (number): Accumulated damage percentage (0-100)

• bullets (number): Number of bullet impacts received

• severity (boolean): Indicates if damage is severe

• broken (boolean): Indicates broken bones

• bleeding (boolean): Indicates if the zone is bleeding

Example

local damage = exports['lvs_inventory']:GetPlayerDamage()

if damage.head.percent > 50 then
    print('Critical head damage!')
end

if damage.leftLeg.broken then
    print('Left leg broken')
end

---

UpdatePlayerDamage()

Updates damage for a specific body part and notifies linked systems.

Description

This function allows manual modification of the damage state for a specific body zone. It registers bullet impacts, updates damage percentage, and maintains negative states (severity, fractures, bleeding).

Syntax

exports['lvs_inventory']:UpdatePlayerDamage(bodyPart, bulletCount, newPercent, severity, broken, bleeding)

Parameters

Parameter	Type	Description
bodyPart	string	Body part to update. Valid values: head, torso, leftArm, rightArm, leftLeg, rightLeg
bulletCount	number	Number of bullet impacts to register (typically 1 per impact)
newPercent	number	New damage percentage (0-100)
severity	boolean	Indicates if damage is severe
broken	boolean	Indicates broken bones
bleeding	boolean	Indicates if the zone is bleeding

Behavior

• If bodyPart is invalid, defaults to torso

• Bullet impacts are accumulated to the existing counter

• Damage percentage is replaced with the new value

• Negative states are preserved if they already existed

• Automatically saves data to the server

• Triggers the lvs_injury:client:UpdatePlayerDamage event to notify other scripts

Example

-- Player shot in torso
exports['lvs_inventory']:UpdatePlayerDamage('torso', 1, 45, true, false, true)

-- Player falls and breaks leg
exports['lvs_inventory']:UpdatePlayerDamage('leftLeg', 0, 60, false, true, false)

-- Player receives severe head impact
exports['lvs_inventory']:UpdatePlayerDamage('head', 1, 85, true, true, true)

Notes

• This function is used internally by the system when a player takes damage

• Can be used externally to apply custom damage or synchronize states

• Changes are automatically persisted to the database

---

Related Events

lvs_injury:client:UpdatePlayerDamage

Triggered whenever player damage is updated.

Parameters:

• BodyParts (table): Complete table with all body parts state

AddEventHandler('lvs_injury:client:UpdatePlayerDamage', function(bodyParts)
    -- Update health UI, apply effects, etc.
end)

lvs_injury:client:ResetPlayerDamage

Triggered when player damage is reset (e.g., after being revived).

---

Common Use Cases

Check player condition

local damage = exports['lvs_inventory']:GetPlayerDamage()
local totalDamage = 0

for _, part in pairs(damage) do
    totalDamage = totalDamage + part.percent
end

if totalDamage > 300 then
    -- Player heavily injured, will need medical attention
end

Apply fall damage

local fallHeight = 15.0
if fallHeight > 10.0 then
    local damagePercent = math.floor((fallHeight - 10) * 2)
    exports['lvs_inventory']:UpdatePlayerDamage(
        'leftLeg', 
        0, 
        damagePercent, 
        false, 
        fallHeight > 20, 
        false
    )
end

---

Medical treatment system example

function TreatBleeding(playerPart)
    local damage = exports['lvs_inventory']:GetPlayerDamage()
    
    if damage[playerPart] and damage[playerPart].bleeding then
        -- Apply bandage
        exports['lvs_inventory']:UpdatePlayerDamage(
            playerPart,
            0,
            damage[playerPart].percent,
            damage[playerPart].severity,
            damage[playerPart].broken,
            false -- Stop bleeding
        )
    end
end