Minecraft 1.16.5 Forge 自定义网络包多人模式编码及packet_handler报错求助

问题根因排查&解决方案 #

1. 修正PacketHandler初始化时机 #

你必须把PacketHandler.init()放在你的模组主类的构造方法中执行，不能放在FMLClientSetupEvent、FMLDedicatedServerSetupEvent等延迟事件中触发。
延迟初始化会导致服务端和客户端的通道注册顺序、消息ID不一致，数据包编解码时字节流错位，最终抛出UTFDataFormatException错误，这是1.16.x版本Forge网络模块最常见的触发原因。

2. 检查混淆配置 #

如果你的模组打包时开启了混淆，需要在proguard配置中排除你的数据包类和网络处理相关类的构造方法、公开方法，避免反射调用失败：

-keep class 你的数据包类完整路径.ProcessingCraftPacket {
    <init>(net.minecraft.network.PacketBuffer);
    public *** encode(...);
    public static *** handle(...);
}
-keep class 你的网络处理类完整路径.PacketHandler {
    public static *** init(...);
    public static *** CHANNEL;
}

开发环境默认不会开启混淆，所以单人测试不会触发问题，打包到生产环境后混淆导致反射调用构造方法失败，就会出现编解码异常和packet_handler找不到的错误。

3. 校验发包调用代码 #

确认你客户端点击按钮触发发包时，调用的是SimpleChannel.sendToServer()方法，不要使用错误的发送API：

// 客户端侧正确的发送示例
PacketHandler.CHANNEL.sendToServer(new ProcessingCraftPacket(blockEntity.getBlockPos()));

如果错误使用send()方法且没有正确指定目标和方向，也会触发网络层报错。

4. 补充空值校验 #

在handle逻辑中补充空值判断，避免极端情况（比如方块被删除的同时发包）导致服务端侧报错：

public static void handle(ProcessingCraftPacket message, Supplier<NetworkEvent.Context> ctx) {
    ctx.get().enqueueWork(()->{
        // 补充非空判断
        if (ctx.get().getSender() == null) return;
        Level level = ctx.get().getSender().level;
        if (level.isLoaded(message.Pos)) {
            final TileEntity TE = level.getBlockEntity(message.Pos);
            if(TE instanceof ProcessingTile) {
                final ProcessingTile PT = (ProcessingTile) TE;
                PT.process(level);
            }
        }
    });
    ctx.get().setPacketHandled(true);
}

内容的提问来源于stack exchange，提问作者RMI