HyDiscordX

🔗 HyDiscordX — The Missing Link Between Hytale & Discord

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, letting players stay involved even when they’re offline. Staff can monitor conversations, respond faster, and keep the community active without being logged into the game. Whether it’s global chat or system messages, HyDiscordX makes your server feel alive 24/7.

Built for performance, reliability, and clean configuration, HyDiscordX is designed for everything from small SMPs to large networks that rely on Discord as their hub.

✨ Features 🔗 Account Linking — Link Discord and Hytale with one-time codes 🎫 Link Codes — Configurable length and expiry 🧾 Link Storage — File-based storage in `links.json` 🛡️ Safe Linking — Prevents duplicate Discord or Hytale links 🔁 Linked Prefix Refresh — Auto-syncs linked prefixes from LuckPerms every 60 seconds 💬 Discord → Hytale Chat Bridge — Relay messages from a single configured channel 🎨 Inline Color Parsing — Discord messages and linked prefixes support legacy (& / §), hex, and tag-based colors 💬 Hytale → Discord Chat Bridge — Optional mention sanitizing 👤 Linked Name Display — Linked Discord messages can show the player name instead of the Discord nickname 🏷️ Prefix Support — Prefixes pulled from LuckPerms only (no other prefix plugins yet) 🎨 Role Formatting — Prefix text + name/message colors per role 🏷️ Discord Tag — Custom tag text and color 📢 Announcements — Join/leave/start/stop messages sent to Discord 📈 Presence Updates — Discord bot shows live player count 🌐 Multi-Server Presence — Aggregate player counts from multiple servers 🧾 Server Status Command — Shows current/max players for all configured servers

Commands /link — Use on Discord to generate a one-time link code also can user !links (will send code as a dm instead) /playerlist Use on discord to see whos online also can use !playerlist /unlink — Unlinks a Discord account from a Hytale account (in-game only) /hydiscordx reload — Reloads the plugin config /hydiscordx servers — Displays player counts for all configured servers

Configuration HyDiscordX.json lives in mods/HyDiscordX.

```text discord: token: Discord bot token used to connect to Discord. channelId: Discord channel ID for chat relay and announcements. startStopChannelId: if set the server start and stop will send to another channel if not it will default to channelId multiServerEnabled: Aggregate player counts across servers. mainServer: Only the main server updates Discord presence when multi-server is enabled.

discordAnnounce: enabled: Send join/leave/start/stop messages to Discord. serverStart: Message sent on server start. serverStop: Message sent on server stop. playerJoin: Message sent when a player joins. Use {player} and {count}. playerLeave: Message sent when a player leaves. Use {player} and {count}.

multiServer: pollSeconds: How often to poll remote servers for player counts (seconds). servers: - name: Display name used in /hydiscordx servers. host: IP or domain of the server web query endpoint. port: WebServer port serving /Nitrado/Query.

linking: codeLength: Length of link code generated by /link. codeTtlSeconds: Link code expiry in seconds.

bridge: discordTagText: Tag shown for Discord messages in Hytale. discordTagColor: Color of the Discord tag text. defaultNameColor: Default name color for Discord messages in Hytale. defaultMessageColor: Default message color for Discord messages in Hytale. roleDefaultMessageColor: Fallback message color for role formatting.

discordToHytale: enabled: Relay Discord messages to Hytale. includePrefixes: will remove prefixs from discord to hytale roleFormats: Optional role-based formatting rules for Discord messages.

hytaleToDiscord: enabled: Relay Hytale messages to Discord.

includePrefixes: will remove prefixs from Hytale to Discord

sanitizeMentions: Strip/escape @mentions when relaying to Discord. ```

Where to get a Discord bot token: https://discord.com/developers/applications

Permissions thelegacyvoyage.hydiscordx.command.link thelegacyvoyage.hydiscordx.command.unlink thelegacyvoyage.hydiscordx.command.reload thelegacyvoyage.hydiscordx.command.servers

If you need changes or additions, just say the word and report any bugs you find!

Discord: https://discord.gg/U58ax8cZZ2 Website: https://thelegacyvoyage.xyz/

You may download and use this plugin on your servers.

The Legacy Voyage Team