Watch the Showcase Video here
Features Bleeding Trigger: Bleeding starts when the player is shot 3 times (non-melee damage) or punched 2 times. When triggered, the player's health gradually decreases over time. Health regeneration is disabled during bleeding. Visual Blood Effects: Particle Effects: Blood spatters are attached to the player’s face and chest. Multiple ground blood effects (spatters) follow the player, creating a dense blood trail. Slow Run Effect: When the player's health falls below a certain threshold, their movement speed is reduced (simulating a slow run). The movement speed is controlled by a configurable multiplier. Face Wound Overlay: If the player receives sufficient melee damage, a face wound overlay is applied using GTA V’s head overlay functions. When the player uses /bandage, the wounds gradually heal over a configurable time period (default 3 minutes). /bandage Command: Players can use the /bandage command to immediately stop all bleeding effects. On using /bandage, a native GTA V notification is displayed (using Thefeed) stating "You have bandaged your wounds and your wounds are healing!". After bandaging, the face wounds heal gradually over the specified healing time. Auto-Reset on Death/Respawn: All bleeding loops and effects automatically stop if the player dies. When the player respawns, all effects are cleared and health regeneration is restored.
Configuration Options
All configurable options are defined in config.lua. Below is a summary of the main settings:Debug
Config.Debug
Set totrueto enable debug messages in the console;falseto disable.
Bleeding Mechanics
Config.BleedRate
Description: Health points lost per interval during bleeding.
Default:1Config.BleedInterval
Description: Time in milliseconds between each health reduction/update and ground blood update.
Default:1000
Particle Effect Settings
Config.BloodParticleDict
Description: Particle dictionary used for blood effects.
Default:"scr_rcbarry2"Config.GroundBloodParticle
Description: Particle effect name for blood on the ground.
Default:"scr_wheel_blood"Config.FaceBloodParticle
Description: Particle effect name for blood on the player's face.
Default:"scr_wheel_blood"Config.ChestBloodParticle
Description: Particle effect name for blood on the player's chest/clothes.
Default:"scr_wheel_blood"Config.FaceBoneIndex
Description: Bone index where the face blood effect is attached.
Default:12844Config.ChestBoneIndex
Description: Bone index where the chest blood effect is attached.
Default:24816
Disorientation Settings
Config.DisorientationThreshold
Description: Player health below which disorientation (camera shake) is applied.
Default:50Config.DisorientationIntensity
Description: Intensity of the camera shake effect.
Default:1.0
Damage Threshold Settings
Config.HitThresholdForShot
Description: Number of valid shot (non-melee) damage events required to trigger bleeding and the injured walk effect.
Default:3Config.HitThresholdForMelee
Description: Number of melee (punch) damage events required to trigger bleeding (face wounds are applied).
Default:2
Injured Walk & Slow Run
Config.InjuredWalkAnimSet
Description: Animation clipset used for the injured (curved) walk. You can try different variations (e.g.,"move_m@injured","move_m@injured@a").
Default:"move_m@injured"Config.SlowRunHealthThreshold
Description: Health threshold below which the slow run effect is enforced.
Default:150Config.RunSpeedMultiplier
Description: Movement speed multiplier applied when health is below the slow run threshold.
Default:0.7(70% of normal speed)
Ground Blood Behavior
Config.ForceGroundBlood
Description: Iftrue, ground blood effects will be spawned even if player coordinates are (0,0,0).
Default:true
Face Wound Overlay (for Melee Damage)
Config.FaceWoundOverlayType
Description: Head overlay type used for displaying wounds (commonly0for blemishes).
Default:0Config.FaceWoundOverlayValue
Description: Specific overlay value to use for wounds; adjust to achieve your desired texture.
Default:1Config.WoundHealingTime
Description: Total time in milliseconds for wounds to fully heal after bandaging.
Default:180000(3 minutes)Config.WoundHealingInterval
Description: Interval in milliseconds between healing steps.
Default:5000