Botarium Mod (1.20.4) – Library for Transferring Fluids

Botarium is a crossplatform library mod that simplifies the transfer and storage of items, fluids, and energy for Minecraft mod developers, available for Fabric, Forge, and NeoForge loaders.

One of the biggest headaches in the Minecraft modding ecosystem is compatibility between mod loaders. A developer building a tech mod that handles items, fluids, or energy has to write completely different code for Fabric and Forge, which means double the work and double the bugs. Botarium solves this by providing a unified API layer that works across all major loaders. With over 5.7 million downloads since its release in November 2022, it has become one of the most widely depended-upon library mods in the Minecraft community. Created by Terrarium — the same team behind popular mods like Ad Astra and Chipped — Botarium is the invisible backbone powering dozens of tech-focused mods you likely already use.

Key Features of Botarium

• Unified Item, Fluid, and Energy Storage API — Botarium gives mod developers a single, consistent way to create blocks and items that store resources across Fabric, Forge, and NeoForge. For players, this means fewer compatibility issues and crashes when running multiple tech mods together in the same modpack.
• Crossplatform Transfer System — The mod includes a rudimentary but effective transfer API that allows containers from different mods and loaders to communicate with each other. This is crucial for modpack builders who mix Fabric-native and Forge-native content, as it ensures pipes, hoppers, and conduits interact correctly across mod boundaries.
• Fluid Registration API — Registering custom fluids in Minecraft is notoriously complex, with each loader handling it differently. Botarium abstracts this into a clean, straightforward registration system that mod developers can call once instead of writing platform-specific code. The result for players is more stable fluid-based mechanics in mods that depend on it.
• General Registration API — Beyond fluids, Botarium offers a universal registration system for blocks, items, and other game objects. This reduces the chance of registry conflicts that can cause crashes at startup, especially in large modpacks with 100+ mods installed.
• Crossplatform Compatibility Layer — Botarium acts as a translation layer between Forge's capability system and Fabric's API lookups. For players running hybrid-style modpacks or switching between loaders, this means mods that depend on Botarium will behave consistently regardless of which loader you choose.
• Open Source Under MIT License — The entire codebase is available on GitHub, which means the community can audit, contribute to, and fork the project. This transparency builds trust and ensures that if the original developers ever step away, the mod can continue to be maintained by the community.
• Lightweight Background Operation — As a library mod, Botarium appears to be lightweight and does not add any visible gameplay content on its own. It loads only the components that dependent mods actually request, so it should not noticeably affect your game's startup time or runtime performance.

Screenshots

How to Install Botarium

1. First, make sure you have the correct mod loader installed. Botarium supports Fabric, Forge, and NeoForge — choose whichever your modpack requires.
2. Download the Botarium file that matches both your Minecraft version and your mod loader from the download section below.
3. Navigate to your Minecraft installation folder. On Windows, press Win + R, type %appdata%.minecraft, and hit Enter.
4. Place the downloaded .jar file into the mods folder. If the folder does not exist, launch the game once with your mod loader to generate it automatically.
5. Launch Minecraft through your mod loader profile. Botarium will load silently in the background — you will not see any in-game indication unless a dependent mod confirms it has detected the API.

Requirements & Compatibility

What's New

• Version 2.3.4 adds index safety checks to prevent potential crashes during container lookups.
• Improved stability for modpacks with large numbers of registered items, fluids, and energy containers.
• Bug fixes targeting edge cases where out-of-bounds access could cause unexpected game exits.

Pros and Cons

Alternatives to Botarium

• Architectury API — A widely-used crossplatform abstraction layer that helps developers write mods for both Fabric and Forge simultaneously, serving a similar bridging role to Botarium but with a broader scope beyond just tech mod utilities.
• GeckoLib — While focused on animation rather than item and fluid storage, GeckoLib is another popular library mod that many tech and content mods depend on, and it often appears alongside Botarium in modpack dependency lists.
• Team Reborn Energy — A Fabric-focused energy API that provides energy storage and transfer capabilities, making it a more specialized alternative for developers who only need the energy handling portion of what Botarium offers.

Download Botarium

Always download mods from official sources to stay safe.

Frequently Asked Questions

Do I need Botarium if I don't make mods?

Yes — even though Botarium is a developer API, many popular mods require it as a dependency to run. If you use any mod created by Terrarium (such as Ad Astra, Handcrafted, or Chipped), or other tech mods that list Botarium as a requirement, you must install it or those mods will fail to load.

Does Botarium work on NeoForge?

Yes — Botarium officially supports NeoForge for Minecraft 1.20.1 and 1.20.4. When downloading, make sure you select the NeoForge-specific version file to ensure proper compatibility with your loader.

Will Botarium affect my game's performance?

Botarium appears to be lightweight and should have minimal impact on performance. It is a library mod that only provides code infrastructure for other mods to call upon, so it does not add blocks, entities, or world generation that would affect frame rates or loading times.

Can I use Botarium with OptiFine or Sodium?

There are no known conflicts between Botarium and rendering optimization mods like OptiFine or Sodium. Since Botarium operates at the item, fluid, and energy storage level rather than the rendering level, it occupies a completely different part of the mod stack and should coexist without issues.

Is Botarium safe and open source?

Yes — Botarium is fully open source under the MIT license, and its source code is publicly available on GitHub. You can review every line of code before installing it, and the MIT license is one of the most permissive in open source, allowing anyone to inspect, modify, and redistribute the mod freely.

You May Also Like

Cobblemon NoValidation Mod (1.21.1, 1.21) – Fixing Form Change Move

6 days ago

Regenerative Sleep Mod (1.21.1) – Players Heal When Sleeping

1 month ago

Better Selection Mod (1.21.11, 1.20.6) – Mouse Text Selection

5 days ago

Spawn Animations Compats Mod (1.20.1) – Support Spawn Animations

1 week ago

Per Player Wandering Traders Mod (1.20.1) – Per-Player Spawning

2 weeks ago

Better Statistics Screen Mod (1.21.11, 1.20.6) – Gameplay Upgrade

2 weeks ago