OrbisProxy

OrbisProxy

OrbisProxy 是一个轻量级、高性能的 Hytale 代理，使用 Go 语言编写（而非 Java）。它专为可靠性、可扩展性而设计，具备内置的负载均衡、玩家转移以及插件支持（开发中）功能。

早期插件

OrbisProxy

⚠️ 弃用通知 ⚠️

更好的替代方案在此：OrbisManager - 多服务器网络

Discord Release

Supported Hytale Version

OrbisProxy 是一款用 Go（而非 Java）编写的轻量级高性能代理。它专为可靠性、可扩展性而设计，内置负载均衡、玩家转移、自动故障回退处理和插件支持。

功能特性

  • 使用 Go 编写，内存占用低，性能高
  • 支持负载均衡策略的服务器
  • 玩家转移系统
  • 自动故障回退处理
  • 基于主机名路由到特定后端服务器
  • 多语言支持，可针对每个玩家进行本地化（en, de, zh, es, ru）
  • 插件可扩展性
  • 可热重载的 Lua 插件：Lua 插件 API
  • （计划中） Go 插件 API（仅限 Linux），用于高级插件扩展

概念

负载均衡

池将多个服务器分组，并使用轮询等策略自动分配玩家。

示例：如果你将玩家转移到某个池名称，OrbisProxy 会根据池策略自动选择目标服务器。

故障回退

如果后端服务器崩溃或无法访问，所有玩家都会自动转移到配置的故障回退服务器。

命令

请参阅 GitHub 上的命令

插件和客户端引用转移

转移也可以由其他插件或使用 ClientReferral 数据包触发。使用 ClientReferral 转移时：

  • host 字段被解释为目标服务器或池名称
  • port 值被忽略
  • host 值必须以 optransfer.<server> 为前缀

其中 &lt;server&gt; 被替换为配置中定义的服务器名称或池名称。

示例

通过使用 Hytale 内置的 /refer 命令。

连接到服务器 lobby-1：/refer optransfer.lobby-1 1234 连接到服务器 lobby-2：/refer optransfer.lobby-2 1234 连接到池 lobby：/refer optransfer.lobby 1234

CLI 参数

-c "config.yml" 配置文件路径（可选，默认为 config.yml）

-debug true 启用调试日志（默认为 false）

插件 API

Lua API（开发中）

用于轻量级插件的快速简便脚本。 完整 Lua API 参考请见此处：Lua API 文档

Go API（计划中）

Go 语言的高级插件开发。 仅限 Linux。不支持 Windows。

后端服务器设置

请参阅后端服务器设置指南

安装（Linux 服务）

请参阅安装（Linux 服务）指南

安装（Pterodactyl Egg）

请参阅Pterodactyl Egg 指南

部署与支持

如果你需要任何特定的部署选项或帮助，请随时通过 Discord 与我们联系。