Reservoir Fluid API

Description

This is a lib mod intends to make creating fluids in Fabric easier.

Features

Registry

• Customized fluid registry
• Less overrides through ExtendedFluid
• Customize properties with a single FluidSettings object

Behaviors & Interactions

• Supports flowing upwards
• New data-driven fluid reaction system
• Able to create different types of bucket and make them stackable
• Entity movement no longer requires tags
• Customizable submerging fog
• More fluid related features...

Developing Guide

Modrinth Maven

1. Add the Modrinth Maven repo by following the official tutorial
2. Optional: Download the sources jar for javadoc supports
3. Add follow lines under dependencies in your build.gradle file: modImplementation 'maven.modrinth:rfapi:VERSION'
4. Replace the VERSION to a proper version number
5. Refresh the project

Manually

1. Create a libs folder under your project base dir
2. Put the mod jar file into the folder and rename it to rfapi.jar
3. Optional: Download the sources jar for javadoc supports
4. Add follow lines under dependencies in your build.gradle file: modImplementation(file('libs/rfapi.jar'))
5. Refresh the project

Q&A

• Q: Why do you make this?
  A: I found difficult working on fluids under Fabric, so I made some tricks and they work surprisingly well. And later on I decided to make it a sepereate lib mod so I can use it among multiple projects.
• Q: WTF is this name for?
  A: Reservoir is a place to store water to help peoples, and this is a lib helping devs creating water(all types of fluids actually), so here it is(still nonsense but whatever lol).
• Q: Will there be a Forge/NeoForged version?
  A: No.
• Q: What about other versions?
  A: When it got out of pre-release era, I would probably port it to other major versions, but not now.

License

This project is licensed under LGPL v2.1 or later.
© 2026 redColmula55
Not an official Minecraft product. Not approved by or associated with Mojang.