服务器网络管理器

NetworkManager

专为各种规模的服务器设计。适用于小型项目的网络解决方案，同时具备支持大型服务器网络的架构。为开发者提供丰富的 API，以便在网络内无缝创建游戏。

本插件以服务端为核心：旨在跨多个 Hytale 服务器运行，这些服务器共同构成一个网络。玩家通过中心服务器连接到网络，插件负责处理服务器与竞技场之间的路由。

设置与功能指南

功能特性

网络架构

网络主要使用 Redis 处理快速网络通信，并可选支持 Postgres/MySQL，以实现大量自定义数据存储和持久性。

匹配与排队

通过 /queue 命令提供完整的匹配解决方案。将玩家路由至指定服务器组中最佳的可用竞技场，若无可用竞技场，则让玩家进入排队队列。同时支持队伍和队伍排队，让玩家能与朋友们一起游戏！

管理面板

一个直观的 UI，旨在绕过复杂的命令。设计简洁易用。提供强大的功能，例如基于角色集成的权限系统和全网络同步配置。

管理功能

NetworkPlugin 支持全网络封禁和禁言。管理面板除了提供 /netban 和 /netmute 命令外，还提供了活动操作列表以及用于执行管理操作的玩家管理工具。

持久化与数据安全（Redis + SQL）

NetworkManager 将 Redis 作为实时运行时层（排队、发布/订阅、协调），并增加了可选的 SQL 持久化（Postgres/MySQL）用于长期持久化和高级数据存储。 默认行为可以保持 Redis 优先，然后在需要时安全地迁移到 SQL。

• 灵活的持久化模式： REDIS_ONLY、Redis+SQL 镜像以及 SQL 主导缓存（按命名空间）。
• 命名空间安全控制： 显式注册、模式/就绪标志以及未注册命名空间的保护。
• 结构化迁移工作流： /netdebug persistence migrate|restore|verify|cutover 支持范围定位和空运行。

这让你既能获得当前的低延迟网络行为，也能在网络增长时通过受控路径获得更强的持久性。

开发者 API

NetworkManager 提供了丰富的 NetworkAPI，使你能够创建利用 NetworkManager 特性的游戏。文档目前尚未完成，正在编写中。

---

通过管理面板（/netpanel）管理你的网络

管理玩家操作与角色授权

专用的、自动管理的全网工作人员聊天频道，用于协调

查看所有活跃的全局操作

为你的网络创建功能完备的角色

向网络中的所有服务器发送公告

自动检测与全网配置管理器

管理全网权限，与角色集成

创建玩家队伍并一起排队

私人队伍聊天