奈克索里

Nexori

构建互联的 Hytale 服务器网络，同时保持对自己服务器的控制。

Nexori 是什么？

Nexori 是一个用于互联 Hytale 服务器的安全编排层。

它不会取代 Hytale 原生的服务器传送系统，也不是代理。

Nexori 在 Hytale 原生的 referToServer(...) 流程基础上进行了扩展，增加了服务器注册、签名旅行上下文、验证数据包、感知物品栏的传送、传送门、队列、实例化小游戏、返回大厅流程以及可选的服务器端集成。

目标很简单：

让创作者能够安全地连接多个 Hytale 服务器，同时保持对其世界、游戏玩法、后端、经济和社区的所有权。

---

主要功能

安全的服务器旅行

• 在游戏中注册受信任的服务器。
• 在服务器之间创建传送门。
• 通过 Hytale 原生的服务器推荐流程移动玩家。
• 签署并验证旅行上下文，防止玩家随意篡改数据包内容。
• 在服务器之间转移玩家的物品栏和选定的玩家数据。
• 确保跨服务器的移动由你的网络规则控制。

传送门与连接世界

• 创建大厅传送门。
• 连接冒险世界。
• 通过游戏内菜单配置目的地。
• 无需代理即可在独立服务器之间移动玩家。

队列与小游戏编排

• 为独立服务器创建本地队列。
• 在需要自定义匹配时使用后端驱动的队列。
• 配置游戏、竞技场、实例模板、出生点和返回目的地。
• 将玩家送入实例化比赛。
• 在规则允许时支持比赛中途补位。
• 在游戏结束后清理比赛运行环境。

后端集成

Nexori 可以在没有后端的情况下运行，但当你的网络规模扩大时，它也可以连接到你自己的后端。

将你的后端用于：

• 自定义匹配；
• ELO 或排名；
• 分区；
• 锦标赛；
• 玩家历史；
• 分析；
• 结果处理；
• 高级队列逻辑。

Nexori 在游戏内部处理同步、任务分配执行、结果报告、重试行为和后端运行状况可见性。

公共小游戏 API

Nexori 包含一个面向第三方小游戏和规则模组的公共 API。

小游戏可以：

• 接收 Nexori 比赛生命周期回调；
• 在 Nexori 创建比赛时创建自己的本地游戏会话；
• 追踪玩家到达和位置；
• 在玩家就位后开始游戏；
• 设置玩家结果；
• 使用 Nexori 观战模式运行时行为；
• 提交最终比赛结果；
• 将玩家送回大厅；
• 将自定义 JSON 统计数据附加到后端结果报告。

开发者可以针对独立的 API 工件进行编译：

repositories {
    mavenCentral()
    maven { url = uri("https://jitpack.io") }
}

dependencies {
    compileOnly("com.github.hyjn-nexori:nexori-api:v2.4.0")
}

nexori-api 仅供开发者使用。服务器所有者应安装完整的 nexori-plugin.jar。

观战模式运行时

公共 API 包含 setPlayerSpectator(...)。

Nexori 观战模式可以应用真实的运行时行为：

• 向活跃玩家隐藏观战者；
• 保持观战者对其他观战者可见；
• 启用飞行；
• 阻止游戏交互；
• 阻挡物品拾取；
• 阻挡物品丢弃和物品栏操作；
• 应用临时的观战者模型覆盖。

这对于淘汰制小游戏非常有用，玩家可以在比赛中作为观察者停留，而不会影响活跃的游戏进程。

游戏内管理

Nexori 被设计为在游戏内进行配置。

使用 /nexorimenu 管理：

• 服务器；
• 传送门；
• 队列；
• 游戏；
• 竞技场；
• 实例模板；
• 出生点槽位；
• 后端选项；
• 恢复工具；
• 网络运行状况。

正常设置无需手动编辑配置文件。

---

示例小游戏与开发者项目

夺旗区域

夺旗区域是一个为 Nexori 构建的工作示例小游戏。

它展示了推荐的现代集成模型：

• 小游戏核心可以在没有 Nexori 的情况下运行；
• Nexori 集成仅在 Nexori 存在时加载；
• 适配器监听 Nexori 生命周期回调；
• 小游戏通过 Nexori API 命令报告结果；
• 存在一个用于无 Nexori 测试的轻量级本地模式。

仓库：

https://github.com/hyjn-nexori/nexori-capture-the-zone-minigame

小游戏模板

如果你想创建自己的兼容 Nexori 的小游戏，请使用官方模板。

仓库：

https://github.com/hyjn-nexori/nexori-minigame-template

集成文档：

https://docs.hyjn-nexori.com/public-api/integrating-third-party-minigames

---

源码可用

Nexori 是源码可用的，而非开源。

你可以检查代码，从实现中学习，并验证你正在安装的内容。

• Nexori 插件源码：https://github.com/hyjn-nexori/nexori-plugin
• Nexori API 工件：https://github.com/hyjn-nexori/nexori-api
• 文档：https://docs.hyjn-nexori.com/

---

开始使用

1. 在你的网络中的每台服务器上安装 Nexori。
2. 安装必需的依赖项，包括 HyUI。
3. 加入服务器并运行 /nexorimenu。
4. 注册你的服务器。
5. 创建传送门、队列、游戏、竞技场和出生点槽位。
6. 测试完整流程：大厅 -> 队列 -> 比赛 -> 返回。
7. 仅在项目需要高级匹配或结果处理时，再添加你自己的后端。

---

必需依赖项

Nexori 需要 HyUI 来实现其 HUD 和游戏内 UI 功能。

当从 CurseForge 安装 Nexori 时，请确保 HyUI 已作为必需依赖项安装在服务器上。