Proxy Compatible Forge

模组

· 作者 adde0109

此模组将 Velocity 的现代模式、Lucko 的 BungeeGuard 以及 BungeeCord 的传统玩家信息转发模式引入 Neo/Forge 服务器。

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

最新 1.3.1 · 26.2 · Forge / NeoForge

一键开服(送7天)

兼容代理的 Forge

特别感谢 FabricProxy-Lite 和 CrossStitch 在模组化代理领域做出的开创性工作。我们在将相关内容移植并适配到 Neo/Forge 环境方面做了大量工作,但我们的成就依然建立在巨人的肩膀之上。

此模组将 Velocity 的 现代、 Lucko 的 BungeeGuard 以及 BungeeCord 的传统玩家信息转发模式引入 Neo/Forge 服务器。

支持版本/平台

  • Forge 1.7.2 - 26.2
  • NeoForge 1.20.1 - 26.2
  • SpongeForge/SpongeNeo
    • 通常不需要 PCF,因为 Sponge 原生支持传统与现代转发模式及命令参数包装
    • 但是,如果安装了 Forgified Fabric API(特别是 fabric_networking_api_v1),你可能需要使用 PCF 并禁用 Sponge 的转发功能
  • Bukkit+Neo/Forge 混合服务器
    • 尽可能使用混合服务器内置的转发支持;否则,如果其实现不兼容,则使用 PCF

请参阅 Compatibility 页面以获取更多关于支持平台和整合包的详细信息。

入门指南

关于 Forge 1.13 - 1.20.1 的注意事项

如果你希望在 Velocity 代理后面托管现代版本的 Forge 服务器 (1.13 - 1.20.1),请查看 Ambassador:

注意:Ambassador 1.2.0-beta 或更高版本不再需要此模组,但如果你希望使用现代转发功能,你仍然可以继续使用它。

安装

以下操作假设你已经 配置了 Velocity 代理 并且拥有一个正常运行的设置。

  1. 下载此模组并将其放入你的 Neo/Forge 服务器的 mods 文件夹中(Jar 文件可在 Modrinth 或发布标签页中找到)。
  2. 启动 Neo/Forge 服务器以生成默认配置文件。
  3. 停止 Neo/Forge 服务器。
  4. 打开 config 文件夹中的 proxy-compatible-forge.toml,并将你的转发密钥填入 forwarding.secret 配置项中。
  5. 在 server.properties 中确保 online-mode 设置为 false。
  6. 你现在可以启动服务器并通过 Velocity 连接了!

配置

配置文件位于 config/proxy-compatible-forge.toml,包含以下选项:

设置组 设置名称 默认值 描述
forwarding enabled true 启用或禁用玩家信息转发。更改此设置需要重启服务器。
forwarding mode "MODERN" 要使用的转发类型。
forwarding secret "" 用于验证玩家连接来自受信任代理的密钥。
forwarding approvedProxyHosts [] 批准的代理主机名或 IP 地址列表。如果连接的代理的主机名或 IP 不在此列表中,玩家将被断开连接。留空则允许所有连接。
crossStitch enabled true 启用或禁用 CrossStitch 支持。更改此设置需要重启服务器。
crossStitch forceWrappedArguments [] 在此处添加任何不兼容的模组或原版命令参数类型。
crossStitch forceWrapVanillaArguments false 强制包装原版命令参数类型。当上述设置变得过于冗长时很有用。
debug enabled false 启用或禁用调试日志记录。
debug disabledMixins [] 要禁用的 Mixin 列表。使用 Mixin 的名称并以其部分或完整包名为前缀。
advanced modernForwardingVersion "NO_OVERRIDE" 覆盖 PCF 决定的现代转发版本。如果遇到聊天签名问题,请将其更改为 "MODERN_DEFAULT"。更改此设置需要重启服务器。

功能

玩家信息转发

如上所述,PCF 实现了 Velocity 的 MODERN 转发协议,允许你在代理后面保护模组服务器。

支持现代转发版本 1-4:

名称 值 支持的 MC 版本
MODERN_DEFAULT 1 任意版本
MODERN_FORWARDING_WITH_KEY 2 1.19
MODERN_FORWARDING_WITH_KEY_V2 3 1.19.1 - 1.19.2
MODERN_LAZY_SESSION 4 1.19.3 及以上版本

