HBM-Mekanism 兼容

HBM-Mekanism 兼容

HBM核科技与通用机械的NeoForge 1.21.1桥梁模组

技术

HBM-Mekanism Compat - 一个适用于 Minecraft 1.21.1 NeoForge 的轻量级兼容性模组，添加了两个桥梁方块，用于在 HBM 的核科技模组与 Mekanism 之间实现能量和流体/化学物质的双向互通。

⚡ 核心功能

分类 功能 实现细节
能量桥接 HE ↔ RF/J 双向转换 固定比例 1HE = 4RF = 10J，内置余数缓冲实现无损转换
独立缓存与速率 缓存上限及传输速率均支持配置文件修改
智能连接 同时实现 HBM 的 IEnergyReceiver/Provider 与 Mek 的 IEnergyStorage
流体/化学 液态走机械管道 水、重水、氘、氚、冷却液通过 IFluidHandler 与 Mek 机械管道互通
气态/蒸汽走加压管道 蒸汽通过 IChemicalHandler 与 Mek 加压管道互通（自动识别分流）
大容量缓存 内置 3 输入 + 3 输出罐，单罐 24,000 mB，支持 NBT 持久化
交互与视觉 六面独立 I/O 模式 手持 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

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

📥 相关链接

📝 更新日志（v1.0.0）

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

以下为中文版本 / 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 流体动态解析崩溃问题
  • 修复限流导致的水无法推送问题