Progressive Bleeding

VINTAGE STORY   /   A HUNTER'S FIELD GUIDE

Progressive
Bleeding

Wound your prey. Follow the trail.
Finish the hunt.

Make fast animals easier to hunt while keeping dangerous enemies threatening. Stack wounds, track blood and oil trails, and slow injured creatures as the fight unfolds.

BY DAPLAYERGAMES   •   VERSION 1.6.0

Built for the hunt. Wounded prey becomes easier to catch. Large enemies receive smaller penalties.

Blood of the wild Red trails from wounded animals.

Oil of the Rust World Dark trails from supported Rust creatures.

The first successful hit with a supported weapon immediately applies one bleeding stack.

Further hits build up additional wounds instead of instantly adding more stacks. With default settings and base-quality spears, swords, or axes:

Each valid hit refreshes the bleeding duration to 30 seconds, without delaying the next damage pulse.

Bleeding deals damage every five seconds. Ticks are silent by default and do not trigger the health behavior’s hurt animation or apply knockback. Normal weapon impacts and death sounds remain audible.

When bleeding expires, its stacks and unfinished buildup are cleared.

Wounded creatures slow down according to their current missing-health percentage and target profile.

For example:

• A deer missing 20% of its health moves 30% slower.
• A bear missing the same percentage moves only 5% slower.

Slowdown remains after bleeding expires while the creature is still wounded. Healing gradually restores its movement speed; full health removes the penalty. Death or revival clears the wound effect.

The movement penalty applies during fleeing as well as ordinary movement.

These damage totals assume constant stacks and no duration refresh. They exclude direct weapon damage. Continued attacks extend the bleeding duration.

Default creature profiles

• Fast prey: deer—including guemals—gazelles, and hares.
• Dangerous animals: bears, moose, wolves, hyenas, and mammoths.
• Rust creatures: drifters, shivers, bowtorns, locusts, bells, mini bells, and mechanical helpers.
• Bosses: eidolon and erel.
• Ordinary: creatures without another matching profile.

Mammoth-prefixed entity codes receive the dangerous profile across mod namespaces. Other modded creatures can be assigned profiles through configuration.

Blunt weapons receive 1.5× buildup against profiles marked mechanical. Axes retain their own category and do not receive this bonus.

Weapon quality increases buildup by 10% per tier above the first, up to a maximum multiplier of 1.5×. Quality affects subsequent wound buildup, not bleed damage or the initial one-stack application.

Weapon support follows the item’s tool classification and supported projectile identification. Custom weapons using unrelated classifications may require additional compatibility support.

• Organic animals produce red blood.
• Supported vanilla Rust and mechanical families produce near-black oil.
• Both impact particles and trails use the appropriate color.
• Particle quantity increases with active bleeding stacks.
• Trails stop when bleeding expires or the creature dies.
• Particle emission is separate from the five-second damage interval.

The configuration file is created automatically in your Vintage Story data directory:

ModConfig/progressivebleeding.json

Edit it while the world/server is closed, then restart to apply changes.

Bleeding and buildup settings

Damage calculation:

Damage per second =
Maximum HP × (DamagePercentPerStackPerSecond / 100)
× Active stacks × Target DamageMultiplier

Damage accumulates between pulses. Stack increases only affect the time after they are applied, and any remaining partial interval is paid once when bleeding expires.

Buildup calculation for subsequent hits:

Buildup gained =
BuildupPerHit × Weapon multiplier × Quality multiplier
× Mechanical blunt multiplier, when applicable

Weapon settings

Edit WeaponBuildupMultipliers to change how quickly each category creates additional wounds:

"WeaponBuildupMultipliers": {
  "spear": 1.0,
  "thrownspear": 1.0,
  "sword": 1.0,
  "arrow": 0.6,
  "axe": 1.0,
  "knife": 0.75,
  "blunt": 1.0
}

A value of 0 disables bleeding application and duration refresh for that category. Direct weapon damage remains unaffected.

Creature profile settings

Each profile exposes four variables:

Default profiles:

"Ordinary": {
  "DamageMultiplier": 1.0,
  "SlowdownMultiplier": 1.0,
  "MaximumSlowdown": 0.2,
  "Mechanical": false
},
"FastPrey": {
  "DamageMultiplier": 1.0,
  "SlowdownMultiplier": 1.5,
  "MaximumSlowdown": 0.4,
  "Mechanical": false
},
"Dangerous": {
  "DamageMultiplier": 0.5,
  "SlowdownMultiplier": 0.25,
  "MaximumSlowdown": 0.1,
  "Mechanical": false
},
"Rust": {
  "DamageMultiplier": 0.5,
  "SlowdownMultiplier": 0.25,
  "MaximumSlowdown": 0.1,
  "Mechanical": true
},
"Boss": {
  "DamageMultiplier": 0.25,
  "SlowdownMultiplier": 0.25,
  "MaximumSlowdown": 0.05,
  "Mechanical": true
}

Slowdown calculation:

Missing-health fraction = 1 − (Current HP / Maximum HP)

Slowdown =
minimum(MaximumSlowdown, Missing-health fraction × SlowdownMultiplier)

Mechanical affects weapon buildup. It does not change blood particle color.

Assigning creature profiles

Use EntityProfiles to assign a namespaced entity-code family to a profile.

Available profile names:

ordinary
fastprey
dangerous
rust
boss

Example entries:

"EntityProfiles": {
  "game:deer": "fastprey",
  "game:bear": "dangerous",
  "game:drifter": "rust",
  "game:eidolon": "boss",
  "yourmod:mammoth": "dangerous"
}

Merge your additions into the existing dictionary. Replace yourmod:mammoth with the creature’s actual entity code.

Family entries also match hyphen-separated variants. For example, game:deer matches deer variants, but not game:deerlookalike. If multiple entries match, the longest matching entry takes priority.

Particle settings

Particle colors and particle quantity per stack are currently built into the mod rather than exposed as configuration variables.

Quick tuning examples

• Make wounded deer easier to catch: raise FastPrey.MaximumSlowdown from 0.4 to 0.5.
• Reduce bleeding damage globally: lower DamagePercentPerStackPerSecond from 0.1 to 0.05.
• Require more hits for additional stacks: raise BuildupThreshold from 100 to 150.
• Protect large enemies further: lower Dangerous.DamageMultiplier from 0.5 to 0.25.
• Reduce trail frequency: raise BloodTrailIntervalSeconds from 0.5 to 1.0.

• Built and tested against Vintage Story 1.22.7.
• Works in single-player and on dedicated servers.
• Server-side installation; multiplayer clients do not need a separate installation.
• No additional mod dependencies.

---

Created by DAplayerGAMES • Progressive Bleeding 1.6.0