DiscordRelay

Discord Relay

Bridges your Hytale server with Discord. Chat syncs both ways, player events get posted to your channel, and you can even run console commands from Discord.

Features

• Chat relay - messages sync between Discord and in-game
• Join/leave notifications - with player avatar thumbnails
• Death messages - announces player deaths
• Server start/stop announcements
• Console channel - run server commands from Discord
• Account linking - link Discord to in-game accounts with /link
• Player stats - track playtime, blocks placed/broken, chat messages, deaths
• Role sync - auto-assign Discord roles when linked (bot needs Manage Roles)
• Nickname sync - set Discord nickname to in-game name (bot needs Manage Nicknames)
• Bot status - shows player count as Discord bot status
• Chat filter - censor or block words (configurable word list)
• Embed messages - Discord embeds for join/leave/death/status (bot needs Embed Links)
• AFK detection - marks players as AFK after configurable timeout

Commands

Supports both slash commands and prefix commands.

Discord:

• /players or !players - list online players
• /link <code> or !link <code> - link your account
• /unlink or !unlink - unlink your account
• /stats [player] or !stats [player] - view player statistics

In-game:

• /players - list online players
• /link - get a link code
• /unlink - unlink your account

Config

• Toggle any feature on/off
• Custom message formats with %player% and %message% placeholders
• Console command blacklist (blocks dangerous commands by default)
• Named colors supported (red, dodgerblue, etc.) or hex codes
• Chat filter with censor or block mode
• Optional embed messages (can be disabled for plain text)
• Separate channels for chat, console, and join/leave messages
• Webhook mode - create a webhook in Discord and set the URL in config to show player avatars and usernames in chat messages

Setup

1. Create a bot at discord.com/developers, enable Message Content intent
2. Drop the JAR in your mods folder
3. Start server once, then edit mods/DiscordRelay/config.yml
4. Add your bot token and channel ID
5. Restart

Privacy Notice

Player avatars are rendered using Crafthead (crafthead.net), which generates Minecraft-style head images from player UUIDs. You can disable avatars in the config by setting avatar.enabled to false.

Note: The avatar feature is currently in beta and may occasionally fail or be slow. If avatars aren't loading, the plugin will fall back to showing messages without avatars.

Support

For issues, suggestions, or questions, join our Discord: https://discord.gg/knXSzeute3