Community Fluid API

Community Fluid API

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

by
7 Downloads
neoforgelibrary
Rent Server with this Mod

About this Mod

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.

Available Versions

Community Fluid API 0.3.1beta
MC 26.1.2neoforge
June 15, 2026
Community Fluid API 0.3.0beta
MC 26.1.2neoforge
June 15, 2026
Community Fluid API 0.2.0beta
MC 26.1.2neoforge
June 11, 2026
Community Fluid API 0.1.0beta
MC 26.1.2neoforge
June 8, 2026

How to Install Community Fluid API on Your Server

1

Order Server

Order a Minecraft Java server with at least 3 GB RAM (4 GB recommended).

2

Set neoforge Loader

In the panel under "Egg", select the neoforge loader and matching Minecraft version (26.1.2).

3

Install Mod

Open the mod browser in the dashboard and search for "Community Fluid API". Click "Install" – done! Alternatively, upload the .jar via SFTP to the /mods folder.

Compatibility

Mod Loaders

neoforge

Minecraft Versions

26.1.2

Server-side

Required

Recommended RAM

4 GB(min. 3 GB)

Frequently Asked Questions

Community Fluid API server crashes on startup – what to do?

Most common cause: wrong neoforge version or insufficient RAM. Check the server log (latest.log) for "OutOfMemoryError" or "Mixin" errors. With Mado Hosting: ensure at least 3 GB RAM is allocated and the loader matches the mod version (26.1.2). You can switch loaders with one click in the panel.

Is Community Fluid API compatible with neoforge?

Community Fluid API officially supports neoforge for Minecraft 26.1.2. The Mado dashboard automatically detects incompatible loader combinations.

Server lagging with Community Fluid API – how to optimize performance?

Recommended RAM: 4 GB (per 8 players). Use /spark profiler to check if Community Fluid API consumes the most tick time. Common fixes: reduce server view-distance to 8-10, install "performant" or "starlight" as supplementary mods on Forge. With Mado Hosting, your server runs on NVMe SSDs with dedicated CPU cores for minimal latency.

Rent Modded Server

Install Community Fluid API with just one click on your server.

Recommended RAM
4 GBfrom €8/mo
Minimum 3 GB | per 8 players
Create Server Now
1-Click Mod Install
NVMe SSD Storage
DDoS Protection included

Details

License
Creative Commons Attribution Share Alike 4.0 International
Server-side
Required

Supported Versions

26.1.2