README-zh_CN.MD

English | 简体中文

Minecraft 协议解析器

使用方法

构建的文件可以在 Action 里面找到，稳定版可以在 Release 里面找到。

Windows 下载后把mcdissector.dll文件放入 Wireshark 的解析器目录（plugins/<Wireshark版本>/epan）并启动 Wireshark 即可。

Linux 下载后把mcdissector.so文件放入 Wireshark 的解析器目录（~/.local/lib/wireshark/plugins/<Wireshark版本>/epan）并启动 Wireshark 即可。

对于 Arch Linux，可以直接使用 AUR 里面的wireshark-minecraft-dissector包。

可调选项

可以在 Wireshark 的首选项/Protocols里面找到Minecraft，在这里可以调整一些选项。

• Directory for protocol data：放置协议数据的目录，用于解析数据。
• Ignore Packets：阻止解析一些包，用于过滤不需要的信息。格式为以<s|c>:<packet_name>组成的以逗号分割的列表，其中s 代表发向服务端的包，c代表发向客户端的包。默认为空。推荐设置为c:level_chunk,c:level_chunk_with_light。
• Secret Key：用于加密连接解密数据的密钥，格式为 32 长度的 16 进制字符串。
• NBT Decoding：是否解析 NBT 数据。
• TCP Port(s)：更改 MCJE 协议使用的 TCP 端口，用于识别协议。

协议数据

所有协议数据都从外部目录读取，此目录由选项Directory for protocol data控制。

可以直接使用MC_Protocol_Data提供的协议数据，直接使用源代码压缩包或者克隆仓库到指定协议目录即可。

加密连接

如果你使用了正版进入 Minecraft 服务器，则客户端和服务端之间会使用AES/CFB8/NoPadding算法建立加密连接。 此步骤在登录阶段压缩前执行，整个连接内的数据都会被加密，包括拆分数据的数据长度字段。

为了能监听加密连接内的数据，我们必须知道密钥是什么。项目内的encryption-helper可以做到这点， 它利用对称加密的密钥由客户端执行生成这一特点，在客户端创建密钥时强制替换为指定的密钥而不是生成随机密钥。

encryption-helper是一个 Java Agent，在 Minecraft 运行时动态注入执行代码。它需要用下面的 JVM 参数附加到一个 Minecraft 客户端中：

-javaagent:<文件位置>=<密钥>

密钥是一个 32 长度的，只包含 0-F 的 16 进制字符串。如果输入格式错误，在启动客户端时会立刻报错崩溃。

encryption-helper理论上可以运行在所有未混淆和混淆的可注入客户端中，因为它定位的注入点只包含下列不会被混淆的特征：

• 方法返回值为javax.crypto.SecretKey。
• 方法没有参数。
• 方法的第一个局部变量类型为javax.crypto.KeyGenerator。

基本不会有模组会修改此处的逻辑，所以程序修改这里是安全的，应该不会和模组冲突。

只有一种可能会导致此程序失效：模组修改了原版的加密逻辑，导致此处不会被调用无法替换密钥，但那种协议就已经不在我们程序的使用范围内了。

解析错误

如果出现了解析错误，可能有下面两种种情况：

• Wireshark 没有抓取到所有数据。由于 Java 版使用 TCP，数据由长度字段拆分，一旦缺少某一部分， 数据就会立刻无法解析。如果你在数据解析错误的前后发现了TCP Previous segment not captured，那么就是这种情况。
• 程序还没有做好这部分的适配或相应的处理，或没有添加对应的字符串。这类错误可以在 Issues 里面提出来。

协议整体由MC_Protocol_Data内的协议描述文件动态构建，如果你确信是因为协议描述出现问题而导致错误，可以在MC_Protocol_Data 仓库里面提出 Issue。

构建项目（Windows）

构建此项目需要有 Wireshark 的源码并需要配置依赖。

1. 克隆 Wireshark 仓库到本地，配置好需要的依赖。
2. 指定环境变量PLATFORM为x64，指定环境变量WIRESHARK_LIB_DIR为 Wireshark 依赖库目录（运行 cmake 时会自动创建）。
3. 在 Wireshark 源码同级目录创建build，在 build 中运行cmake -A x64 .. -DBUILD_wireshark=OFF。
4. 仍然在 build 中，运行cmake --build . --config RelWithDebInfo --target epan。
5. 指定环境变量WIRESHARK_DIR（Wireshark 源码目录）、WIRESHARK_BUILD_DIR（build 目录位置）、WIRESHARK_LIB_FILE_DIR（构建产生的 RelWithDebInfo 目录位置）。
6. 在项目根目录运行cmake -S . -G Ninja -B build。
7. 在项目根目录运行cmake --build build --target MC_Dissector。
8. 在 build 目录里面能看到构建出来的文件。

构建项目（Linux）

在 Linux 上构建要简单的多，具体看 ci.yml 就行（懒得写）。

当前计划

• 写的差不多了！（至少不炸了！）
• linux 支持 by @xtexChooser
• 支持加密。（应该没问题了！）
• 版本兼容性。（尽量支持到最新版）
• 支持基岩版。