JReiProxyServer

插件

· 作者 nwya

JReiProxyServer 是一个插件,为 JEI 和 REI 客户端提供服务器端支持,并响应各模组自定义的数据包。

0 本站下载 0 关注 更新于 1 个月前

最新 26.3.0 · 26.3 · Folia / Paper

一键开服(送7天)

JReiProxyServer

JReiProxyServer 是一个 Paper 插件,它为 JEI 和 REI 客户端提供了模组期望但插件服务器无法提供的服务端功能:服务器的配方数据,以及对模组专属数据包的回答。

自 Minecraft 1.21.2 起,原版服务器不再向客户端发送配方数据。在插件服务器上,这会导致配方查看器显示随客户端附带的默认配方,JEI 也会提示:

此服务器未向 JEI 提供配方。JEI 正在显示来自您客户端的默认配方...

本插件以模组加载器的方式发送这些配方。无需客户端模组,也无需在服务端安装模组加载器。

要求

  • Paper、Purpur、Folia 或基于 Minecraft 26.2 的分叉版。该插件针对该版本的服务器内部结构编译,无法在其他版本上加载。
  • 拥有 JEI 或 REI 的 Fabric 或 NeoForge 客户端(你的玩家已具备)。Fabric 客户端需要 Minecraft 1.21.10 或更高版本——低于该版本时 Fabric API 的配方同步通道不存在。

功能说明

配方同步。 服务器的配方仅编码一次,并通过每个客户端可读取的频道发送给每位玩家:fabric:recipe_sync(适用于 Fabric)、neoforge:recipe_content(适用于 NeoForge)。REI 通常从配方书构建其列表。当启用完整的 REI 作弊通道时,REI 会故意忽略配方书数据包,因此插件会通过 REI 26.2 版本固定的 sync_displays 协议发送相同的配方。

JEI 在服务端自身配方数据包到达时立即构建其列表(此时任何插件都尚未发送数据),因此它会打印一次警告,随后在片刻后重新加载并使用服务器的配方。该警告不可避免,且并不意味着同步失败;recipe-sync.notify-player 会在其后输出一行说明。

作弊模式。 从列表中取出物品、删除手持物品以及设置快捷栏槽位。完全支持 JEI 和 REI。REI 的完整作弊三件套与其显示同步相结合,保留完整的物品组件(例如光块的等级),而不会丢失服务器配方。如果无法完全编码该显示列表,插件会自动禁用这三件套,并让 REI 回退到安全的配方快捷栏和 /give 命令。由插件处理的作弊数据包受权限节点 jreiproxyserver.cheat 控制。

配方传输。 “+” 按钮,用于将玩家背包中的物品填充至合成网格,适用于 JEI(recipe_transfer、recipe_transfer_counted)和 REI(move_items_new)。各模组的服务端算法被重新实现而非近似模拟:客户端决定使用哪些槽位,但由服务端选择物品并进行移动,因此过期的客户端视图无法复制或凭空生成物品。REI 是否提供该按钮完全取决于服务端是否注册了其通道,因此仅在 recipe-transfer.enabled 开启时才展示。

配方黑名单。 配置文件中列出的配方将从插件发送的所有内容中排除。

版本说明

版本号由所构建对应的 Minecraft 版本加上插件修订号组成:26.2.1 添加了 REI 26.2 显示同步和完整的数据包作弊模式。该 jar 文件针对该版本的服务器内部结构编译,无法在其他版本上加载,因此版本号同时也是兼容性声明。

命令

所有玩家:

  • /jei(或 /rei,可选带参数 resync / retry)— 请求服务器重新发送配方。适用于登录缓慢导致配方丢失的情况;速率限制由 recipe-sync.player-resync-cooldown-seconds 控制。

管理员(OP):

  • /jreiproxy reload — 重载配置文件并重新编码配方。
  • /jreiproxy resync <player|all> — 向其他玩家重新发送配方。
  • /jreiproxy info — 显示配方数量、负载大小以及各频道已同步的玩家数量。

/jeiproxy 和 /jrp 是 /jreiproxy 的别名。

权限

  • jreiproxyserver.admin — 上述管理员命令,以及免除 /jei 冷却时间。默认 OP 拥有。
  • jreiproxyserver.cheat — JEI 和 REI 中的作弊模式。默认 OP 拥有。

