Overview
A real-time Discord ↔ Hytale bridge with account linking, chat relay, announcements, and multi-server presence.
Table of Contents
Jump to a section
Overview
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
βΊ
HyDiscordX
The missing link between your Hytale server and your Discord community — always connected.
Filters across the overview sections. Use copy buttons for quick setup keys/commands/permissions.
Tip: search "cooldown", "tpa", "warp", "mute", "custom."
Copy buttons use your clipboard
Config path:
mods/HyDiscordX/HyDiscordX.json
Copy
π What HyDiscordX Does
HyDiscordX is a fully featured Discord β Hytale bridge that keeps your server and community connected in real time. Chat flows seamlessly between Hytale and Discord so players can stay involved even when theyβre offline.
Designed for performance, reliability, and clean configuration β from small SMPs to large networks.
π Quick Start
-
Create a Discord bot token:
https://discord.com/developers/applicationsCopy -
Set your token in:
discord.tokenCopy -
Set the relay channel in:
discord.channelIdCopy -
Enable bridging:
discordToHytale.enabledCopy andhytaleToDiscord.enabledCopy -
Restart your server or run:
/hydiscordx reloadCopy
β¨ Core Features
| Feature | Description |
|---|---|
| Account Linking | Link Discord and Hytale with one-time codes. Stored in links.json. |
| Discord β Hytale Bridge | Relays messages from a configured Discord channel into Hytale chat with webhook support for a cleaner look |
| Hytale β Discord Bridge | Relays Hytale chat into Discord with optional mention sanitizing. |
| Announcements | Join/leave/start/stop messages sent to Discord via discordAnnounce. |
| Live server status message | A live stats message that will show the following. Server Name, Player Count, Server TPS, Memory Usage, Uptime, Server IP, Server Version, Restart Times. All options can be disables to show only what you want |
| Presence Updates | Discord bot shows live player count, with optional multi-server player totals. |
| Role Formatting | Prefix + name/message colors per role. Prefixes pulled from LuckPerms and HyEssentialsX |
β¨οΈ Commands (Quick Reference)
| Command | Description |
|---|---|
/link
Copy
|
Run in Discord to get a code; paste in-game to link accounts. |
/unlink
Copy
|
Unlinks Discord from Hytale (in-game & discord). |
/hydiscordx reload
Copy
|
Reloads the plugin config. (in-game) |
/hydiscordx servers
Copy
|
Displays player counts across all configured servers. (in-game) |
Full details live on the Commands page.
π Permissions (Quick Reference)
| Permission | Description |
|---|---|
thelegacyvoyage.hydiscordx.command.link
Copy
|
Allows using /link. |
thelegacyvoyage.hydiscordx.command.unlink
Copy
|
Allows using /unlink. |
thelegacyvoyage.hydiscordx.command.reload
Copy
|
Allows using /hydiscordx reload. |
thelegacyvoyage.hydiscordx.command.servers
Copy
|
Allows using /hydiscordx servers. |
Full details live on the Permissions page.
π Links
Discord:
https://discord.gg/U58ax8cZZ2
Copy
Website:
https://thelegacyvoyage.xyz/
Copy