Home

UxmDiscordSync Wiki

UxmDiscordSync is an advanced Discord synchronization plugin for Paper/Spigot Minecraft servers (1.21+). It provides deep integration between your Minecraft server and a Discord guild — including account linking, rank sync, chat bridging, a level system, two-factor authentication, and much more.

---

Navigation

Setup

• Getting Started — Installation, dependencies, and first-time setup
• Configuration Overview — All configuration files explained
• Database Setup — Supported databases and connection options
• Permissions — All permission nodes

Core Systems

• Account Linking — Linking Minecraft accounts to Discord
• Rank Synchronization — Sync LuckPerms groups to Discord roles
• Nickname Synchronization — Mirror Minecraft names to Discord nicknames

Features

• Chat Bridge — Two-way chat relay between Minecraft and Discord
• Boost Rewards — Reward players who boost your Discord server
• Two-Factor Authentication — Secure logins with Discord-based 2FA
• Level System — Discord XP and leveling with Minecraft rewards
• Server Stats — Live server statistics embed in Discord
• Punishment Sync — Sync bans/mutes between Minecraft and Discord

Logging

• Logging — Audit logs, chat logs, and join/leave logs via webhooks

Commands

• Minecraft Commands — All in-game commands and their usage
• Discord Commands — Built-in Discord slash commands
• Custom Commands — Create your own Discord slash commands

Advanced

• Multi-Server Support — Using the plugin across multiple servers
• Placeholders — All supported placeholder variables

---

Quick Summary

Feature	Description
Account Linking	Link Discord accounts to Minecraft via 6-digit codes
Rank Sync	Map LuckPerms groups to Discord roles
Nickname Sync	Mirror Minecraft names into Discord server nicknames
Chat Bridge	Relay chat between Discord channels and Minecraft
Boost Rewards	Run commands when a player claims their boost reward
2FA	Require Discord approval on every Minecraft login
Level System	Award XP for Discord activity, give Minecraft rewards
Server Stats	Auto-updating embed showing players online, TPS, RAM
Punishment Sync	Bridge bans/mutes across both platforms
Audit Logging	Webhook-based audit trail for all major events

---

Requirements

• Minecraft: Paper 1.21 or newer
• Java: 21 or newer
• Discord Bot: A bot token and a guild where the bot has Admin permissions
• Optional: LuckPerms (for rank sync), PlaceholderAPI (for custom commands)