Fluidlogged API
🟡 Updated this year⚠️ Install Order · 2 steps
Install in this order, then this mod last — most mods fail to load without their framework and dependencies in place.
🖼️ Gallery (5 images)
🔍 Analysis
- 👍 0.0% endorsement rate
- 🏆 #146 of 403 forge mods in this game by downloads
📋 About This Mod
## A library mod that adds highly customizable fluidlogging to 1. 12. 2!
Fluidlogging is a mechanic that's inspired by Vanilla's (https://minecraft.wiki/w/Waterlogging) mechanic, and that functions very similarly. The main difference is that Fluidlogged API has support for non-source fluids and all modded fluids!
[!(https://cdn.jsdelivr.net/npm/@intergrav/devins-badges@3/assets/compact/available/curseforge_46h.png)](https://www.curseforge.com/minecraft/mc-mods/fluidlogged-api) [!(https://cdn.jsdelivr.net/npm/@intergrav/devins-badges@3/assets/compact/available/modrinth_46h.png)](https://modrinth.com/mod/fluidlogged-api)
If you're a modpack developer wanting to add Fluidlogged API to a modpack distributed outside of CurseForge or Modrinth, use (https://modrinth.com/mod/filedirector) to avoid reuploading Fluidlogged API's files.
Any blocks can be made fluidloggable or non-fluidloggable through Fluidlogged API's configs, however it does make (https://github.com/jbredwards/Fluidlogged-API#fluidloggable-blocks) fluidloggable by default. Any properly coded modded variants of these blocks are supported by default. Mods may also add fluidloggable blocks from their end. To see the full list of fluidloggable blocks, run the /fluidlogged_api print command in-game to create text files containing all active fluidlogging information.
Along with this, Fluidlogged API will download and apply (https://github.com/jbredwards/Fluidlogged-API-Configs)! This is to minimize the amount of work that players must do to have complete fluidlogging across mods, but this behavior can be fully disabled in fluidlogged_api/general.cfg if desired.
Fluidlogged API also heavily improves fluid collision accuracy, and fixes various Vanilla and modded fluid-related issues. Some Vanilla bug fixes include: - (https://bugs-legacy.mojang.com/browse/MC-2591) Walking over the corner of lava deals damage - (https://bugs-legacy.mojang.com/browse/MC-4533) Water graphical glitch when connecting diagonally - (https://bugs-legacy.mojang.com/browse/MC-68129) Smooth lighting doesn't work properly underwater - (https://bugs-legacy.mojang.com/browse/MC-100886) Falling sand with ID of water or lava does not render - (https://bugs-legacy.mojang.com/browse/MC-125771) Block selection not showing up underwater - (https://bugs-legacy.mojang.com/browse/MC-127030) Flowing water attempts to connect to waterlogged blocks when it shouldn't - (https://bugs-legacy.mojang.com/browse/MC-127108) Waterlogged blocks turn lava into obsidian or cobblestone on physically unconnected sides - (https://bugs-legacy.mojang.com/browse/MC-127270) Visual water level inside waterlogged blocks does not adjust correctly - (https://bugs-legacy.mojang.com/browse/MC-227302) Smooth lighting doesn't work properly on the water surface
| Known Incompatibilities | Known Solutions | | --- | --- | | Better Water Mesh | None. | | Corail Tombstone | Use Corail Tombstone v4. 6. 0 or later! | | Oceanic Expanse | Use Oceanic Expanse v1. 2. 0 or later! | | Phosphor | Use (https://modrinth.com/mod/alfheim-lighting-engine) or [燐/Hesperus](https://www.curseforge.com/minecraft/mc-mods/hesperus) instead! | | The Aether II | Phosphor comes bundled with The Aether II. Luckily there exists (https://www.curseforge.com/minecraft/mc-mods/the-aether-ii-phosphor-not-included), which does as the name suggests! | | Vintagium | Use (https://github.com/kappa-maintainer/Celeritas-auto-build/releases) instead! |
How does this mod work?
Reading through the (https://github.com/jbredwards/Fluidlogged-API) would be the best way of truly understanding the inner workings of this mod, but I'll describe a simplified version here: For each block in the world, Vanilla has two features that get stored in each chunk: a required `IBlockState` and an optional `TileEntity`. Fluidlogged API adds a third feature that gets stored in each chunk: an optional `FluidState`, which stores the fluidlogged fluid if present.
This mod applies (https://asm.ow2.io) (a bytecode manipulation library that's bundled with Forge) to allow Vanilla and Forge to properly read and make use of `FluidStates`.
Is this mod safe to add to existing worlds?
It's generally a good idea to always back up your worlds before adding any new mods. That being said, this mod doesn't change the behavior of `IBlockStates`, so adding it to existing worlds should be fine! Removing this mod from existing worlds should also be fine, just note that existing `FluidStates` will be rem
📊 Mod Details
- Game
- Minecraft Mods
- Author
- jbredwards
- Version
- 3.3.3
- Downloads
- 223,566
- Endorsements
- 53
- Category
- forge
- Created
- 6/13/2023
- Updated
- 7/16/2026
- Game Versions
- 1.12.2
- Tags
- game-mechanics, library, utility
🔧 How to Install Minecraft Mods Mods
Download from Modrinth. Use Prism Launcher or drop into your mods folder.
📖 Full step-by-step install guide for Minecraft Mods →
Visit the official mod page for specific installation instructions for this mod.
🎮 Need cheat codes or console commands? Check ur gaming wiki for Minecraft Mods commands, item IDs, and more.
❓ Frequently Asked Questions
Which Minecraft Mods versions does Fluidlogged API support?
The author lists 1.12.2. Other versions may work but are untested by the author.
What is the latest version of Fluidlogged API?
Version 3.3.3, published 2026-07-16 with 223,566 downloads recorded at the source.
Keep browsing — more Minecraft Mods mods await