🔗 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.

Wiki: https://wiki.thelegacyvoyage.xyz/HyDiscordXWiki

✨ Features
🔗 Account Linking — Link Discord and Hytale with one-time codes
🎫 Link Codes — Configurable length and expiry
🧾 Link Storage — SQLite by default (links.db), plus MariaDB/MySQL via JDBC
🧹 Link Cleanup — Removes links for Discord users who left the server
🛡️ Safe Linking — Prevents duplicate Discord or Hytale links
🎭 Optional Role Grant — Give a Discord role on link
🪪 Optional Nickname Sync — Set a Discord nickname on link
🔁 Linked Prefix Refresh — Auto-syncs linked prefixes from LuckPerms every 60 seconds
💬 Discord → Hytale Chat Bridge — Relay messages from a configured channel
🎨 Inline Color Parsing — Discord messages and linked prefixes support legacy (& / §), hex, and tag-based colors
💬 Hytale → Discord Chat Bridge — Optional mention sanitizing
🪝 Webhook Chat Support — If `chatwebhook` is set, Hytale → Discord uses the webhook instead of the bot
🖼️ Webhook Avatars — Webhook messages use the player’s UUID to pull a face image from Hytale Tracker
👤 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 in Hytale chat
📢 Announcements — Join/leave/start/stop messages sent to Discord
⚔️ Death/Kill Feed — Optional Discord channel for combat messages
📈 Presence Updates — Discord bot shows live player count with status templates
🌐 Multi-Server Presence — Combine player counts from multiple servers
🧾 Server Status Command — Shows current/max players for all configured servers
📊 Live Stats Embed — Rich status message with TPS, memory, uptime, and more
🛂 Discord Whitelist — Role-based allow/deny access with optional kick
🎙️ Voice Announce — Announce linked users joining voice channels in-game
🧠 Profiles + Playtime — Profile command, playtime lookup, and top 10 leaderboard
🌍 Language Support — Built-in: ar, bn, de-de, en-us, es-es, hi-in, ja-jp, pa, pt-br, ru-ru, zh-cn
🏷️ Role → Rank Sync — Map Discord roles to LuckPerms groups for linked players
⚡ Force Sync — Run a manual role → rank sync any time
♻️ Reload Support — Reload role mappings in-game
🧰 Debug Toggle — Silence all plugin console logs unless debug is enabled
🧩 API — Integration details are on the wiki

Commands
/link — Use on Discord to generate a one-time link code (also `!links` to DM)
/playerlist — Use on Discord to see who’s online (also `!playerlist`)
/profile — Show a player profile (Discord)
/playtime — Show playtime (Discord)
/playtimetop — Show top 10 playtime (Discord)
/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
/hydiscordranksx reload — Reloads role → rank sync config
/hydiscordranksx forcesync — Forces a role → rank sync

Requirements
- HyDiscordX (for account linking)
- LuckPerms (for group/rank management)

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

📈 Live Stats

Live Stats embeds can show:
- Player counts
- TPS
- Memory
- Uptime
- Server IP
- Version
- Next restart time
- Server name (toggleable)
- Rotating list of online players (max 5 per refresh)

🎙️ Voice Announce

Optional voice channel announcements:
- Detects linked users joining configured voice channels
- Sends an in‑game message like:
`%ingamename% joined %voicechannelname% come join them.`

🌍 Language Support

Built‑in languages:
English, Chinese (Simplified), Spanish, Hindi, Arabic, Bengali, Portuguese (Brazil), Russian, Japanese, Punjabi, German.

Custom language files supported.

🧩 API for Other Plugins

HyDiscordX exposes a lightweight Java API:
- Query linked players
- Listen for link/unlink/playtime updates
- Access online linked players

✅ Commands

`/link` — Generate a one‑time code (Discord or in‑game)
`/unlink` — Unlink a Discord account from Hytale (in‑game)
`/playerlist` — Discord command to list online players
`/hydiscordx reload` — Reload config
`/hydiscordx servers` — Show status of all configured servers

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

Discord: https://discord.gg/U58ax8cZZ2

You may download and use this plugin on your servers.

The Legacy Voyage Team