如果你遇到与聊天签名相关的兼容性问题,请报告该问题,然后将 PCF 配置中的 advanced.modernForwardingVersion 更改为 MODERN_DEFAULT。

接下来,BUNGEEGUARD 转发要求你要么使用 Velocity 的 BUNGEEGUARD 转发模式,要么在使用 BungeeCord 的同时安装 BungeeGuard 插件。

最后,LEGACY 转发要求你使用 Velocity 的 LEGACY 转发模式或在启用 IP 转发的情况下使用 BungeeCord。建议你不要使用这种转发模式,但你可以使用 forwarding.approvedProxyHosts 设置来在一定程度上确保安全。

模组命令参数包装,即 CrossStitch

这解决了如下错误:

io.netty.handler.codec.CorruptedFrameException: Error decoding class com.velocitypowered.proxy.protocol.packet.AvailableCommandsPacket

PCF 移植了该 Fabric 模组的封装模组命令参数的能力,使其能够通过 Velocity 发送,而无需为每个模组添加的命令参数创建自定义数据包反序列化器。请注意,BungeeCord 不支持包装的命令参数,因此如果你使用(或运行 BungeeCord 的分支),你可能需要禁用此功能。

在极少数情况下,模组会在 minecraft 命名空间下注册其命令参数或对原版参数进行修改,从而绕过 PCF 的参数包装器。在这种情况下,你可以将自定义参数的 ID 添加到 PCF 的 crossStitch.forceWrappedArguments 设置中,以强制 PCF 包装该参数。

在模组在原版之前注入并注册其参数、导致所有参数 ID 值偏移的情况下,你可以启用 crossStitch.forceWrapVanillaArguments 设置以强制包装 minecraft 和 brigadier 命名空间。这更像是一种临时解决方案,因为偏移后的参数 ID 无法被 Velocity 读取,并且如果客户端上的参数 ID 具有相同的偏移量,客户端将无法读取 Velocity 命令,从而导致完全无法连接,除非你通过权限禁用代理上的所有命令或删除添加命令的插件。

判断是否发生这种情况的最简单方法是启用 PCF 配置中的调试日志记录,并检查 brigadier:boolean 是否具有除 0 以外的参数 ID。

一个常见的修复方法是让相关模组将其注册 mixin 移至 RETURN,并确保其参数的注册指定了其 modid 作为命名空间。

如果你发现任何异常的参数(wild args),请提交 Issue,以便我们可以将它们添加到默认配置中,或者利用提供的信息为该模组的问题编写 PR。

常见问题

频道过多

客户端错误:

Invalid payload REGISTER!

Velocity:

Velocity 修复:在 Velocity 的启动参数中添加 -Dvelocity.max-known-packs=#, 其中 # 是一个数字,计算方式为 64 + 模组数量 * 1.5(向上取整)。

例如:对于 40 个模组,使用 64 + 40*1.5 = 124,即 -Dvelocity.max-known-packs=124

Paper 服务器错误:

[00:00:00 ERROR]: Couldn't register custom payload
java.lang.IllegalStateException: Cannot register channel 'modid:channel'. Too many channels registered!

Paper 修复:在 Paper 服务器的启动参数中添加 -Dpaper.disableChannelLimit=true

注意:由于涉及的频道和模组数量众多,加入原版服务器时,客户端可能会出现纹理/物品不匹配的情况。

发生内部服务器连接错误

客户端错误:

An internal server connection error occurred.

Velocity 错误:

io.netty.handler.codec.CorruptedFrameException: Packet sent for class com.velocitypowered.proxy.protocol.packet.PluginMessagePacket was too big (expected 1234567 bytes, got 7654321 bytes)

通过在 Velocity 的启动参数中添加 -Dvelocity.max-plugin-message-payload-size=####### 解决 Velocity 端的问题, 其中 ####### 比错误信息中最后一个 "got ####### bytes" 的数字稍大一些。重复此操作直到你的客户端能够成功登录。

构建项目

  1. 克隆仓库。git clone https://github.com/adde0109/Proxy-Compatible-Forge.git

  2. 在项目根目录下运行 ./gradlew build(Windows 系统下为 gradlew.exe build)

  3. jar 文件将位于 build/libs/

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源