Changelog
[1.0.4] – 2025-11-15
Added
- Discord Webhook Integration
- Optional webhook support for sending server events to a Discord channel.
- Configurable webhook username and avatar.
- Chat Relay to Discord
- Optional feature: send player chat messages to the configured webhook (discord.send-chat).
- Customizable message template via discord.chat-message-template
(supports {player}, {displayname}, {message}, {server})
Changed
- Improved embed generation for Discord join/quit notifications.
- Embeds are now automatically used when discord.use-embeds is enabled.
Fixed
- Avatar fetch issues in Discord embeds resolved:
- Crafatar UUIDs are now processed without hyphens and fetched directly as PNG.
- Added validation and fallback logic to prevent broken avatar images.
Removed
- Player avatar is no longer included by default in join/quit embeds.
(Prevents broken or placeholder images with certain UUID formats.)
Config Changes
Added to config.yml under the discord: section:
# Chat relay: send player chat messages to the Discord webhook
send-chat: false
# Template for chat messages sent to Discord
# Placeholders: {player}, {displayname}, {message}, {server}
chat-message-template: "{displayname}: {message}"
Notes / Upgrade Instructions
- After updating, set your discord.webhook-url and enable integration with:
discord:
enable: true
- A server restart is recommended after modifying Discord-related settings.
Technical
- All webhook calls are executed asynchronously to avoid blocking the main server thread.
- Embed JSON is built using safe escaping and optional fields such as author and thumbnail.