
Community Fluid API
A from-scratch community reimplementation of the (discontinued) NeoForge Fluid API.
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:
isWaterLikeis 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:
- Example Mod (Now with 26.1.2 version!)
- Wiki
*Well, most of the old API is no longer implemented, and the NeoForged team plans to continue phasing out the rest.
Available Versions
How to Install Community Fluid API on Your Server
Order Server
Order a Minecraft Java server with at least 3 GB RAM (4 GB recommended).
Set neoforge Loader
In the panel under "Egg", select the neoforge loader and matching Minecraft version (26.1.2).
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
Minecraft Versions
26.1.2
Server-side
✓ RequiredRecommended 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.
Similar Mods
Rent Modded Server
Install Community Fluid API with just one click on your server.
Details
- License
- Creative Commons Attribution Share Alike 4.0 International
- Server-side
- Required