一个查询

一个查询

让更多玩家发现你。这款Hytale插件能让服务器列表网站自动展示你的服务器状态。更高的可见度 = 更多玩家加入。

杂项

OneQuery - Hytale 服务器查询插件

让服务器列表显示你的服务器状态。类似于 Minecraft 的查询协议，但专为 Hytale 构建。

功能特性

  • 零依赖 —— 直接放入即可运行
  • 同一端口 —— 使用游戏端口，无需额外端口
  • 安全可靠 —— 挑战-应答机制防止 DDoS 放大攻击
  • 网络模式 —— 跨多服务器合并玩家计数
  • 访问控制 —— 使用令牌保护端点

可查询内容

  • 服务器名称和 MOTD
  • 玩家数量（当前和最大）
  • 在线玩家列表及 UUID
  • 服务器版本和协议信息
  • 已安装的插件

网络模式（v2 新增！）

运行多个服务器？OneQuery 可以聚合整个网络的数据：

  • 从大厅显示所有服务器的总玩家数
  • 从任意服务器显示合并的玩家列表
  • 通过 Redis 实现实时同步

非常适合生存网络、小游戏服务器和大型社区。

访问控制

使用基于令牌的身份验证保护敏感数据：

  • 让玩家数量公开，但玩家列表私有
  • 为不同的应用程序分配不同的权限
  • 随时撤销访问权限

插件 API

其他插件可以访问网络范围的数据：

OneQueryAPI api = OneQueryAPI.get();
int totalPlayers = api.getPlayerCount();
List<PlayerInfo> survivalPlayers = api.getPlayers("survival-*");
boolean isOnline = api.isPlayerOnline(uuid);

安装方法

  1. 下载 JAR 文件
  2. 将其放入服务器的 plugins 文件夹
  3. 重启服务器
  4. 完成！你的服务器现在可被查询

配置

开箱即用。配置文件：mods/HytaleOne_OneQuery/config.json

{
  "Enabled": true,
  "LegacyProtocolEnabled": true
}

可选功能

网络模式 —— 跨服务器聚合玩家：

{
  "Network": {
    "Enabled": true,
    "ServerId": "lobby-1",
    "NetworkId": "my-network",
    "Mode": "AGGREGATE",
    "Store": {
      "Type": "redis",
      "Redis": { "Host": "localhost", "Port": 6379 }
    }
  }
}

访问控制 —— 使用令牌保护端点：

{
  "Authentication": {
    "Public": { "Basic": true, "Players": false },
    "Tokens": {
      "my-secret-token": { "Basic": true, "Players": true }
    }
  }
}

服务器信息覆盖 —— 自定义显示值：

{
  "ServerInfo": {
    "ServerName": "My Server",
    "Motd": "Welcome!",
    "Host": "play.example.com"
  }
}

查看完整文档了解所有选项。

加入我们的 Discord

需要帮助？想获取更新？加入我们的社区：

👉 discord.gg/y7QJszbpvC

面向开发者

从你的应用查询服务器：

链接

许可证

MIT —— 可自由使用、修改和分发。