## A library mod that adds highly customizable fluidlogging to 1.12.2! This mod is licenced under All Rights Reserved. If you're a modpack developer wanting to add Fluidlogged API to a modpack distributed outside of Modrinth, use [File Director](https://modrinth.com/mod/filedirector) to avoid reuploading Fluidlogged API's files. Fluidlogging is a mechanic that's inspired by Vanilla's [Waterlogging](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! --- **Any** blocks can be made fluidloggable or non-fluidloggable through Fluidlogged API's configs, however it does make [certain types of blocks](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 [community configs](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: - [MC-2591](https://web.archive.org/web/20250115021221/https://bugs.mojang.com/browse/MC-2591) *Walking over the corner of lava deals damage* - [MC-4533](https://web.archive.org/web/20250112045540/https://bugs.mojang.com/browse/MC-4533) *Water graphical glitch when connecting diagonally* - [MC-68129](https://web.archive.org/web/20250115013323/https://bugs.mojang.com/browse/MC-68129) *Smooth lighting doesn't work properly underwater* - [MC-100886](https://web.archive.org/web/20250112072219/https://bugs.mojang.com/browse/MC-100886) *Falling sand with ID of water or lava does not render* - [MC-125771](https://web.archive.org/web/20250112075758/https://bugs.mojang.com/browse/MC-125771) *Block selection not showing up underwater* - [MC-127030](https://web.archive.org/web/20250112075951/https://bugs.mojang.com/browse/MC-127030) *Flowing water attempts to connect to waterlogged blocks when it shouldn't* - [MC-127108](https://web.archive.org/web/20250112075958/https://bugs.mojang.com/browse/MC-127108) *Waterlogged blocks turn lava into obsidian or cobblestone on physically unconnected sides* - [MC-127270](https://web.archive.org/web/20250112080013/https://bugs.mojang.com/browse/MC-127270) *Visual water level inside waterlogged blocks does not adjust correctly* - [MC-227302](https://web.archive.org/web/20250112102937/https://bugs.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 [Alfheim](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 [The Aether II: Phosphor Not Included](https://www.curseforge.com/minecraft/mc-mods/the-aether-ii-phosphor-not-included), which does as the name suggests! | | Vintagium | None. However, a fix is being worked on! | --- ### Q / A:

How does this mod work?

Reading through the [source code](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 [ASM](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 removed and won't be recoverable upon doing so.

How do I use this mod's configs? How do I use this mod as a dependency?

This mod's [wiki](https://github.com/jbredwards/Fluidlogged-API/wiki/Config) will eventually cover both of those topics, for now it only covers how to use this mod's config. If you want to use Fluidlogged API as a library (optional or required dependency), the best I can do until I finish the wiki is reference you to the source code of these other projects of mine: [Campfire](https://github.com/jbredwards/Campfire-Mod/blob/cb51416142ce7845e62240f475183ab5fcf09ebd/src/main/java/git/jbredwards/campfire/common/block/AbstractCampfire.java#L88), [Seared Ladder Backport](https://github.com/jbredwards/Seared-Ladder-Backport-Mod/blob/1.12.2/src/main/resources/assets/searedladder/fluidlogged_api/whitelist.json), [Subaquatic](https://github.com/jbredwards/Subaquatic/tree/1.12.2).

What should I do if I run into any bugs, crashes, or mod incompatibilities?

Reporting anything you find to this mod's [issue tracker](https://github.com/jbredwards/Fluidlogged-API/issues) would greatly help me improve this mod! Without people generously taking the time to do so, this mod would not be where it is today!

--- ##### If you want fluidlogging for versions beyond 1.12.2, check out [Fluidlogged](https://modrinth.com/mod/fluidlogged) (not affiliated with Fluidlogged API) and [Towelette](https://modrinth.com/mod/towelette)! ##### This mod will not be ported.