DiscordBridge - MC to Discord Sync

DiscordBridge | MC ↔ Discord
Full Synchronization between Minecraft and Discord

If you find this useful, please leave a review!

About

DiscordBridge is a full-featured synchronization plugin for Paper servers. It connects your Minecraft server with your Discord server — bidirectionally. Chat flows both ways, punishments get logged automatically, and your bot always shows live player count and TPS.

No external dependencies, no separate bot server needed. Drop the JAR in, configure your token and webhooks, done.

Features

Bidirectional Chat
Messages flow from Minecraft to Discord and back. LuckPerms prefixes are automatically included — stripped of color codes for clean Discord display. Discord role prefixes show ingame with configurable color codes.

Embeds
All messages are sent as colored Discord embeds. Every channel type has its own configurable color.

Join / Leave / First Join
Join and leave messages post automatically. First-time joins get a special configurable message.

Death Messages
Every death message is forwarded to Discord automatically.

BanSystem Integration
Works with any punishment plugin — keyword-based broadcast filter catches ban, mute, kick and warn broadcasts. Vanilla /ban and /pardon are also caught.

Op / Deop & Whitelist
/op, /deop, /whitelist add and /whitelist remove are all logged to Discord with the executing staff member.

Server Status
Server start and stop messages with configurable reason. Use /shutdown, /stopserver or /restartserver with a reason argument.

Bot Status
Bot activity automatically shows live player count and TPS — updates on every join/leave and every 30 seconds.

Discord Commands
Execute server commands from a Discord channel. Role-based permission system — only configured roles can use commands.

Anti-Spam
Repeated identical messages within a configurable time window are not posted twice.

Bypass System
Players with the bypass permission or listed in config are fully invisible to Discord — no chat, no join/leave, nothing.

Commands

Code:

/discordbridge reload        — Reload config
/shutdown [reason]           — Stop server with reason → Discord
/stopserver [reason]         — Alias for shutdown
/restartserver [reason]      — Restart server with reason → Discord

Permissions

Code:

discordbridge.admin          — Reload config, use shutdown commands
discordbridge.bypass         — Fully invisible to Discord

Requirements

Paper 1.21.4
Java 17+
Discord Bot Token (free — setup guide included in config)
Discord Webhook URLs

Optional:

LuckPerms — for automatic prefix display
PlaceholderAPI — alternative prefix source

Installation

Drop the JAR into your plugins/ folder
Start the server once to generate config.yml
Create a Discord bot at discord.com/developers/applications
Enable MESSAGE CONTENT INTENT and SERVER MEMBERS INTENT
Enter your bot token and webhook URLs in config.yml
Run /discordbridge reload — done!

Support

Found a bug or have a question? Send me a message directly here on BuiltByBit.

If you find this useful, please leave a review!

DiscordBridge - MC to Discord Sync v1.0.0

Overview Dependencies History