HyDiscordX

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