BloodVFX

Vanilla blood is a short-lived flat effect. BloodVFX adds HDRP blood presentation that can land on nearby geometry, remain on a moving body, and pool where a body falls. It changes presentation only; it does not change damage or combat rules.

The standalone plugin automatically presents blood for supported player damage and death callbacks. Other mods can use its small public API to add creature, weapon, or finisher blood without shipping a second decal system. Installing the DLL alone does not automatically hook every creature or every modded damage path.

Gameplay previews

What you get

• Player wound decals - projected onto the player mesh and carried through movement and ragdoll instead of floating in world space.
• World splatter - nearby walls, floors, and props can receive decals at the actual impact direction.
• Death pooling - supported deaths can leave a puddle where the body lands.
• Creature and finisher channels - consuming mods can request tinted body blood, environment splatter, and dedicated decal budgets through the API.
• Bounded presentation - separate caps, event throttling, viewer-distance gating, and recycled-decal fading prevent an entire round from accumulating unbounded effects.

BloodVFX adds no items, enemies, or RPCs. It draws client-local effects from events that the game or a consuming mod already synchronized. Installing it on every client gives the crew consistent visuals, but gameplay does not depend on those visuals.

Optional integrations

• LethalCCTV - persistent blood remains visible when a camera pans back through a corridor.

Other mods can reference the public API and choose their own tint, origin, direction, body target, and event timing. This assembly owns the shared decal budgets and cleanup lifecycle.

Required dependency

• BepInEx-BepInExPack-5.4.2305

BloodVFX does not require Y4NGZCore, Contracted, or LethalCCTV.

Configuration and migration

BepInEx/config/com.y4ngz.bloodfx.cfg contains the master switch, world/player/ creature/finisher decal caps, intensity, recycled-decal fade time, per-player event rate, viewer distance, vanilla-pool suppression, room-material decal handling, and diagnostics.

Body-decal dimensions are selected by the runtime profile and are not exposed as configuration settings.

If you previously used the merged Y4NGZ Company package, the 08 - Blood FX section is imported into this file once on first run. Remove the old merged package so two copies of the presentation system cannot load together.

Generative AI usage

The entire code base of this mod was created with generative AI.

Troubleshooting

When reporting a visual problem, include BepInEx/LogOutput.log, whether the target was a player or creature, the source of the damage, and whether the missing effect was a burst, body decal, world splatter, or puddle.

Asset used

• https://assetstore.unity.com/packages/vfx/particles/spells/realistic-blood-vfx-blood-effects-blood-blood-vfx-334130