格雷桥接器

格雷桥接器

一个运行时兼容性模组，在 NeoForge 1.21.1 上桥接格雷科技 CEu 现代版与 KubeJS 2101.7.x。

什么是 GregLink？

GregLink 是一个运行时兼容桥，使 GregTech CEu Modern 能与 NeoForge 1.21.1 上的 KubeJS 2101.7.x 协同工作。

从 KubeJS 2101.7.0 开始，配方组件 API 经历了重大重构——类路径被迁移、字段类型变更、接口被替换为类。这些破坏性更改导致 GTCEu 无法启动，并在世界选择界面因 NullPointerException 而崩溃。

GregLink 作为一个 CoreMod 运行，在启动时动态修补 GTCEu 的字节码以解决这些不兼容问题。不会修改任何 GTCEu 或 KubeJS 的 jar 文件——删除 GregLink 即可将所有内容恢复至原始状态。

功能特性

  • 零侵入 — 不修改 GTCEu 或 KubeJS 的 jar 文件。所有修补均在启动时于内存中完成。
  • 即插即用 — 将其放入 mods 文件夹即可，无需任何配置。
  • 完全可逆 — 移除 GregLink.jar，一切恢复原状。
  • 保留全部核心功能 — 机器配方、材料、世界生成和 JEI 集成均能正常工作。

兼容性

  • Minecraft：1.21.1
  • 模组加载器：NeoForge 21.1+
  • GTCEu Modern：7.0.1 / 7.0.2（7.0.x 系列）
  • KubeJS：2101.7.x

已在 GTCEu 7.0.1 和 7.0.2 环境中测试验证——从启动、KJS 脚本加载到正常游戏玩法均通过测试。

已知问题

  • GT 有形状配方模式已禁用。 底层的 KJS API 方法（asPatternKey、STRICT_ITEM_STACK）已在 KubeJS 2101.7.x 中被完全移除且无法恢复。请改用 KubeJS 原生的 shaped / shapeless 配方类型来处理工作台配方。

许可证与致谢

GregLink 以 MIT 许可证 发布。

GregTech CEu Modern 采用 LGPL-3.0 许可证，版权所有 © GregTech CEu Team。GregLink 不包含或再分发任何 GTCEu 源代码；它仅作为运行时兼容层运行。