Nitrado WebServer

Hytale WebServer 插件

Hytale 游戏的基础插件，允许其他 Hytale 插件提供基于 Web 的内容。

概述

许多插件的使用场景都需要通过 HTTP 提供数据，例如 Webhook、实时地图或公开已连接玩家的数据。然而，多个插件各自为各自的使用场景打开独立的 HTTP 服务器会造成不必要的开销，并给服务器管理员和服务提供商带来诸多麻烦。

该插件为插件开发者提供了一个通用的解决方案，在一个地方解决了 Web 服务器的典型需求，从而使插件之间保持兼容性。

我们鼓励游戏服务器提供商检测此插件的存在，并为其提供配置，以确保其与各自的托管平台兼容。

主要特点

• **默认安全：**使用自签名或用户提供的证书进行 TLS 加密，并支持证书检索。
• **玩家身份验证：**玩家可以根据其 Hytale 帐户进行身份验证，从而允许插件在该玩家的上下文中运行。
• **权限检查：**内置支持根据已验证玩家在 Hytale 服务器上的权限执行授权检查。
• **服务账号（API 用户）：**允许服务器所有者创建独立于玩家账号的账号，这些账号仍然可以使用 Hytale 的权限系统进行管理。
• **可扩展性：**所有重要的实现都采用接口形式，以便在需要时进行替换。为了确保与其他 Web 服务器的兼容性，jakarta.servlet.http使用了相应的类。

快速入门

安装

将插件 JAR 文件复制到服务器mods/文件夹中。默认情况下，Web 服务器绑定到游戏服务器的 +3 端口。

基本配置

创建mods/Nitrado_WebServer/config.json以自定义设置：

{
  "BindHost": "127.0.0.1",
  "BindPort": 7003
}

文档

• 服务器管理员指南- 安装、TLS 配置、身份验证设置和服务帐户管理。
• 插件开发者指南- 将插件与 Web 服务器集成、注册路由和处理权限。