One Query 插件设置指南
了解如何设置 One Query 插件，在您的 Hylist 列表上显示实时玩家数量、在线玩家和服务器信息。
Supported Plugins
Hylist supports two query plugins. Install one of them (not both - they are mutually exclusive):
One Query
The recommended plugin with full feature support including plugin version and status info.
Hyvote
Alternative plugin with configurable exports. Lets you toggle exactly what data to expose.
Important: These plugins are mutually exclusive. Only install one of them - do not install both on the same server.
什么是 One Query？
These plugins enable server status queries using UDP. They share your game server port, so no additional ports or firewall configuration is needed. This allows Hylist to fetch real-time data about your server, including:
- 当前玩家数量和最大玩家数
- 在线玩家列表及其名称和 UUID
- 服务器版本和 MOTD
- 已安装插件列表
步骤 1：安装插件
Download and install either One Query or Hyvote on your Hytale server:
- 从 GitHub 发布页面下载最新的 JAR 文件
- 将 JAR 文件放入服务器的 plugins 目录
- 重启服务器
无需额外配置！插件会直接使用您的游戏服务器端口（5520）运行。
步骤 2：在 Hylist 中添加查询端口
在 Hylist 仪表板中配置您的查询端口：
- 在 Hylist 仪表板中转到服务器编辑页面
- 滚动到「查询端口」部分
- 点击「添加查询端口」
- 输入端口 5520（或您的游戏服务器端口，如果不同）
- 可选择一个标签将此端口与游戏模式关联
- 保存更改
多个游戏模式（代理网络）
如果您运行多个后端服务器，可以添加多个查询端口——每个游戏模式一个：
Port 5520 -> No tag (Lobby) Port 5521 -> PvP Port 5522 -> Survival 每个后端服务器都需要自己的 One Query 插件实例。标签帮助访客了解每个玩家列表属于哪个游戏模式。
验证设置
配置完成后，验证您的设置：
- 确保您的服务器在线且 One Query 插件正在运行
- 等待几分钟让 Hylist 查询您的服务器
- 访问您在 Hylist 上的服务器页面
- 您应该看到玩家数量、在线玩家、版本和插件信息
如果一切正常，您将在服务器页面上看到绿色的「在线」徽章和实时玩家信息！
故障排除
Hylist上没有显示数据？
- 确认One Query插件JAR文件在你的plugins文件夹中
- 检查服务器日志是否有插件错误
- 确保Hylist中的端口号与你的服务器端口匹配（默认：5520）
- 等待5-10分钟让Hylist刷新服务器数据
玩家数量或信息不正确？
- 确保查询端口指向正确的服务器
- 如果使用多个服务器，确保每个服务器都配置了自己的端口
Why Server Query Matters for Your Listing
Adding server query to your Hytale server listing significantly improves your visibility and credibility on Hylist. Here's how real-time server data impacts your server's performance on the platform.
Higher Search Ranking
Servers with active query data appear higher in filtered searches. When players filter by "online only" or sort by player count, your server will only appear if query data is available. Without it, you're invisible to a significant portion of potential players.
Player Trust
Displaying real-time player counts and server status builds trust with potential players. A server showing "42 players online" is far more compelling than one with no data. Players are more likely to join and vote for servers they can verify are active.
Analytics Insights
Query data feeds into your server's analytics dashboard, showing player count trends over time. You can identify peak hours, track growth, and measure the impact of promotional campaigns or content updates.
Discord Integration
The Hylist Discord bot uses query data to display live player counts and server status in your Discord server. Without query configured, these stat channels will show limited information.