配置文件

plugins/JReiProxyServer/config.yml:

键 说明
language en 或 zh_cn,或者你在 lang/ 下添加的文件名。
recipe-sync.enabled 主开关。关闭时 JEI 显示客户端自带的配方。
recipe-sync.on-join 玩家加入时发送配方。
recipe-sync.on-datapack-reload /reload 后重新编码并重新发送。
recipe-sync.recipe-book 谁获得完整的配方书:auto(报告 REI 的客户端)、all 或 off。
recipe-sync.trigger-recipe-update 发送使已加载查看器重新读取配方的数据包。关闭时配方仍会到达,但 JEI 会继续显示客户端默认值。
recipe-sync.strip-crafting-requirements 从配方书条目中省略合成要求。避免因无法解析的物品标签导致客户端被踢出,代价是原版配方书将每个配方视为不可合成,并将其原料留白。默认关闭;仅当客户端确实被踢出时才建议开启。
recipe-sync.player-resync-cooldown-seconds 玩家之间使用 /jei 重新同步必须等待的秒数。0 禁用此限制。
recipe-sync.notify-player 在聊天中告知玩家配方已到达,以便 JEI 之前的警告看起来已过时。措辞位于 lang/ 中。
cheat-mode.enabled 作弊模式的主开关。
cheat-mode.rei-channels 启用三个完整的 REI 作弊通道,并匹配相应的 sync_displays 配方路径。默认开启,需要配方同步和完整的显示负载。如果编码不完整,插件会自动保持该 trio 关闭;传输、热条作弊以及 REI 丢失组件的 /give 回退仍然可用。JEI 不受影响。
cheat-mode.allow-creative 还允许任何创造模式玩家作弊,无论权限如何。
recipe-transfer.enabled “+”按钮的主开关。
recipe-blacklist 要从所有发送内容中排除的配方 ID(namespace:key)。
debug 记录每个玩家的同步详细信息。

插件更新添加的键会在启动时写入现有的 config.yml 和 lang/*.yml 中,并附带注释。你修改过的部分保持不变,如果你的语言文件中缺少某条消息,则回退到 jar 内的副本,而不是显示原始键。

Folia

声明了 folia-supported。每个玩家的工作安排在拥有该玩家的区域线程上执行,而不是在不存在的服务器主线程上,配方数据作为单个不可变快照发布,因此数据包重载不会被观察到半应用状态,并且玩家之间共享的状态是并发安全的。

在实际 Folia 服务器上测试:代码遵循 Folia 的线程规则,并在 Paper API + Folia 上运行。

注意事项

发送整个配方书会使原版配方书将所有内容标记为已知。没有东西在服务端解锁,这也不是漏洞——当玩家点击配方时,服务器仍然检查他们知道什么。使用显示同步的 REI 客户端不需要这种配方书解决方法。

配方携带服务器的内部数字注册表 ID,这些 ID 随每个 Minecraft 版本而变化。与服务器版本不同的玩家无法解码它们。如果你运行 ViaVersion,预计配方同步仅对与服务器版本相同的玩家有效。

REI 的数据包在 Architectury 的分帧打包框架和字节数组信封内传输。客户端到服务端的数据包在大约 32 KB 以上拆分;服务端到客户端的数据包如 sync_displays 在大约 1 MiB 以上拆分。插件处理两个方向。

Fabric 负载仅携带其序列化程序位于 minecraft 命名空间中的配方。Fabric 的解码器在遇到客户端未选择参与的序列化程序时会丢弃整个负载,而该选择参与列表在配置阶段到达,插件无法看到。任何被跳过的内容都会在启动日志中报告。

许可证

MIT — 参见 LICENSE。

配方传输处理是从 JEI 和 REI 移植而来的,两者均采用 MIT 许可,发布的 jar 捆绑了 Kotlin 标准库,采用 Apache 2.0 许可。这些通知位于 THIRD-PARTY-NOTICES.md。

非官方及第三方产品。不与 JEI、REI、Fabric、NeoForge 或 Architectury 的作者有任何关联或背书。

构建

JDK 25 和互联网连接。首次运行时构建会下载一个 Paper 开发包,这需要一些时间。

./gradlew build

jar 文件位于 build/libs 中。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源