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.

Discord Relay Screenshot

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

Create a bot at discord.com/developers, enable Message Content intent
Drop the JAR in your mods folder
Start server once, then edit mods/DiscordRelay/config.yml
Add your bot token and channel ID
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

DiscordRelay