Discord Bot Setup Guide

Display live server statistics in your Discord server with locked voice channels that update automatically.

What is the Hylist Discord Bot?

The Hylist Discord bot creates locked voice channels in your Discord server that display real-time statistics from your Hytale server. These channels automatically update to show live data, giving your community instant visibility into your server's status.

Available channel types:

  • Player Count - Shows current and maximum players (e.g., "Players: 42/100")
  • Server Status - Displays online/offline status
  • Server Connection - Shows your server address for easy copying
  • Votes - Monthly vote count from Hylist
  • Vote Link - Direct link to your vote page
  • Server Version - Current server version
  • Platform Stats - Total Hylist servers or players across the platform

Step 1: Invite the Bot to Your Server

First, add the Hylist bot to your Discord server using the invite link below. You'll need "Manage Server" permissions to add the bot.

Add Hylist Bot to Discord

Required Permissions

The bot needs "Manage Channels" and "View Channels" permissions to create and update stat channels.

Step 2: Create a Stat Channel

Use the /spawn-channel command to create a new stat channel. The bot will create a locked voice channel that displays your chosen statistic.

Example command:

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

Command options:

  • type - The type of statistic to display (required)
  • server - Your server slug from Hylist (required for server stats)
  • group - Optional: specify a game mode/group for proxy networks

Template Presets

After running the command, you'll be asked to choose a template preset or create a custom template:

Default Players: 42/100
Compact 42/100
Emoji 🎮 42/100
Minimal 42 online

Custom template placeholders:

{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

Other Commands

/list-channels

View all stat channels in your server

/edit-channel

Modify an existing stat channel's template or settings

/delete-channel

Remove a stat channel

/invite

Get the bot invite link with proper permissions

Multiple Game Modes (Proxy Networks)

If you run multiple backend servers (e.g., Survival, Skyblock, Minigames), you can create separate stat channels for each game mode using the "group" option.

Example:

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

Groups are configured through query ports in your Hylist dashboard. Each backend server needs the One Query plugin to report its stats.

Troubleshooting

Channel not updating?

  • Make sure your server has the One Query plugin installed for live stats
  • Check that your server is listed on Hylist and showing as online
  • Discord rate-limits channel updates, so changes may take a few minutes

Server not found?

  • Use your exact server slug from Hylist (found in your server's URL)
  • The server must be listed and approved on Hylist
  • Server names are case-insensitive, but slugs must match exactly

Bot missing permissions?

  • Make sure the bot has "Manage Channels" permission
  • The bot role must be higher than the channels it manages
  • Re-invite the bot using the /invite command to fix permissions

Need Help?

Join our Discord community for support and to report any issues with the bot.

Join 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.
Back to Help Center