Blood Bits: Flow

Pixel blood that behaves like a liquid. Hits spray drops that fly through the air, land on floors, walls, ceilings and plants, grow into puddles, spill over edges, run down walls, drip from ceilings, dissolve in water and wash away in rain. Creatures, players, armour, weapons and items keep the blood they catch until it is washed off. Formerly BloodMarks.

Blood Bits: Flow is available for Forge 1.20.1 and NeoForge 1.21.1. Both editions have the same features unless a feature is marked as Forge- or NeoForge-only.

Features

Blood in the world

• Drops fly freely in a cone. Harder blows throw them farther, up to the Spray reach you set.
• Pools, stains and runoff form on supported block surfaces. Blood falls when the block under it breaks, and it fades over time.
• Blood on most blocks is part of the block's own model, so shader packs light it with the block and sway it with waving plants.
• A blood cloud rises from the wound, landing drops burst into flecks, and blood on ceilings can fall in streams.
• Bloods of different colours mix where they meet.
• Automatic texture filters keep flame and liquid regions clean while solid parts of mixed textures still take blood. Detected glass panels collect blood.
• Sounds use the game's own wet sounds, with subtitles.

Bodies, armour and items

• Wounds stay where the blow landed. A player's blows land where the crosshair was, also with Epic Fight's camera.
• Blood stays on armour, elytra, horse armour, held items, thrown tridents, dropped and framed items and inventory icons. NeoForge only: wolf armour.
• Bodies and gear pick up soil, mud, sand, dust and snow from the ground, frost when freezing, soot from fire and lava, and falling snow. They get wet in water and rain and dry from the top down.
• Stained and dirty items still stack with clean items of the same kind.
• Wounded creatures drip blood when their health is low.
• Clean skin areas: paint the parts of your skin that never take blood or dirt.

Washing

• Water and rain wash blood and dirt away over time.
• Sneak + Use with a water bucket or water bottle aimed into the air pours it over your head. Sneak + Use with an empty hand on a water cauldron washes your face. Held to the end, both wash your body, armour, accessories and held items; let go early and the water is kept.
• Splash potions wash every player and mob they reach.
• Water drops from dripstone and ceilings wet the spot they land on; lava drops leave soot.

Creatures' blood

• Blood colours per creature, and creatures that do not bleed, set by data packs (data/<namespace>/bloodmarks/blood_types/) or in game.
• Modded creatures without a profile can use the blood of a similar vanilla creature.

Languages

• English, Russian and Ukrainian.

Installation

• Put the matching JAR in the mods folder of the client and of the server. Both sides need the same Blood Bits: Flow version.
• No other mod is required. Remove older Blood Bits: Flow JARs before updating.
• Do not open Minecraft 1.21.1 worlds with Minecraft 1.20.1.

Configuration and settings

Open the mod's menu from Mods → Blood Bits: Flow → Config, or with the bloody gear at the top left of the pause menu.

• On this computer: blood effects, dirt and wetness, and drip sounds can be switched on or off.
• Blood on Creatures, Blood in the World, Dirt and Water: every option as the game's own buttons and sliders, with tooltips. Each page has Reset to Defaults, which asks before it resets that page. These settings can be changed on the title screen and in your own single-player world; on a server they show the server's values.
• Creatures' Blood: for each creature, set bleeding to automatic, on or off, and pick its blood colour with RGB sliders or a hex code. Mob pixels… shows the mob in 3D beside its textures, so you can paint where blood and dirt may land.
• Textures and Items: the Textures tab is a texture rules editor with a pixel brush (Clean, Stains or Auto), zoom and pan. On the Items tab, the item editor shows the item in 3D (in the inventory, in the hand or placed in the world) beside its textures, and you can paint on either. The Rules tab removes what was painted.
• Clean Skin Areas: opens once when you first join a world, and later from this menu.
• Pour items: every item in a searchable grid. Click an item to allow or forbid pouring it over yourself.
• Shared settings are saved in config/bloodbits_flow/server-settings.toml and used by every world, so you set them once. On a server, the server's settings apply. Creatures' blood and texture rules are edited inside a world, by its single-player owner or by a server operator. Pour items can be changed on the title screen and in your own world, like the option pages.
• Colour changes apply to new stains. Turning bleeding off for a creature stops new blood and hides the blood on its body; stains already in the world and on items stay.

Compatibility

Optional integrations:

• Epic Fight: blood and dirt on its models, its first-person arms and held items; washing animations; wounds follow its camera aim.
• Curios: accessories in functional and cosmetic slots catch blood and dirt and keep them when taken off.
• Create: blood on moving parts such as water wheels, blood riding on belts, and fan washing that cleans items and creatures.
• Sodium (NeoForge, 0.8.13 or newer within 0.8.x) and Embeddium (Forge): bloody mobs keep their fast rendering.
• Shader packs: Iris on NeoForge and Oculus on Forge, checked with Photon.
• Lithium (NeoForge, 0.15.4 or newer within 0.15.x): blood stays on items that its hoppers merge.
• Spore: blood on its custom armour parts and held models.

Notes:

• Unusual models, custom renderers and resource packs may need adjustments. Texture rules in the settings handle textures the automatic filters get wrong.
• Known issue (NeoForge): without a shader pack, blood and dirt on items do not show in the hotbar.
• The mod ID is bloodbits_flow. Saved data and resources use the bloodmarks namespace. The API is dev.bloodbits.flow.api.BloodBitsApi.

Credits and licence

The original parts of Blood Bits: Flow are All Rights Reserved. You may download the mod from its official pages, use it, and include it in modpacks as the platform allows.

Thanks to iron431 for Iron's Simple Blood, the starting point of this mod's ground stains. Versions up to and including NeoForge 2.9.1.1 and Forge 2.9.1.2 contained MIT-licensed material from it: code adapted from its ground-decal particle, and two drop textures. Those files keep its MIT notice. From 2.10.0 on, the mod contains none of it: the particle was written anew and the textures were removed.

The Forge edition bundles MixinExtras 0.5.0 by LlamaLad7 under the MIT License; its licence is inside the bundled JAR. Each Blood Bits: Flow JAR contains LICENSE and THIRD_PARTY_LICENSES.md.

Development disclosure

Much of the mod's code was created using generative AI, including Claude and Codex, under the project owner's direction. Some textures, such as the blood on the mod's buttons and the pause-menu gear, were drawn by scripts written the same way. The project icon is also AI-generated. Third-party work is credited separately above.

Gallery images are unmodified in-game screenshots supplied by the owner.