WebhookBridge
WebhookBridge is a lightweight, production-ready Paper plugin that bridges Minecraft server events to Discord using highly customizable webhooks. It features rich Discord embeds, a flexible placeholder system, and built-in rate limiting to ensure reliable
WebhookBridge
WebhookBridge is a Paper plugin that connects your Minecraft server to Discord in real-time using Discord's native Webhook API — no bot token, no Discord application, no extra maintenance required.
Features Rich Embeds Sends color-coded, formatted Discord embeds for every major server event, complete with titles, descriptions, and footers.
No Bot Token Needed Works with a standard Discord Webhook URL. Setup takes minutes.
Flexible Event Routing Send deaths, advancements, chat, and other events to different Discord channels using named webhook targets. Smart Placeholders Craft dynamic messages using tokens like {player}, {online}, {server_tps}, {world}, and {death_message}. High Performance Asynchronous dispatch with a token-bucket rate limiter keeps your TPS unaffected, even during heavy traffic. Reliable Delivery Built-in retry logic handles network hiccups and Discord 429 rate limit responses automatically. Player Avatars Pulls player skins from mc-heads.net and displays them as webhook avatars or embed thumbnails.
Supported Events Category Events Server 🟢 Online, 🔴 Offline Players Join, Quit (with player count) Gameplay Deaths (with death messages), Advancements Chat Real-time bridging with per-player name and avatar Commands All commands require the webhookbridge.admin permission.
Command Description
-
/webhookbridge reload Reload the config without restarting
-
/webhookbridge status View queue depth, rate limits, and webhook health
-
/webhookbridge test
Fire a test embed to verify your setup Requirements Platform: Paper or compatible forks (Purpur, etc.)
Version: 1.21.x – 26.1.2+ Java: 21 or higher
