Skip to content

Community Fluid API

A from-scratch community reimplementation of the (discontinued) NeoForge Fluid API.

NeoForge
Loaders
NeoForge
Downloads on Modrinth
137
Followers on Modrinth
0
versions
5
Updated
September 7, 2026Sep 7
Published
in 2026
This is a library — other mods need it, and it adds nothing to the game by itself

At a glance

A library: other mods need it
Runs on NeoForge
For Minecraft 26.1.2
Needed in the game and on the server
Latest version — 0.4.0 from September 7, 2026
License CC-BY-SA-4.0 — free
Where it's needed
In gamerequiredOn serverrequired

Needed both in the game and on the server

Game versions26.1.2

TL;DR: As of Minecraft 26.1, the NeoForged team has officially retired the (Neo)Forge Fluid API... and replaced it with nothing. This mod is a community-developed, from-scratch reimplemention of that API designed to make adding fluids as painless (and collision-free) as it used to be. WIP.


If you don't know what that means, or want some details, here's the longer version:

Wonder why entities are walking through your fluids like they aren't there? Why your fluids don't glow when you tell `em to, they don't push you around, they make mobs path weird, conduits don't work in `em, etc., even though you set everything up in your FluidType class? That's because the (Neo)Forge Fluid API has been discontinued - as of MC 26.1, Neo no longer ships with an implementation*. If you want your fluids to "just work", you're going need something that takes that API and makes the game actually pay attention to it. That's where this API comes in—it's a (more-or-less) drag-`n-drop replacement for the old Forge implementation, written from scratch by community members for MC 26.1.2!

It does make a few changes, and extend on the old functionality:

  • isWaterLike is now deprecated. Instead, a variety of more targeted methods have been patched in
  • You are now required to tag your fluids (the fallback behavior substitutes water, but reusing a vanilla tag causes most of the Fluid API to be ignored)
  • The following methods have been patched in: #getTag, #reducesMiningSpeed, #canSpawnAquaticMobs, #canFish, #getFishingLootTableKey, #entityCanStandOn, #shouldSplash, #createSplashParticleOnClient, #createSplashParticleOnServer, #createWakeParticleOnServer, #makesWet, #hasUnderWaterMusic, #conduitCompatible, #slowsProjectiles, #getInertia, #triggersRipTide, #preventsBurning, #affectsVehicle
  • For convenience, colorless, tintable versions of the vanilla splash and wake particles have been provided (by default, these are tinted the same color as your fluid and substituted for their vanilla counterparts)

Documentation is a work in progress; in the meantime, see the community-maintained documentation for the old (Neo)Forge API:


*Well, most of the old API is no longer implemented, and the NeoForged team plans to continue phasing out the rest.

FAQ

How to install Community Fluid API?

Install NeoForge for your Minecraft version, download Community Fluid API for the same version and loader, put the file into the mods folder and launch the game with the loader profile.

Which Minecraft versions does Community Fluid API support?

Community Fluid API has builds for Minecraft 26.1.2.

Is Community Fluid API needed on the server?

Needed in the game and on the server

License and source
Creative Commons Attribution Share Alike 4.0 Internationalfree to share with credit to the author and the license
Original — Modrinth↗Files unchanged, verified with SHA-512Is this your mod? For rights holders

The site uses cookies: the necessary ones for sign-in and the theme, plus the Yandex Metrica and LiveInternet visit counters — they show us how the site is used. We have no advertising cookies. More