promotional bannermobile promotional banner

HBM-Mekanism Compat

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

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

📝 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 流体动态解析崩溃问题
  • 修复限流导致的水无法推送问题

The HBM-Mekanism Compat Team

profile avatar
DICH_1
Owner
  • 1
    Projects
  • 136
    Downloads

:D