Blood System

Stupidly exaggerated blood visuals! When a bullet physically exits a sosig, it projects blood from the exit wound onto any surface behind it — walls, floors, other sosigs. Real penetration detection means blunt hits, armored stops, and ricochets produce nothing.

Effects

• Splash — Raycast-based blood dots projected from the exit wound. Spread pattern sampled from included blood PNGs. Each dot gets individual brightness from noise.png (10 levels, 0.7–1.0 range) so the splatter looks dimensional rather than flat. Dots scale with distance and stretch along the bullet path.
• Spray — Quick particle burst at the exit wound. Gib explosions fire a 360° burst with lifetime and velocity scaled to bullet entry speed.
• Drip stain — Vanilla sosig blood drip particles are hooked at runtime. When a drip lands on a static surface (floor, wall) it spawns a cluster of blood drops with a smoothstep soft edge. Drips landing on dynamic objects (guns, other sosigs, moving RBs) are skipped.

Blood color

Blood color is read from the sosig's actual body color, not hardcoded. Priority order:

1. Color Override (if set) — see below, applied before or after NGA depending on Soft/Hard mode.
2. NGA SosigIntegrity config — if the NGA Sosig Integrity mod is installed, the plugin reads that sosig's configured body color directly from its config values (Mustard Colour hex string, Ketchup bool).
3. Sosig.Mustard field — the vanilla per-instance color H3VR assigns to each sosig.
4. Fallback — default mustard yellow if neither is available.

This means alien-colored sosigs from custom scripts, and any sosig whose color NGA overrides, will bleed the right color automatically.

Color Override

Set a custom blood color instead of each sosig's natural color, using Color Override (hex, e.g. #8C1A1A) and Color Override Mode:

How it works

• Blunt hit / ricochet / armor deflect / faceshield → no splatter
• Bullet punches through and continues → splatter on whatever is behind the exit wound
• Splatter direction and animation speed follow bullet exit speed and direction
• Segment explosions fire blood in all directions
• Splash stains on dynamic rigidbodies (dropped guns, ragdolled gibs) are parented to that object and move with it — stains won't float in the air after the body falls
• Drop custom blood shape PNGs or a greyscale noise PNG into the plugin folder and they are loaded and normalized at startup automatically

Config

All settings in F1 (ConfigurationManager) or the .cfg file in BepInEx/config.

Aiyke Compatibility

The "Aiyke code mod pack" rewrites bullet-penetration physics, which can make this mod's splatter almost never appear if left unhandled. If Aiyke is detected, this mod automatically removes Aiyke's own penetration-physics and output-damage-multiplier patches on startup, so this mod's normal precise penetration detection runs as intended. In exchange you lose Aiyke's "Modified bullet penetration" and "Output damage multiplier" features specifically — its other features (aim assist, red blood, enemy alertness, hit sounds, etc) are untouched.

No config needed — this is automatic whenever Aiyke is installed, and does nothing if it isn't.

Performance Tips

Blood only spawns from bullets fired by the player — sosig-vs-sosig gunfire never triggers blood effects, since that crossfire is what causes the worst frame spikes in big fights. This is automatic, no config needed.

Splash is the most CPU/GPU intensive effect. If you are dropping frames, apply these fixes in order of impact.

Highest impact

1. Switch Projection Mode to Immediate

The default Animated mode keeps a live particle system running with thousands of in-flight dots. Immediate removes all flight animation — dots appear the instant the bullet exits. This is the single biggest FPS win. No visual difference in stain placement, only the flying animation is removed.

2. Reduce Max rays per shot

Default 3000 is high. Try 1000 or 500. Below ~200 the splatter starts to look sparse. This directly controls how many raycasts happen per shot and how many dot quads build up per second.

Moderate impact

3. Reduce Lifetime seconds

Fewer accumulated stain meshes = fewer draw calls per frame across a long fight. 10–15 seconds keeps the scene looking fresh without piling up hundreds of meshes.

4. Reduce Gib Ray Count

Segment explosions fire rays in 360°. High gib fights (shotguns, explosives, multiple sosigs) multiply this cost fast. Cutting from 200 to 100 helps significantly in those scenarios.

Lower impact

5. Reduce Dot Max Scale

Smaller maximum dot size = less GPU fragment overdraw from large-radius quads at range.

6. Reduce Range metres

Caps the maximum raycast distance. Combined with reduced Max rays per shot, limits the worst-case cost per shot.

Low-end preset

Projection Mode = Immediate, Max rays per shot = 500, Lifetime seconds = 10, Gib Ray Count = 100

Credits where it's due

THANK YOU tosiek and VRVoyager for the awesome icon and video!

3.4.1

• fixed :)

3.4.0

• Now works with thermals. Blood temperature starts at 36°C and slowly cools down to 20°C.

3.3.4

• Fixed splatter not appearing on penetrating hits, especially headshots — rays now pass through the sosig instead of stopping on it.

3.3.3

• Version bump only.

3.3.2

• Aiyke Compat Mode config removed — Override is now always used when the Aiyke code mod pack is detected. Aiyke's other features are untouched.
• New defaults from testing: Dot base radius 0.008, Range 40m, Dot Scale Range 50m, Spray Enabled on.

3.3.1

• Fixed Aiyke Compat "Override" silently doing nothing due to a startup crash.

3.3.0

• Fixed splatter being permanently invisible on some installs.
• New config: Splatter, Spray, Vanilla Particle Staining, and Blood Drip Stains can be toggled independently.
• New config: Aiyke Compat Mode.

3.2.7

• New config (default off): Splash On Human-mod Humans.
• Fixed drip stains floating in mid-air around Human-mod humans.

3.2.6

• Fixed spray particles staying red when blood color was set to mustard-yellow.

3.2.5

• Onslaught Mode interop (if installed): dead sosigs settle before disappearing, plus a fix for a crash when several died at once.

3.2.4

• Fixed blood defaulting to red instead of mustard-yellow, and Color Override doing nothing while Mode was Unset.

3.2.3

• Minor fix

3.2.2

• Minor fix

3.2.1

• Minor fix

3.2.0

• New config: Color Override / Color Override Mode — Soft keeps NGA-set colors (e.g. zombies), Hard overrides every sosig.
• Performance: blood only triggers for player-fired bullets, cutting frame spikes in large firefights.

3.1.0

• Fixed icon.png being used as a blood splatter shape.
• Penetration detection upgraded — armor and faceshields now correctly produce zero blood.
• Per-dot brightness variation so splatter looks dimensional instead of flat.
• Blood and noise textures normalized at load — drop in any custom image and it matches.
• Drip stains upgraded: soft edges, angle-based streaks, and wounds that keep dripping after penetration.
• Spray upgraded to three layers: outer mist, mid blobs, inner drops.
• Spray particles can leave stains on static surfaces.
• New config: Max shot groups, Max drip stains.

3.0.0

• Complete rewrite — no performance spikes, no audio issues
• Blood splatter projected from bullet exit wounds using penetration detection
• Animated mode: dots fly from wound to wall before settling
• Natural spread pattern sampled from included blood PNG images
• Dots scale with distance and stretch along the bullet path
• Blood spray particle burst from exit wound on penetration
• Segment explosion blood spray in all directions, scaled by bullet entry speed
• Blood drips from wounds
• Configurable projection mode (Animated / Delayed / Immediate), speed, dot scale, ray counts, and lifetime

1.0.0

• Initial release
• Wall splatter spawns when a bullet physically exits a sosig and hits a surface behind it
• Uses actual bullet penetration state — blunt damage and ricochets produce no splatter
• Splatter size and lifetime configurable via F1 or .cfg