Back to mods
Community Fluid API project artwork

CurseForge · Minecraft mod

Community Fluid API

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

Choose a version Pick your version below, then grab the matching file.

Quick answer

Which Community Fluid API release should I use?

Updated 2 months ago
beta file cfa-0.4.0.jar
Game version 26.1.2
Loader NeoForge

Community Fluid API cfa-0.4.0.jar targets 26.1.2 with NeoForge. The project page does not say whether this file belongs on the client, dedicated server, or both. No extra mods listed for this file.

Where it goes

Is Community Fluid API required on the client, server, or both?

The project page does not say whether this file belongs on the client, dedicated server, or both.

Client Source doesn’t say
Dedicated server Source doesn’t say
Loader for this release NeoForge
Required install it here Optional supported, not mandatory Not supported do not install here Source doesn’t say do not assume

The source does not explicitly classify this release as client-only or server-only.

What else does Community Fluid API cfa-0.4.0.jar need?

cfa-0.4.0.jar. Change the file and its required mods may change too.

No extra mods listed for this file

This file does not list any required mods. Do not add a library just because a different file uses it.

This file does not list any required or optional mods.

Before you install it

Add Community Fluid API without breaking your instance.

Built for Community Fluid API cfa-0.4.0.jar. Pick another file and the loader, install side or required mods may change.

  1. 01

    Stick to this file

    Use cfa-0.4.0.jar. It targets 26.1.2 with NeoForge; another release may have different loader, side or dependency requirements.

  2. 02

    Bring the mods it needs

    This file does not list any required mods. Do not add a library just because a different file uses it.

  3. 03

    Put it on the correct side

    The project page does not say whether this file belongs on the client, dedicated server, or both.

  4. 04

    Pick the file you checked

    Use the “Get this file” button beside cfa-0.4.0.jar. It opens that exact file at the source.

About this project

What does Community Fluid API add?

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.

Project description from CurseForge.

Pick your setup

Community Fluid API by Minecraft version and loader

Choose the version and loader you play, then open the matching release.

1 available setups

Check the dependencies, then try the file in a copied instance before changing a world you care about.

Recent files

Community Fluid API versions and loaders

5 of 5 releases match

Looking for an older file? The official CurseForge project page is in Resources.