💬 DiscordFantastic V1.1

Discord Webhook Avatar Preview

You can disable the small avatar preview thumbnail under Discord webhook messages in the config:

Webhook:
  Enabled: true
  Url: "YOUR_WEBHOOK_URL"
  AvatarUrlFormat: "https://crafthead.net/hytale/avatar/%uuid%/64"
  ShowAvatarThumbnail: false

If you already have the mod installed, you do not need to delete or recreate your config file. Just add this line to the existing Webhook section in your config:

ShowAvatarThumbnail: false

If you want the avatar preview to stay visible, set it to true:

ShowAvatarThumbnail: true

alt text

DiscordFantastic is a lightweight Discord relay mod for Hytale servers.

It connects your Hytale server chat with a Discord channel and allows players to communicate between Discord and the game.

✨ Features

💬 Ingame chat to Discord
🎮 Discord chat to ingame
🟢 Join and leave messages
🚀 Server start and stop messages
🪝 Webhook support for player names
🧑 Hytale player avatars via Crafthead
🖼️ Avatar fallback as Discord embed thumbnail
⚙️ Configurable channels
📝 Configurable message formats
📄 Simple YAML configuration

🪝 What does the Webhook do?

The Discord bot token is used to connect the bot and read messages from Discord.

The webhook is used for ingame chat messages going to Discord.

With a webhook, DiscordFantastic can display ingame messages like this:

PlayerName: Hello everyone!

instead of:

DiscordFantastic: **PlayerName**: Hello everyone!

The webhook allows DiscordFantastic to use the player's name as the message sender.

It also adds the player's Hytale avatar as an embed thumbnail.

⚙️ Setup

1️⃣ Create a Discord Bot

Go to the Discord Developer Portal.
Create a new application.
Add a bot to the application.
Copy the bot token.
Invite the bot to your Discord server.
Make sure the bot has permission to read and send messages.

The bot needs the following permissions:

👀 View Channels
💬 Send Messages
📜 Read Message History
😀 Use External Emojis
🔗 Embed Links

You also need to enable the Message Content Intent in the Discord Developer Portal.

2️⃣ Get your Discord Channel ID

Enable Developer Mode in Discord.
Right-click your Discord chat channel.
Click Copy Channel ID.
Paste the ID into the config.

3️⃣ Create a Webhook

The webhook is needed for better looking ingame chat messages in Discord.

Open your Discord server.
Right-click the channel where ingame chat should appear.
Click Edit Channel.
Go to Integrations.
Open Webhooks.
Click New Webhook.
Choose the correct channel.
Click Copy Webhook URL.
Paste the URL into the config.

Your webhook URL looks similar to this:

https://discord.com/api/webhooks/123456789012345678/xxxxxxxxxxxxxxxxxxxx

⚠️ Do not share your webhook URL publicly.

📄 Example Config

Discord:
  Token: "Discord Developer Portal Token"
  ChatChannelId: "Channel ID"
  JoinLeaveChannelId: "Channel ID"
  StatusChannelId: "Channel ID"

Webhook:
  Enabled: true
  Url: "Right-click on the channel/Edit Channel/Integrations/Add Webhook
"
  AvatarUrlFormat: "https://crafthead.net/hytale/avatar/%uuid%/64"

Features:
  ChatToDiscord: true
  DiscordToChat: true
  JoinLeave: true
  ServerStatus: true

Formats:
  DiscordToGame: "[Discord] %user%: %message%"
  GameToDiscord: "**%player%**: %message%"
  Join: ":green_circle: **%player%** joined the server"
  Leave: ":red_circle: **%player%** left the server"
  ServerStart: ":white_check_mark: **Server started**"
  ServerStop: ":octagonal_sign: **Server stopped**"

Debug:
  Enabled: false

🔍 Config Explanation

💙 Discord

Token: ""

Your Discord bot token.

ChatChannelId: ""

The Discord channel ID used for chat messages.

JoinLeaveChannelId: ""

The Discord channel ID used for join and leave messages.

If empty, the chat channel is used.

StatusChannelId: ""

The Discord channel ID used for server start and stop messages.

If empty, the chat channel is used.

🪝 Webhook

Enabled: true

Enables webhook messages for ingame chat.

Url: ""

Your Discord webhook URL.

AvatarUrlFormat: "https://crafthead.net/hytale/avatar/%uuid%/64"

The avatar URL format used for Hytale player avatars.

Available placeholders:

%uuid%   Player UUID
%player% Player name

✨ Features

ChatToDiscord: true

Sends ingame chat messages to Discord.

DiscordToChat: true

Sends Discord messages to the ingame chat.

JoinLeave: true

Sends join and leave messages to Discord.

ServerStatus: true

Sends server start and stop messages to Discord.

📝 Formats

You can customize the text of all messages.

Available placeholders:

%player%  Hytale player name
%user%    Discord username
%message% Chat message
%uuid%    Player UUID

Example:

DiscordToGame: "[Discord] %user%: %message%"

🔐 Important Security Notice

Never share your Discord bot token or webhook URL.

Do not upload your real config file with your token or webhook URL to CurseForge, GitHub, Discord, or any public place.

If you accidentally shared your token or webhook URL:

Reset your bot token in the Discord Developer Portal.
Delete the old webhook in Discord.
Create a new webhook.
Update your config with the new values.

🛠️ Troubleshooting

❌ Discord messages do not appear ingame

Check:

The bot token is correct.
Message Content Intent is enabled.
The bot is invited to your Discord server.
The bot can read the selected channel.
DiscordToChat is set to true.

❌ Ingame messages do not appear in Discord

Check:

ChatToDiscord is set to true.
ChatChannelId is correct.
The webhook URL is correct.
The bot and webhook both use the correct Discord channel.

🖼️ Avatars are not shown as profile pictures

Discord can be strict with webhook avatar URLs.

DiscordFantastic also adds the Hytale avatar as an embed thumbnail so the player's avatar is still visible in the message.

🙌 Inspiration

This mod was inspired by Relay Mod.

❤️ Support

If you enjoy this mod, consider leaving a ⭐ on CurseForge!

🔗 Check Out My Other Hytale Projects

Take a look at my other Hytale mods and projects here:

👉 DerFriesn CurseForge Projects

Tale-World German Community

IP: play.tale-world.com
https://tale-world.com/

Discord Fantastic V1.1 - Thumbnail: false/ true