Simple Blood

<div align="center"> !(https://cdn.modrinth.com/data/cached_images/b6e93d6ab422e767e10e6a3e2207b244d603cd1e.png) <br> <img src="https://img.shields.io/badge/Environment-Client-9b59b6?style=for-the-badge" alt="Client"> <a href="https://modrinth.com/mod/modmenu"><img src="https://img.shields.io/badge/Config-Mod_Menu_+_Cloth_Config_API-1bd96a?style=for-the-badge" alt="Mod Menu"></a> <img src="https://img.shields.io/github/issues/Lythroo/Simple-Blood?style=for-the-badge&logo=github" alt="Issues"> <br> <br> <br> *Adds simple blood particles.* <br> When entities take damage, they bleed proportionally to the amount dealt. Weak hits create small, short splashes, while heavy hits result in dramatic blood bursts. Entities at low health slowly drip blood, and killing blows trigger larger death bursts. <br> (https://cdn.modrinth.com/data/cached_images/59496f4b454cbfb432f45bce418a880e628c4e6b.png)](https://ko-fi.com/lythro) <table> <tr> <td width="50%"> <div style="padding: 15px; background-color: #ffe6e6; border-radius: 8px; text-align: center;"> <a href="https://github.com/Lythroo/Simple-Blood/issues"><img src="https://img.shields.io/badge/Report-Issue-e74c3c?style=for-the-badge&logo=github" alt="Report Issue"></a> </div> </td> <td width="50%"> <div style="padding: 15px; background-color: #e6f2ff; border-radius: 8px; text-align: center;"> <a href="https://github.com/Lythroo/Simple-Blood/issues"><img src="https://img.shields.io/badge/Suggest-Feature-3498db?style=for-the-badge&logo=github" alt="Suggest Feature"></a> </div> </td> </tr> </table> </div> <br> <div align="center"> # Features </div> <div align="center"> ## Hit Burst + Death Burst + Bloodstains <img src="https://cdn.modrinth.com/data/cached_images/18a16cdf909aeaae4a1fb32cb7f8f13348393c78.jpeg"> </div> <br> <div align="center"> ## Blood in different colors <img src="https://cdn.modrinth.com/data/cached_images/f382b83d8f1519a3a21035fbe1cccbf661bc7c3c.jpeg" alt="Blood in different colors"> </div> <div align="center"> <br> ## Iron Golem Debris Particles <img src="https://cdn.modrinth.com/data/cached_images/d0ee53f95871a68dd71d8cf4401afa4c78b8aef3.jpeg" alt="Iron Golem Debris Particles"> </div> <div align="center"> ## Underwater Blood Fog <img src="https://cdn.modrinth.com/data/cached_images/05f1a86df455742e12eca492555aec44b716477e_0.webp" alt="Underwater Blood Fog"> </div> <br> <div align="center"> ## Everything's configurable <img src="https://cdn.modrinth.com/data/cached_images/3639cffeb21d96f24c3a5d6706cd9b1dabe973f6.jpeg" alt="Everything's Configurable"> <br> <br> ``` ...and many more features! ``` </div> <br> <br> ## Configuration > All effects are fully customizable through (https://modrinth.com/mod/modmenu) and (https://modrinth.com/mod/cloth-config). <br> ## For Mod Developers > Simple Blood exposes a client-side API to fully control blood behaviour for your > mod's entities. Call it from your **client initializer**. Everything you register > overrides the config and defaults; every option is optional, so you only set what > you want to change. ```java import com.bloodmod.BloodModAPI; // Registering by the raw id string works on every loader & MC version: BloodModAPI.registerEntityBlood("yourmod:custom_mob", new BloodModAPI.BloodSettings() .setColor(0xFF0000) // blood colour 0xRRGGBB (or setColor(r, g, b)) .setCanBleed(true) .setCanDripAtLowHealth(true) // continuous drip while wounded .setTransformToStains(true)); // ground stains + underwater fog // You can also register by EntityType: BloodModAPI.registerEntityBlood(YourEntities.CUSTOM_MOB, new BloodModAPI.BloodSettings() .setColor(0x8B0000)); ``` ### All `BloodSettings` options **Colour** - `setColor(int rgb)` / `setColor(int r, int g, int b)` — static blood colour. - `setColorProvider(Function<LivingEntity, Integer>)` — **dynamic** colour resolved per entity instance (e.g. follow an entity's tint or state). Return `null` to fall back. **Core behaviour** - `setCanBleed(boolean)` — whether it bleeds at all. - `setCanDripAtLowHealth(boolean)` — set `false` for constructs/undead. - `setTransformToStains(boolean)` — ground stains + water fog clouds. **Water & environment** - `setCreatesFogUnderwater(boolean)` — force the underwater-fog behaviour on its own. - `setParticlesDespawnInWater(boolean)` — particles vanish on water contact (snow-golem style). - `setBleedWhenAsphyxiating(boolean)` — opt back **in** to bleeding from drowning / suffocation / drying-out (Simple Blood suppresses those by default). **Amount, size & sound** - `setParticleSizeMultiplier(float)` — droplet size (1.0 = default). - `setBurstIntensityMultiplier(float)` — particles per hit/death. - `setDripIntensityMultiplier(float)` — low-health drip amount. - `setBloodSound(SoundEvent)` — custom blood sound. - `setSoundEnabled(boolean)` — per-entity sound


Adds simple blood particles.

When entities take damage, they bleed proportionally to the amount dealt. Weak hits create small, short splashes, while heavy hits result in dramatic blood bursts. Entities at low health slowly drip blood, and killing blows trigger larger death bursts.

[!(https://cdn.modrinth.com/data/cached_images/59496f4b454cbfb432f45bce418a880e628c4e6b.png)](https://ko-fi.com/lythro)

## Hit Burst + Death Burst + Bloodstains

## Blood in different colors

## Iron Golem Debris Particles

## Underwater Blood Fog

## Everything's configurable

``` ...and many more features! ```

## Configuration

> All effects are fully customizable through (https://modrinth.com/mod/modmenu) and (https://modrinth.com/mod/cloth-config).

## For Mod Developers

> Simple Blood exposes a client-side API to fully control blood behaviour for your > mod's entities. Call it from your client initializer. Everything you register > overrides the config and defaults; every option is optional, so you only set what > you want to change.

```java import com.bloodmod. BloodModAPI;

// Registering by the raw id string works on every loader & MC version: BloodModAPI.registerEntityBlood("yourmod:custom_mob", new BloodModAPI. BloodSettings() .setColor(0xFF0000) // blood colour 0xRRGGBB (or setColor(r, g, b)) .setCanBleed(true) .setCanDripAtLowHealth(true) // continuous drip while wounded .setTransformToStains(true)); // ground stains + underwater fog

// You can also register by EntityType: BloodModAPI.registerEntityBlood(YourEntities. CUSTOM_MOB, new BloodModAPI. BloodSettings() .setColor(0x8B0000)); ```

### All `BloodSettings` options

Colour - `setColor(int rgb)` / `setColor(int r, int g, int b)` — static blood colour. - `setColorProvider(Function)` — dynamic colour resolved per entity instance (e.g. follow an entity's tint or state). Return `null` to fall back.

Core behaviour - `setCanBleed(boolean)` — whether it bleeds at all. - `setCanDripAtLowHealth(boolean)` — set `false` for constructs/undead. - `setTransformToStains(boolean)` — ground stains + water fog clouds.

Water & environment - `setCreatesFogUnderwater(boolean)` — force the underwater-fog behaviour on its own. - `setParticlesDespawnInWater(boolean)` — particles vanish on water contact (snow-golem style). - `setBleedWhenAsphyxiating(boolean)` — opt back in to bleeding from drowning / suffocation / drying-out (Simple Blood suppresses those by default).

Amount, size & sound - `setParticleSizeMultiplier(float)` — droplet size (1. 0 = default). - `setBurstIntensityMultiplier(float)` — particles per hit/death. - `setDripIntensityMultiplier(float)` — low-health drip amount. - `setBloodSound(SoundEvent)` — custom blood sound. - `setSoundEnabled(boolean)` — per-entity sound

🤖 AI-enhanced — based on mod data