WebhookBridge

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.2+
Java: 21 or higher