[PAID] CLX-HealthSystem | Realistic Injury & Limb Management

Introduction

CLX-HealthSystem is a realistic health and injury system designed for FiveM servers. It tracks player damage bone-by-bone and enhances the RP experience with dynamic HUD indicators. Fully compatible with the QBCore framework.

Key Features

• Realistic Bone Damage: Separate damage tracking for 7 bone regions (head, thorax, arms, etc.).
• Dynamic HUD: Health gauge changes color based on damage severity (Normal, Warning, Danger, Unusable).
• Weapon Lock: Players cannot use weapons if both arms are injured.
• Healing Items: Bandages, first-aid kits, and other items to heal specific bones.
• Visual Effects: Screen shakes, filters, and animation-supported healing mechanics.
• Fully Configurable: All settings can be easily adjusted via config.lua.

Installation

1. Download: Purchase via Tebex.
2. Move the clx-healthsystem folder to your resources directory.
3. Add ensure clx-healthsystem to your server.cfg.
4. Dependencies: Requires qb-core.

Configuration Examples

Config = {}

Config.Colors = {
    "#ff000000", -- NORMAL
    "#ffa20070", -- MIDDLE
    "#ff00009f", -- DANGER
    "#000000", -- BLACK
}

Config.Filter = "MP_deathfail_night"
Config.DisableWeaponUseWhenBothArmsInjured = true  -- Disable weapon use when both arms are injured
Config.ArmInjuryThreshold = 25 -- Threshold health value for arms to disable weapon use
Config.NotifyMessageWhenArmsInjured = "You can't use weapons with injured arms!"
Config.ShowHUD = "always" -- Indicator setting: “always” -> always on, ‘on_damage’ -> show only when damaged
Config.Debug = false-- Debug mode: true -> active, false -> deactive

Config.EnableEffects = false -- Toggles effects (e.g., screen filters, camera shakes, etc.)
Config.FilterIntensity = { -- Intensity of timecycle modification for different damage levels
    [2] = 0.0, -- Intensity for 2 injured limbs
    [3] = 0.0, -- Intensity for 3 injured limbs
    [4] = 0.0, -- Intensity for 4 or more injured limbs
}

Config.ShakeIntensity = 0.0 -- Camera shake intensity (range: 0.0 - 1.0)
Config.Animpostfx = "DeathFailMPDark" -- Applied Animpostfx effect. To disable: Config.Animpostfx = false

Config.HealItems = {
    ["ifaks"] = {
        healAmount = 40,
        progressBar = {
            duration = 5000,
            label = "Applying Bandage...",
            useWhileDead = false,
            canCancel = true,
        },
        animation = {
            dict = "amb@world_human_clipboard@male@idle_a",
            anim = "idle_c",
            flags = 49,
        }
    },

    ["allhealitem"] = {
        healAmount = 50,
        progressBar = {
            duration = 7000,
            label = "Using Medical Item...",
            useWhileDead = false,
            canCancel = true,
        },
        animation = {
            dict = "amb@world_human_clipboard@male@idle_a",
            anim = "idle_c",
            flags = 49,
        }
    }
}

Config.OperateItems = {
    ["bandage"] = {
        healAmount = 100,
        healBones = {"thorax", "stomach"},
        progressBar = {
            duration = 8000,
            label = "Operating...",
            useWhileDead = false,
            canCancel = true,
        },
        animation = {
            dict = "anim@heists@box_carry@",
            anim = "idle",
            flags = 49,
        }
    },

    ["specifichealitem"] = {
        healAmount = 70,
        healBones = {"head", "leftArm", "rightArm"},
        progressBar = {
            duration = 6000,
            label = "Using Surgical Tool...",
            useWhileDead = false,
            canCancel = true,
        },
        animation = {
            dict = "amb@medic@standing@kneel@base",
            anim = "base",
            flags = 49,
        }
    }
}

-- Debug messages
Config.Messages = {
    GeneralDamageApplied = "General damage applied (burning, drowning, etc.).",
    BoneDamageWarning = "Warning: Unable to reduce health for bone: ",
    InvalidBoneID = "Warning: Invalid or undefined bone ID: ",
}

Screenshots

|

|

|

|

|

Support & Contact

• Discord: CapsuleV Support
• Gitbook: Exports and Installation
• License: One-time payment (unlimited usage).

Elevate your RP server with CLX-HealthSystem!