网易版 Minecraft 虽然基于基岩版,但协议、验证体系和数据包结构与国际版不同。原生 Geyser 无法接受网易客户端接入。
支持 v630、v686、v766、v819 四个网易协议版本,各自拥有独立的序列化器实现。
国际版玩家走标准 Geyser 处理链路,网易逻辑仅在检测到 RakNet v8 客户端时激活,互不干扰。
支持网易 RSA-2048/SHA-256 证书链校验,独立于 Xbox Live 验证体系完成加密握手。
将原版方块运行时 ID 映射为网易 FNV-1a 哈希值,在 StartGame、LevelChunk、UpdateBlock 中自动替换。
在 channel 层面通过 RakNet 协议版本号识别网易客户端,自动切换压缩策略和 PacketCodec。
可选仅允许网易客户端模式,拒绝国际版基岩玩家连接,适合纯网易服务器部署。
如何安装GeyserNetease。
将 GeyserNeteaseExtension.jar 放入 Geyser 的 extensions/ 目录,重启即可。首次启动后自动生成配置文件。
# true = 仅允许网易版(RakNet v8)客户端连接,国际版玩家将被断开 only-netease-clients: false # true = 输出详细身份验证及数据包调试日志 debug-mode: false
你需要已经安装并运行 Geyser。本扩展不能独立使用。
从 GitHub Releases 获取最新版本的 jar 文件。
将 jar 放入 Geyser 的 extensions 目录,重启 Geyser。
如需自行编译:./gradlew build,产物位于 build/libs/GeyserNeteaseExtension.jar。