Installation

Get HyDiscordX running in minutes — bot token, channel ID, and config setup.

Back to HyDiscordX Wiki

Table of Contents

Jump to a section

What it is, features, and goals

› 🧰 Installation

Install steps + recommended setup

› ⌨️ Commands

Command list + examples

› 🔐 Permissions

Permission nodes and rank setup

› ⚙️ Configurations

Config options and details

› 🎓 Tutorials

Common setups and how-to guides

› 👤 Author & Support

Contact, bugs, feedback, links

Install & Configure

Step-by-step installation + common gotchas (token, intents, channel IDs).

1) Drop the mod into your server

Place the HyDiscordX mod/plugin into your Hytale server’s mods folder.
Start the server to generate config file.
Start editing the config.

2) Create a Discord bot + token

Create an application + bot and copy the token:

Discord Developer Portal

Tip: Make sure your bot has permissions to read/send messages in your configured channel and manange roles if you are assiging a role.

3) Configure HyDiscordX

Open: mods/HyDiscordX/HyDiscordX.json

Set discord.token to your bot token.
Set discord.channelId to the target channel ID.
Set discord.commandChannelId to the target channel ID.
Set discord.startStopChannelId to the target channel ID.
Set discord.liveStatsChannelId to the target channel ID.
Set discord.multiServerEnabled leave as false unless you are using the same bot token for multiple servers.
Set storage.type Set as File, MySQL, MiriaDB to set where linked player data is saved.
Enable/disable bridges in discordToHytale and hytaleToDiscord.
If using multi-server presence: configure multiServer and set one server as discord.mainServer.

4) Start the server + test

Run /hydiscordx reload.
Send a message in the configured Discord channel → verify it appears in-game.
Send an in-game chat message → verify it appears in Discord.
Try /link on discord then run the command it sends.