CurseForge · Minecraft mod

HBM-Mekanism Compat

A bridge mod for HBM's Nuclear Tech and Mekanism on NeoForge 1.21.1

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

Quick answer

Which HBM-Mekanism Compat release should I use?

Updated 21 days ago

Latest stable file hbm_mek_compat-1.0.1.jar

Game version 1.21.1

Loader NeoForge

HBM-Mekanism Compat hbm_mek_compat-1.0.1.jar targets 1.21.1 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 HBM-Mekanism Compat 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.

Understand client and server requirements Read the Minecraft installation guide

What else does HBM-Mekanism Compat hbm_mek_compat-1.0.1.jar need?

hbm_mek_compat-1.0.1.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 HBM-Mekanism Compat without breaking your instance.

Built for HBM-Mekanism Compat hbm_mek_compat-1.0.1.jar. Pick another file and the loader, install side or required mods may change.

01
Stick to this file

Use hbm_mek_compat-1.0.1.jar. It targets 1.21.1 with NeoForge; another release may have different loader, side or dependency requirements.
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.
03
Put it on the correct side

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

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

About this project

What does HBM-Mekanism Compat add?

HBM-Mekanism Compat - A lightweight compatibility mod for Minecraft 1.21.1 NeoForge, adding two bridge blocks that enable bidirectional energy and fluid/chemical interoperability between HBM's Nuclear Tech Mod and Mekanism.

⚡ Core Features

Category	Function	Details
Energy Bridge	HE ↔ RF/J bidirectional conversion	Fixed ratio `1HE = 4RF = 10J`, lossless conversion with remainder buffering
	Independent buffer & rate	Buffer size and transfer rate configurable via config file
	Smart connection	Implements both HBM's `IEnergyReceiver/Provider` and Mek's `IEnergyStorage`
Fluid/Chemical	Liquids via Mek mechanical pipes	Water, Heavy Water, Deuterium, Tritium, Coolant via `IFluidHandler`
	Gases/Steam via Mek pressurized pipes	Steam via `IChemicalHandler` (auto-routed)
	Large internal buffer	3 input + 3 output tanks, 24,000 mB each, NBT persistent
Interaction & Visuals	6-face independent I/O mode	Toggle with HBM screwdriver: Input (Purple) / Output (Blue)
	Real-time color feedback	Block faces display purple/blue overlay based on mode

🔧 Technical Highlights

Non-invasive design: No modifications to HBM or Mekanism core code
Standard Capability registration: Uses NeoForge's RegisterCapabilitiesEvent for automatic Mekanism pipe detection
Dynamic fluid resolution: Runtime fluid parsing avoids NoSuchFieldError crashes across HBM versions
Full-tick transmission: Six-direction trySubscribe/tryProvide calls every tick, no delay

⚙️ Requirements

Item	Version
Minecraft	1.21.1
Mod Loader	NeoForge 21.1.228+
Java	21
Hard Dependency	HBM's Nuclear Tech: Neo Edition (198A or newer)
Soft Dependency	Mekanism (1.21.1-10.7.x, fluid features unavailable without it)

✅ Tested with: HBM Neo 198A + Mekanism 10.7.19.85 + NeoForge 21.1.248

⚠️ Important: This mod depends on HBM's Nuclear Tech: Neo Edition, which is still in early porting stage (WARNING: NOT ready for survival!) with missing content and potential crash risks. Please be aware before using.

📥 Links

HBM Neo Edition (GitHub): https://github.com/ohiomannnn/HBMsNTM-NEO-EDITION
HBM Neo Edition (Modrinth): https://modrinth.com/mod/hbms-nuclear-tech-ne
HBM Neo Edition (CurseForge): https://www.curseforge.com/minecraft/mc-mods/hbms-nuclear-tech-ne
Mekanism (Modrinth): https://modrinth.com/mod/mekanism

📝 Changelog (v1.0.0)

Initial release of Energy Bridge and Fluid Converter
HE ↔ RF/J lossless bidirectional conversion
Liquid (mechanical pipes) and gas/steam (pressurized pipes) auto-routing
6-face independent I/O mode (screwdriver toggle + purple/blue color feedback)
Fixed HBM fluid dynamic parsing crash
Fixed water push issue (removed 20-tick throttling)

以下为中文版本 / Chinese Version Below

⚠️ 重要提示：本模组依赖的 HBM's Nuclear Tech: Neo Edition 目前仍处于早期移植阶段（WARNING: NOT ready for survival!），存在内容缺失和潜在崩溃风险。使用前请确认你了解这一情况。

🎯 为什么需要这个模组？

HBM 和 Mekanism 都是大型科技模组，但两者底层架构完全不同——HBM 拥有独立的流体与电网系统，Mekanism 则遵循标准的 NeoForge Capability 系统。本模组不修改任何原模组文件，仅作为中立桥梁，让两个模组的能量、液体和气体能够顺畅互传。

⚡ 核心功能

分类	功能	实现细节
能量桥接	HE ↔ RF/J 双向转换	固定比例 `1HE = 4RF = 10J`，内置余数缓冲实现无损转换
	独立缓存与速率	缓存上限及传输速率均支持配置文件修改
	智能连接	同时实现 HBM 的 `IEnergyReceiver/Provider` 与 Mek 的 `IEnergyStorage`
流体/化学	液态走机械管道	水、重水、氘、氚、冷却液通过 `IFluidHandler` 与 Mek 机械管道互通
	气态/蒸汽走加压管道	蒸汽通过 `IChemicalHandler` 与 Mek 加压管道互通（自动识别分流）
	大容量缓存	内置 3 输入 + 3 输出罐，单罐 24,000 mB，支持 NBT 持久化
交互与视觉	六面独立模式	手持 HBM 螺丝刀右键点击面，切换输入（紫）/ 输出（蓝）
	实时着色指示	方块表面根据模式显示紫/蓝叠加色，流向一目了然

🔧 技术亮点

无侵入式设计：不修改 HBM 与 Mekanism 本体代码
标准 Capability 注册：利用 NeoForge 的 RegisterCapabilitiesEvent 注册标准能力，Mekanism 管道自动发现并连接
动态流体解析：运行期动态读取 HBM 流体，规避版本差异导致的 NoSuchFieldError 崩溃
全 Tick 传输：每 Tick 六向调用 trySubscribe/tryProvide，响应无延迟

⚙️ 运行环境

项目	版本要求
Minecraft	1.21.1
模组平台	NeoForge 21.1.228+
Java	21
硬依赖	HBM's Nuclear Tech: Neo Edition（198A 或更新）
软依赖	Mekanism（1.21.1-10.7.x，若缺少则流体互通功能不可用）

✅ 已测试环境：HBM Neo 198A + Mekanism 10.7.19.85 + NeoForge 21.1.248

📝 更新日志（v1.0.0）

能量桥接器与流体转换器首发上线
支持 HE ↔ RF/J 无损双向转换
支持液态（机械管道）与气态（加压管道）分流传输
新增六面独立 I/O 模式（螺丝刀切换 + 紫/蓝着色反馈）
修复 HBM 流体动态解析崩溃问题
修复限流导致的水无法推送问题

Project description from CurseForge.

Pick your setup