Minecraft-Console-Client 客户端协议处理异常问题分析与解决方案

问题背景

在 Minecraft-Console-Client（以下简称MCC）项目中，用户报告了一个与协议处理相关的异常问题。当客户端连接特定版本的Minecraft服务器时，会出现"Failed to process incoming packet of type ProfilelessChatMessage"的错误，导致客户端崩溃。

错误现象

用户在使用MCC连接以下版本服务器时遇到问题：

• Minecraft 1.20
• Minecraft 1.20.1

错误日志显示，客户端在处理ID为28的数据包时抛出异常，提示队列为空（Queue empty）。而在1.20.2和1.20.4版本上则工作正常。

技术分析

协议版本差异

通过深入分析Minecraft各版本的协议规范，我们发现：

1. 在1.20.2版本中，Disguised_Chat_Message（在MCC中称为ProfilelessChatMessage）数据包的ID为0x1C（十进制28）
2. 在1.20.1版本中，相同功能的数据包ID却是0x1B（十进制27）

MCC协议处理机制

MCC使用PacketTypePalette来处理不同协议版本的数据包。核心问题出在GetTypeHandler方法的版本判断逻辑上：

PacketTypePalette p = protocol switch
{
    > Protocol18Handler.MC_1_20_4_Version => throw new NotImplementedException(...),
    <= Protocol18Handler.MC_1_8_Version => new PacketPalette17(),
    ...
    <= Protocol18Handler.MC_1_19_4_Version => new PacketPalette1194(),
    <= Protocol18Handler.MC_1_20_2_Version => new PacketPalette1202(),
    _ => new PacketPalette1204()
};

其中版本常量定义为：

• MC_1_19_4_Version = 762
• MC_1_20_Version = 763 (包含1.20和1.20.1)
• MC_1_20_2_Version = 764

问题根源

当前实现中，协议版本763（1.20和1.20.1）会被错误地分配到PacketPalette1202处理，而实际上这些版本应该使用PacketPalette1194。这是因为：

1. 763 > 762，所以跳过PacketPalette1194
2. 763 <= 764，所以选择PacketPalette1202
3. 但1.20/1.20.1的协议实际上与1.19.4更相似

解决方案

修改协议版本判断逻辑，确保1.20和1.20.1版本使用正确的PacketPalette1194：

<= Protocol18Handler.MC_1_20_Version => new PacketPalette1194(),

这样修改的原因是：

1. 1.20和1.20.1版本的客户端协议与1.19.4完全一致
2. 只有从1.20.2开始协议才有变化
3. MC_1_20_Version常量已经包含了1.20和1.20.1两个版本

验证结果

经过测试验证：

1. 使用修改后的代码连接1.20.1服务器，问题得到解决
2. 1.20.2及以上版本仍然正常工作
3. 不需要新增版本常量，保持代码简洁

总结

本问题展示了在维护多版本协议兼容性时的常见挑战。通过深入分析协议规范和版本差异，我们找到了精确的解决方案。这也提醒我们在处理协议版本时需要注意：

1. 仔细核对每个版本的实际协议规范
2. 理解版本号与协议号之间的关系
3. 确保版本范围判断的准确性
4. 保持代码的可维护性和可扩展性

该修复方案已被合并到MCC主分支，解决了用户在1.20和1.20.1版本上的连接问题。