Discord 机器人设置指南

在您的 Discord 服务器中显示实时服务器统计数据,使用自动更新的锁定语音频道。

什么是 Hylist Discord 机器人?

Hylist Discord 机器人会在您的 Discord 服务器中创建锁定的语音频道,显示来自您 Hytale 服务器的实时统计数据。这些频道会自动更新以显示实时数据,让您的社区能够即时了解服务器状态。

可用频道类型:

  • 玩家数量 - 显示当前和最大玩家数(例如「玩家:42/100」)
  • 服务器状态 - 显示在线/离线状态
  • 服务器连接 - 显示您的服务器地址以便复制
  • 投票 - 来自 Hylist 的月度投票数
  • 投票链接 - 直接链接到您的投票页面
  • 服务器版本 - 当前服务器版本
  • 平台统计 - 平台上的 Hylist 服务器或玩家总数

步骤 1:邀请机器人到您的服务器

首先,使用下方的邀请链接将 Hylist 机器人添加到您的 Discord 服务器。您需要「管理服务器」权限才能添加机器人。

将 Hylist 机器人添加到 Discord

所需权限

机器人需要「管理频道」和「查看频道」权限才能创建和更新统计频道。

步骤 2:创建统计频道

使用 /spawn-channel 命令创建新的统计频道。机器人将创建一个显示您选择的统计数据的锁定语音频道。

示例命令:

/spawn-channel type:Player Count server:my-server-slug

命令选项:

  • type - 要显示的统计类型(必填)
  • server - 来自 Hylist 的服务器 slug(服务器统计必填)
  • group - 可选:为代理网络指定游戏模式/分组

模板预设

运行命令后,系统会要求您选择模板预设或创建自定义模板:

默认 Players: 42/100
紧凑 42/100
表情符号 🎮 42/100
极简 42 online

自定义模板占位符:

{current}      - Current players
{max}          - Max players
{status}       - Online/Offline text
{status_emoji} - ✅ or 🔴
{address}      - Server address
{votes}        - Monthly votes
{version}      - Server version
{server_name}  - Server name
{group_name}   - Group/game mode name

其他命令

/list-channels

查看服务器中的所有统计频道

/edit-channel

修改现有统计频道的模板或设置

/delete-channel

删除统计频道

/invite

获取具有正确权限的机器人邀请链接

多个游戏模式(代理网络)

如果您运行多个后端服务器(例如生存、空岛、小游戏),可以使用「group」选项为每个游戏模式创建单独的统计频道。

示例:

/spawn-channel type:Player Count server:my-server group:Survival
/spawn-channel type:Player Count server:my-server group:Skyblock

分组通过 Hylist 仪表板中的查询端口配置。每个后端服务器需要安装 One Query 插件来报告其统计数据。

故障排除

频道没有更新?

  • 确保您的服务器已安装 One Query 插件以获取实时统计数据
  • 检查您的服务器是否已在 Hylist 上列出并显示为在线
  • Discord 会限制频道更新频率,因此更改可能需要几分钟

找不到服务器?

  • 使用来自 Hylist 的确切服务器 slug(在您服务器的 URL 中找到)
  • 服务器必须已在 Hylist 上列出并获得批准
  • 服务器名称不区分大小写,但 slug 必须完全匹配

机器人缺少权限?

  • 确保机器人具有「管理频道」权限
  • 机器人角色必须高于它管理的频道
  • 使用 /invite 命令重新邀请机器人以修复权限

需要帮助?

加入我们的 Discord 社区获取支持并报告机器人的任何问题。

加入 Hylist Discord

Popular Use Cases

The Hylist Discord bot is versatile and can be used in many ways to keep your community informed and engaged. Here are some of the most popular configurations used by top Hytale server communities.

Status Dashboard Channel

Create a dedicated "#server-status" channel with multiple stat channels showing player count, server version, and online status. This gives your community an at-a-glance view of your server's health without needing to log in.

Vote Tracking

Set up a vote counter channel that displays your current monthly vote count. This creates friendly competition within your community and motivates players to help reach vote milestones. Some servers set goals like "Help us reach #1 this month!"

Multi-Server Networks

If you run multiple game servers or game modes, create separate stat channels for each one. Use the group parameter to track individual proxy backends. This lets players see which game modes are most active before joining.

Quick Vote Link Access

Create a vote link channel that displays a clickable link to your server's vote page. Pin it in your main chat or announcements channel. This is the easiest way to increase daily votes since players can vote directly from Discord without searching for your server.

Frequently Asked Questions

How often do stat channels update?
Stat channels update approximately every 5 minutes. Discord rate-limits channel name changes, so more frequent updates aren't possible. The data displayed is sourced from Hylist's server query system, which polls your game server every 60 seconds.
Is there a limit to how many stat channels I can create?
You can create multiple stat channels per Discord server. However, keep in mind that Discord has a 500-channel limit per server, and each stat channel takes one slot. For most servers, 3-5 stat channels provide comprehensive coverage without cluttering your channel list.
Can I use the bot in multiple Discord servers?
Yes! You can invite the Hylist bot to as many Discord servers as you like. Each Discord server can have its own independent set of stat channels tracking the same or different Hytale servers. This is useful if you have a public community Discord and a separate staff Discord.
返回帮助中心