
π DiscordBridge
DiscordBridge is a lightweight Hytale server plugin that sends server events directly to Discord using a Webhook.
No Discord bot.
No tokens.
No external hosting required.
Designed to be drop-in, easy to configure, and safe for public servers.
β¨ Features
- β
Server ONLINE / OFFLINE notifications
- β
Player JOIN / LEAVE notifications
- β
Discord embeds for join/leave events
- β
Fully customizable embeds via
config.json
- β
Placeholder support:
{playerName}
{serverName}
{disconnectReason}
- β
Works with Discord webhooks only
- β
Survives Hytale API changes via reflection
- β
Zero runtime dependencies
π¦ Installation
- Download
DiscordBridge-x.y.z.jar
- Place it in your Hytale server
mods/ directory
- Start the server once (this generates
config.json)
- Edit
config.json and set your Discord webhook URL
- Restart the server
π§ Creating a Discord Webhook
- Open Discord
- Go to Channel Settings β Integrations β Webhooks
- Click New Webhook
- Copy the Webhook URL
- Paste it into
config.json
β¨οΈ Commands
/discordbridge reload
Reloads config.json without restarting the server.
Default permission:
discordbridge.reload
You can change this permission via reloadPermission in config.json
Workflow:
- Edit
config.json
- Run
/discordbridge reload
- Changes apply immediately
βοΈ Configuration (config.json)
{
"webhookUrl": "PASTE_WEBHOOK_HERE",
"serverName": "My Hytale Server",
"sendServerStartStop": true,
"sendJoinLeave": true,
"useEmbedsForJoinLeave": true,
"webhookUsername": "Hytale Bridge",
"webhookAvatarUrl": "",
"joinEmbed": {
"title": "Player Joined",
"description": "β **{playerName}** joined **{serverName}**",
"color": 65280,
"footerText": "{serverName}",
"thumbnailUrl": "",
"includeTimestamp": true
},
"leaveEmbed": {
"title": "Player Left",
"description": "β **{playerName}** left **{serverName}**\nReason: `{disconnectReason}`",
"color": 16711680,
"footerText": "{serverName}",
"thumbnailUrl": "",
"includeTimestamp": true
}
}
NOTES
- Embed color values are decimal integers (Discord format)
- Leave fields blank to omit them from embeds
- Some changes may require a server restart
Compatibility
- Requires the official Hytale server
- Built against the Hytale Server API
- Java version must match the server runtime