SyncBridge
All-in-one Minecraft ↔ Discord sync suite
Live chat bridge · Rank sync · Player stats · Whitelist management · Punishment logs
What is SyncBridge?
SyncBridge is a premium Minecraft plugin + Discord bot bundle sold as full source code. It keeps your Minecraft server and Discord server in perfect sync — automatically and in real time.
Players link their accounts once with /verify and SyncBridge handles everything else: live in-game chat relayed to Discord (and back), automatic rank role assignment, whitelist management from Discord, punishment broadcasts, and a full /stats command your community will love.
Built for Paper/Spigot 1.17–1.21x. The companion bot is a standalone Node.js (discord.js v14) process — no third-party hosting service required, no SaaS fees, no recurring costs.
What's included in the source
- plugin/ — Full Java Maven project (Paper/Spigot 1.17–1.21, Java 17)
- bot/ — Full Node.js Discord bot (discord.js v14, Express, better-sqlite3)
- config.yml — Fully documented default config
- .env.example — Bot environment template
- pom.xml — Maven build file with SQLite shaded in (no external DB needed)
- SETUP_GUIDE.md — Complete step-by-step setup documentation
Features
Two-Way Live Chat BridgeMessages typed in-game are instantly relayed to a Discord channel. Messages sent in that Discord channel appear in-game for all players. Keeps your online and offline community connected in real time.
/verify — Account LinkingPlayers run /verify in-game to receive a secure, expiring 8-character code. They DM the bot /verify <code> on Discord to permanently link their accounts. Codes expire after 10 minutes. Once linked, rank sync and whitelist automation kick in automatically.
Auto Rank → Discord Role SyncIntegrates natively with LuckPerms. Map any Minecraft rank group to a Discord role ID inside config.yml. Roles are assigned on verification and re-synced every time the player joins. No LuckPerms? Players default to a configurable fallback role.
Whitelist Management from DiscordAdmins can use /whitelist add <player> and /whitelist remove <player> directly from Discord without ever touching the Minecraft console. You can also configure SyncBridge to automatically whitelist players the moment they verify.
Punishment Broadcasts & LogsEvery ban, unban, and kick is automatically broadcast to a dedicated Discord log channel as a rich embed — showing the player name, operator, reason, and duration. Admins can also issue punishments directly from Discord using slash commands.
Player Stats (/stats)Both in-game players and Discord members can view live stats for any player: kills, deaths, K/D ratio, total playtime, and last seen time. Stats are tracked passively and pushed to the bot in real time on logout.
Join / Leave / Death AnnouncementsBroadcasts join, leave, and death events to a Discord channel. Each type is individually toggleable in config.yml. Death messages use the vanilla death message string.
SQLite — No External DatabaseAll data (linked accounts, pending verification codes, player stats) is stored in a local SQLite file. SQLite is shaded directly into the plugin jar — no MySQL setup, no external dependencies.
All commands
In-Game Commands
| Command | Description | Permission | Default |
|---|---|---|---|
| [/verify | Generates a one-time 8-character code and displays it in chat. The player then DMs this code to the Discord bot to permanently link their account. | syncbridge.verify | All players |
| [/stats | Displays your own kills, deaths, K/D ratio, and playtime. | syncbridge.stats | All players |
| /stats <player> | Displays another player's stats by name. | syncbridge.stats.other | OP only |
Discord Slash Commands
| Command | Description | Who can use |
|---|---|---|
| /verify <code> | Complete account linking. The player pastes the 8-character code from in-game. The bot links the Discord account to the Minecraft UUID, assigns the Verified role, and confirms with an embed. | Everyone |
| /stats <player> | Displays a rich embed for any player showing kills, deaths, K/D ratio, playtime, and last-seen timestamp. | Everyone |
| /whitelist add <player> | Adds a Minecraft username to the server whitelist immediately. Sends a confirmation reply visible only to the command user. | Administrator |
| /whitelist remove <player> | Removes a Minecraft username from the server whitelist immediately. | Administrator |
| /ban <player> [reason] [days] | Bans a player from the Minecraft server. Reason and duration (in days) are optional — omitting days makes the ban permanent. Logs an embed to the punishment channel. | Ban Members perm |
| /unban <player> | Pardons a banned player and logs the action to the punishment channel. | Ban Members perm |
| /kick <player> [reason] | Kicks a player from the Minecraft server. Logs the action to the punishment channel. | Kick Members perm |
Requirements
- Paper or Spigot 1.17 – 1.21
- Java 17+
- Node.js 18+ (for the Discord bot)
- A Discord bot application & token — discord.com/developers
- LuckPerms (optional — only needed for rank sync)
Quick start (5 steps)
- Create a Discord bot at discord.com/developers, enable Server Members Intent + Message Content Intent, invite it to your server
- Drop SyncBridge.jar (built via mvn package) into /plugins, start once to generate config.yml
- Edit config.yml — set your Discord invite link, API secret, and rank→ role mappings
- In syncbridge-bot/: copy .env.example → .env, fill in your token + channel IDs, run npm install && node src/index.js
- Join your server, run /verify, DM the bot your code — you're live
FAQ
Do I need a separate server to host the bot?
No. The bot runs as a Node.js process on the same machine as your Minecraft server.
Does rank sync require LuckPerms?
LuckPerms is a soft dependency. Without it, rank sync is skipped and all players get the default Verified role only.
Can I run this on a network (BungeeCord/Velocity)?
Yes — run one plugin instance per backend server, all pointing to the same bot process.
Is the source code obfuscated?
No. You receive 100% clean, readable, well-commented source code.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Questions? Join the support Discord included with your purchase.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Questions? Join the support Discord included with your purchase.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
