Horizon 互通开服包
Rust 服务端 Horizon + Velocity / Geyser / Floodgate
Java 版 26.3 与基岩版 26.40–26.63 互通 · 自带 Java · 解压即开
Rust 服务端 Horizon + Velocity / Geyser / Floodgate
Java 版 26.3 与基岩版 26.40–26.63 互通 · 自带 Java · 解压即开
介绍
前阵子看到 Horizon 这个项目,觉得挺有意思,就搭起来试了试,顺手整合成了一个开箱即用的互通包,分享给大家。
Horizon 是 horizon-rust 团队用 Rust 从零重写的 Minecraft Java 版 26.3 服务端(LGPL-3.0),不基于 Mojang 的服务端代码。按项目主页的说法,它用 281 组差分测试和原版逐项比对行为。它原生只支持 Java 版,本包在前面加了一层 Velocity 代理,用 Geyser 把基岩版协议翻译过来,用 Floodgate 让基岩玩家凭 Xbox 账号直接进服。
架构
代码:
Java 版 ── TCP 25565 ──┐
├─► Velocity(正版验证)+ Geyser(基岩→Java)+ Floodgate
基岩版 ── 19132/19133 ───┘ │ modern forwarding(每台机器随机生成密钥)
▼
Horizon(Rust)只监听 127.0.0.1:25566
特色
- 解压即开:自带 Java 25 运行环境和已生成好的 Horizon 资源,不用装 Java,不用跑 horizon-prepare
- Java / 基岩互通:基岩版新的 NetherNet(WebRTC)连接和老的 RakNet 连接同时开启
- 后端不暴露:Horizon 只监听本机,玩家必须经过 Velocity;Velocity ↔ Horizon 走 modern forwarding,密钥首次启动时随机生成
- 轻量:空服实测 20 TPS、MSPT 0.5 ms、Horizon 内存 0.36 GB、约 2 秒启动(Ubuntu 24.04,8 核 16 GB)
- 运维脚本:start.sh 前台运行;service.sh 装成 systemd 服务开机自启;tools/update.sh 更新 Horizon,更新前自动备份世界,旧版本保留可回滚
- 内网穿透友好:README 附 frpc 配置;启动时带 PUBLIC_ADDR 即可让基岩玩家通过公网地址连接
最低配置要求
| 系统 | 内存 | 硬盘 | |
|---|---|---|---|
| 最低要求 | Linux x86_64(Windows 可用 WSL2) | 2 GB | 1 GB |
| 测试环境 | Ubuntu 24.04 | 16 GB | — |
组件列表
| 组件 | 版本 | 作用 | 许可证 |
|---|---|---|---|
| Horizon | nightly 2026-11-18(0b14f8a) | Rust 服务端本体 | LGPL-3.0 |
| Velocity | 4.3.1 | 代理,正版验证 + modern forwarding | GPL-3.0 |
| Geyser | 2.12.1(build 1304) | 基岩版协议翻译,支持 26.40–26.63 | MIT |
| Floodgate | 2.2.5(build 141) | 基岩玩家免 Java 账号进服 | MIT |
| Eclipse Temurin JRE | 25.0.5+8 | Java 运行环境(Velocity 4.3.1 需要 Java 25) | GPL-2.0 + CE |
使用方法
代码:
tar xzf horizon-crossplay-26.3-20261118.tar.gz
cd horizon-crossplay-26.3
./start.sh # 首次运行需同意 Minecraft EULA;输入 end 或 Ctrl-C 停服
代码:
sudo ./service.sh install # 安装并启动 mc-horizon、mc-velocity
sudo ./service.sh status
sudo ./service.sh uninstall
- Java 版 26.3(正版):服务器 IP,端口 25565
- 基岩版 26.40–26.63(国际版):服务器 IP,端口 19132;玩家名前会带 "." 前缀,以区分 Java 玩家
代码:
horizon/horizon-server --dir server status # TPS / MSPT / 在线 / 内存
horizon/horizon-server --dir server cmd op 玩家名 # 基岩玩家要带 .,如 op .Steve
horizon/horizon-server --dir server cmd whitelist on
horizon/horizon-server --dir server console # 实时控制台,Ctrl-D 退出
端口与网络
新版基岩默认改用 NetherNet(基于 WebRTC)连接:客户端先通过 TCP 信令握手,再走一个单独的 UDP 端口传数据。所以比以前多一个端口,四个端口都要放行,只放 UDP 19132 时新版客户端可能连不上。
| 端口 | 协议 | 用途 |
|---|---|---|
| 25565 | TCP | Java 版 |
| 19132 | TCP | 基岩 NetherNet 信令 |
| 19132 | UDP | 基岩 RakNet |
| 19133 | UDP | 基岩 NetherNet 数据 |
| 25566 | TCP | Horizon 本体,仅本机,不要放行 |
代码:
PUBLIC_ADDR=你的公网IP ./start.sh # 只需带一次,会写入 Geyser 配置
已知问题
- Horizon 仍是 nightly 版本,更新频繁,开正式服前请备份并充分测试
- 下界、末地可正常使用;控制台暂不支持 execute in ... run tp
- 自带反作弊(默认开启);聊天过滤词库目前只有英文,需要自行在 server.toml 的 [chat_filter] 添加
- 经过 frp 后服务器看到的玩家 IP 均为 127.0.0.1,封禁请按玩家名
- 从 macOS 上传文件到 Linux 可能夹带 ._ 隐藏文件,导致 Horizon 报 expected value at line 1 column 1,删除即可:find . -name '._*' -delete
开服证明
Java 版服务器列表:
基岩版(手机)进服,画面中是同时在线的 Java 玩家:
Java 版游戏内(F3 右上角显示服务端为 "horizon (Velocity)"):
1 名玩家在线时的服务端状态(实测):
代码:
$ horizon/horizon-server --dir server status
Running, up 3 h 20 min
TPS 20.0, MSPT 5.2 ms average, 6.3 ms P95
1 of 20 players: Lloml, 727 chunks loaded
RAM 0.53 GB, CPU 12 % of a core
获取帮助
使用中遇到问题欢迎回帖,请附上报错日志(server/logs/latest.log 与 Velocity 控制台输出)。Horizon 本身的问题建议反馈到 项目 Issues。
致谢与声明
感谢 horizon-rust、PaperMC、GeyserMC、Eclipse Adoptium 各项目的开发者。各组件许可证见包内 LICENSES/ 目录。
本整合包免费提供,与 Mojang、Microsoft 及上述项目官方无关。运行服务器须遵守 Minecraft EULA。
SHA256:a518c53b11674cda1c9e9f0aaa252fe37bb753253bc053ab34c6e5bad2791629