原创 开源 工具 CraftEngine-REI-Bridge —— 为CraftEngine开发的REI配方同步插件及配套模组 | 1.21.11 - 26.2 1.0.1

# [工具] CraftEngine REI Bridge｜让 Fabric 客户端在 REI 中查看服务器自定义物品与配方
> 将服务端 CraftEngine 的自定义物品和八类配方同步到 Fabric 客户端的 Roughly Enough Items。
---
## 资源信息
| 项目 | 内容 |
| --- | --- |
| 资源名称 | CraftEngine REI Bridge |
| 当前版本 | 1.0.0 |
| 服务端平台 | Paper 及兼容分支 |
| 客户端平台 | Fabric |
| 支持版本 | 1.21.11、26.1.2、26.2 |
| 配方查看器 | Roughly Enough Items（REI） |
| 前置插件 | CraftEngine |
| 开源许可 | MIT License |
| 作者 | MoutainSeaL |
| 联系 QQ | 3643203568 |
| 交流群 | 342097496 |
## 简介
CraftEngine 能够在服务端提供丰富的自定义物品和配方，但 Fabric 客户端上的 REI 默认无法识别这些服务端数据。
CraftEngine REI Bridge 通过一个 Paper 插件和一个 Fabric 客户端模组建立同步桥梁。玩家进入服务器后，服务端会将 CraftEngine 已加载的物品与受支持配方发送到客户端，并在 REI 中生成独立的 CraftEngine 合成、锻造、酿造、熔炉、高炉、烟熏炉、营火和切石机分类。
玩家可以像查询原版物品一样，在 REI 中对 CraftEngine 物品按 `R` 或使用鼠标左键查询配方，不需要手动翻找分类，也不会因为自定义物品使用了原版载体而混入无关的原版配方。
## 主要功能
- 同步服务器中已加载的 CraftEngine 自定义物品。
- 在 REI 物品列表中显示正确的模型和名称。
- 支持 CraftEngine 有序合成与无序合成。
- 支持 CraftEngine 锻造转换配方。
- 支持 CraftEngine 酿造配方。
- 支持 CraftEngine 熔炉、高炉、烟熏炉与营火配方，展示处理时间，并在适用分类展示经验值。
- 支持 CraftEngine 切石机配方。
- 同步其他 Bukkit 插件注册且涉及 CraftEngine 物品的合成、锻造、烹饪和切石配方。
- 为 CraftEngine 配方提供独立分类，不混入原版工作站内容。
- 使用 CraftEngine 物品 ID 精确匹配查询，避免底层原版物品造成误匹配。
- CraftEngine 热重载后自动更新在线玩家的 REI 数据。
- 离开服务器后清理已同步内容，防止跨服残留。
- 采用 30 KB 分包同步，支持较大的物品与配方数据量。
- 无配置文件，双端安装后即可使用。
## 图片展示
[/MD]

