The Legacy Voyage

Tutorials

Step-by-step guides for linking, bridging chat, multi-server presence, and role formatting.

Back to HyDiscordX Wiki
Table of Contents
Jump to a section
Wiki Home
📌 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
 ›
Guided Setup
Searchable sections with copy buttons for common keys & values.
Filters across all tutorial cards. Copy buttons provided for common config keys.
Tip: search "cooldown", "tpa", "warp", "mute", "custom." Copy buttons use your clipboard
Config path: mods/HyDiscordX/HyDiscordX.json
1) Create a Discord Bot + Get Your Token
  1. Go to https://discord.com/developers/applications Copy
  2. Create a new application → add a Bot.
  3. Copy the bot token and paste it into: discord.token Copy
  4. Invite the bot to your server with the permissions you need (Send Messages / Read Messages / View Channel).
Config key:
discord.token Copy
2) Set the Relay Channel (channelId)
  • Enable Developer Mode in Discord settings.
  • Right click your channel → Copy Channel ID.
  • Paste into: discord.channelId Copy
Config key:
discord.channelId Copy
3) Enable the Chat Bridges
Discord → Hytale:
discordToHytale.enabled Copy
Hytale → Discord:
hytaleToDiscord.enabled Copy
Tip: If you want to prevent Discord pings from in-game chat, enable: hytaleToDiscord.sanitizeMentions Copy
4) Account Linking (How /link Works)
  1. Run /link in Discord to generate a code.
  2. Run /link <code> in-game to complete linking.
  3. Linked accounts are stored in: mods/HyDiscordX/links.json Copy
Code settings: linking.codeLength Copy  and  linking.codeTtlSeconds Copy
5) Multi-Server Presence (Total Player Count)
  • Enable: discord.multiServerEnabled Copy
  • Set only ONE server as the presence updater: discord.mainServer Copy
  • Configure polling: multiServer.pollSeconds Copy
  • Fill out the server list: multiServer.servers Copy
  • Set the port to nitrados port: multiServer.servers.port Copy
Remote servers must expose: /Nitrado/Query Copy If you have multiple servers on the same ip you need to make a config file config.json: with { "BindPort": 5523 } the port must be unique to that server it cant overlap others. Copy