GeyserNetease

让网易版 Minecraft 玩家也能进入你的服务器,与国际版、Java 版玩家同服游玩。

Overview

为什么需要它

网易版 Minecraft 虽然基于基岩版,但协议、验证体系和数据包结构与国际版不同。原生 Geyser 无法接受网易客户端接入。

多协议版本

支持 v630、v686、v766、v819 四个网易协议版本,各自拥有独立的序列化器实现。

不影响国际版

国际版玩家走标准 Geyser 处理链路,网易逻辑仅在检测到 RakNet v8 客户端时激活,互不干扰。

证书验证

支持网易 RSA-2048/SHA-256 证书链校验,独立于 Xbox Live 验证体系完成加密握手。

方块哈希映射

将原版方块运行时 ID 映射为网易 FNV-1a 哈希值,在 StartGame、LevelChunk、UpdateBlock 中自动替换。

RakNet 路由

在 channel 层面通过 RakNet 协议版本号识别网易客户端,自动切换压缩策略和 PacketCodec。

客户端过滤

可选仅允许网易客户端模式,拒绝国际版基岩玩家连接,适合纯网易服务器部署。

Demo

教程

如何安装GeyserNetease。

Configuration

配置

GeyserNeteaseExtension.jar 放入 Geyser 的 extensions/ 目录,重启即可。首次启动后自动生成配置文件。

extensions/geyser-netease/config.yml
# true = 仅允许网易版(RakNet v8)客户端连接,国际版玩家将被断开
only-netease-clients: false

# true = 输出详细身份验证及数据包调试日志
debug-mode: false
v630 v686 v766 v819
Get Started

开始使用

你需要已经安装并运行 Geyser。本扩展不能独立使用。

1

下载

GitHub Releases 获取最新版本的 jar 文件。

2

安装

将 jar 放入 Geyser 的 extensions 目录,重启 Geyser。

3

构建(可选)

如需自行编译:./gradlew build,产物位于 build/libs/GeyserNeteaseExtension.jar