[MD] ## 版本兼容 | Minecraft | Java | Fabric Loader | Fabric API | REI | 对应客户端文件 | | --- | ---: | ---: | ---: | ---: | --- | | 1.21.11 | 21+ | 0.18.4+ | 0.141.6+1.21.11 | 21.11.816+ | `craftengine-rei-bridge-fabric-1.21.11-1.0.0.jar` | | 26.1.2 | 25+ | 0.19.3+ | 0.155.2+26.1.2 | 26.1.819+ | `craftengine-rei-bridge-fabric-26.1.2-1.0.0.jar` | | 26.2 | 25+ | 0.19.3+ | 0.156.0+26.2 | 26.2.821+ | `craftengine-rei-bridge-fabric-26.2-1.0.0.jar` | 服务端需要安装 CraftEngine 和本资源提供的服务端插件。当前服务端模块使用 Paper 1.21.11 API 与 CraftEngine 26.7.4 构建，插件 API 版本声明为 `1.20`。 > **注意：** 三个 Minecraft 版本的客户端文件不能混用。服务端插件和客户端模组必须配套安装，否则无法在 REI 中取得服务器数据。 ## 安装教程 ### 服务端安装 1. 确保服务器使用 Paper 或兼容分支，并已正确安装 CraftEngine。 2. 下载 `craftengine-rei-bridge-server-1.0.0.jar`。 3. 将文件放入服务器的 `plugins/` 文件夹。 4. 启动服务器，检查控制台是否出现以下信息： ```text CraftEngine REI Bridge enabled ``` 插件不生成配置文件，正常启用后无需额外设置。 ### 客户端安装 1. 安装对应游戏版本的 Fabric Loader。 2. 安装对应版本的 Fabric API。 3. 安装对应版本的 Roughly Enough Items（REI）。 4. 从附件中选择与游戏版本完全对应的客户端文件，放入 `.minecraft/mods/`。 5. 进入安装了服务端插件的服务器，打开 REI 查看 CraftEngine 物品与配方。 ## 附件选择 服务端统一使用： ```text craftengine-rei-bridge-server-1.0.0.jar ``` 客户端三选一： ```text Minecraft 1.21.11 -> craftengine-rei-bridge-fabric-1.21.11-1.0.0.jar Minecraft 26.1.2 -> craftengine-rei-bridge-fabric-26.1.2-1.0.0.jar Minecraft 26.2 -> craftengine-rei-bridge-fabric-26.2-1.0.0.jar ``` 不要下载或安装名称中带有 `sources` 的文件，那是供开发者阅读源码使用的构建产物。 ## 管理命令 | 命令 | 用途 | | --- | --- | | `/cereibridge reload` | 重新读取 CraftEngine 数据并重建同步缓存 | | `/cereibridge resync` | 玩家执行时同步自己；控制台执行时同步全部在线玩家 | | `/cereibridge info` | 查看物品及八类配方同步缓存的当前大小 | 所需权限： ```text craftengine-rei-bridge.admin ``` 该权限默认仅服务器管理员拥有。 ## 工作原理 玩家加入服务器后，客户端模组会与服务端插件握手。服务端随后通过独立通道发送物品及八类配方缓存，客户端完成分包组装后注册到 REI。 CraftEngine 执行热重载时，桥接插件会自动重建缓存并推送给所有在线玩家。玩家断开连接时，客户端会清理本次服务器同步的内容，因此不会将 A 服务器的物品带到 B 服务器的 REI 中。 同步内容仅包含展示 REI 配方所需的数据，不会向客户端发送完整 CraftEngine 配置、资源包文件或服务端代码。 ## 常见问题 ### 为什么进入服务器后 REI 中没有 CraftEngine 内容？ 请依次检查： - 服务端是否同时安装了 CraftEngine 和本桥接插件。 - 客户端是否同时安装了 Fabric API、REI 和对应版本的桥接模组。 - 客户端模组文件是否与 Minecraft 版本完全一致。 - 服务端控制台与客户端 `latest.log` 中是否存在桥接相关报错。 ### 为什么服务器只装插件还不生效？ REI 在客户端运行，必须安装本资源提供的 Fabric 客户端模组才能接收和展示数据。 ### 为什么客户端只装模组还不生效？ 客户端本身不知道服务器加载了哪些 CraftEngine 内容，必须由服务端插件提供同步数据。 ### CraftEngine 重载后需要玩家重新进服吗？ 不需要。正常情况下插件会自动重建缓存，并向在线玩家推送更新。也可以使用 `/cereibridge resync` 手动重新发送。 ### 为什么不显示锻造纹饰配方？ 锻造纹饰的结果会根据基础盔甲、纹饰模板和材料动态组合，不存在唯一固定结果，因此当前不将它导出为精确展示配方。 ### 本插件会把 CraftEngine 打包进 JAR 吗？ 不会。CraftEngine、REI、Fabric API、Fabric Loader、Architectury 和 Cloth Config 都没有被打包进桥接产物。CraftEngine 仍需由服主合法获取并独立安装。 ## 问题反馈 反馈时请提供： - 服务端核心和 Minecraft 版本。 - CraftEngine 版本。 - Fabric Loader、Fabric API 和 REI 版本。 - 服务端控制台及客户端 `latest.log` 的完整报错。 - 出现问题的 CraftEngine 物品或配方 ID。 作者：**MoutainSeaL** QQ：`3643203568` QQ 群：`342097496` ## 许可与致谢 本项目以 MIT License 开源。CraftEngine 是独立的商业产品，不包含在本资源中。 项目参考并包含部分来自 [TH2403y/CE-JEI-Bridge](https://github.com/TH2403y/CE-JEI-Bridge) 的 MIT License 代码，感谢原项目作者的工作。 --- 如果这个项目确实帮助到了你的服务器，欢迎在帖子中留下使用反馈。遇到兼容问题时，请尽量附带完整日志，以便快速定位。[/MD]