Proxy Compatible Forge - Proxy兼容Forge

Proxy Compatible Forge

特别感谢 [FabricProxy-Lite]() 和

[CrossStitch]() 在模组代理领域的开创性工作。我们虽然为移植和适配 Neo/Forge 环境付出了相当的努力，但终究是站在巨人的肩膀上。

此模组将 Velocity 的[现代转发]()功能引入 Neo/Forge 服务器。

功能特性

支持的版本/平台

• Forge 版本 1.7.2-1.21.11
• Forge 1.14.x - 1.15.1 需要 MixinBootstrap
• Forge 1.13.x 暂不支持
• Forge 1.8.x - 1.12.2 需要 MixinBooter
• Forge 1.7.x 需要 UniMixins
• 1.7.2 - 1.12.2 还需要一个修改过的 Velocity 代理
• NeoForge 版本 1.20.1-1.21.11
• SpongeForge/SpongeNeo
• 通常不需要 PCF，因为 Sponge 支持传统和现代转发以及命令参数包装
• 但是，如果安装了 Forgified Fabric API（特别是 fabricnetworkingapi_v1），你可能需要使用 PCF 并禁用 Sponge 的转发功能
• Bukkit+Neo/Forge 混合服务器
• 尽可能使用混合服务器内置的转发支持，否则如果其实现不兼容，则使用 PCF

有关支持的平台和整合包的更多详细信息，请参阅兼容性页面。

玩家信息转发

如上所述，PCF 实现了 Velocity 的 MODERN 转发协议，允许你将模组服务器安全地置于代理之后。

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

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

模组命令参数包装，即 [CrossStitch]()

这解决了如下错误：

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

PCF 移植了这个 Fabric 模组包装模组命令参数的能力，允许它们通过 Velocity 发送，而无需为每个模组添加的命令参数编写自定义数据包反序列化器。

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

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

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

常见的解决方法是让相关模组将其注册 Mixin 移动到 RETURN，并确保其参数的注册指定其模组 ID 作为命名空间。

如果你发现任何“野生”参数，请提交问题，以便我们可以将它们添加到默认配置中，或者利用提供的信息为导致问题的模组编写 PR。

如何开始

关于 Forge 1.13 - 1.20.1 的说明

如果你想在 Velocity 代理后托管现代 Forge 服务器（1.13 - 1.20.1），请查看 Ambassador：

注意：Ambassador 1.2.0-beta 或更高版本不再需要此模组，但你仍然可以使用它来获得现代转发功能。

安装

以下假设你已经[配置好 Velocity 代理]()并拥有一个正常工作的设置。

• 下载此模组并将其放入你的 Neo/Forge 服务器的 mods 文件夹中（Jar 文件可在 [Modrinth]() 或发布页面找到）。
• 启动 Neo/Forge 服务器以生成默认配置文件。
• 停止 Neo/Forge 服务器。
• 打开 config 文件夹中的 proxy-compatible-forge.toml，将你的转发密钥填入 forwarding.secret 配置字段。
• 在 server.properties 中，确保 online-mode 设置为 false。
• 现在你可以启动服务器并通过 Velocity 连接了！

配置

配置文件位于 config/proxy-compatible-forge.toml，具有以下选项：

常见问题

频道过多

客户端错误：

Invalid payload REGISTER!

Velocity：

Velocity 修复方法：将 -Dvelocity.max-known-packs=# 添加到 Velocity 的启动参数中，

其中 # 是 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 修复方法：将 -Dpaper.disableChannelLimit=true 添加到 Paper 服务器的启动参数中

注意：由于涉及的频道和模组数量众多，在加入 Vanilla 服务器时，客户端上的纹理/物品可能会不匹配。

构建项目

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

• 在项目根目录运行 ./gradlew build（Windows 上为 gradlew.exe build）

• Jar 文件将位于 build/libs/ 目录中