DiscordSync v1.0

Discord Sync​

Discord Sync is a Velocity plugin that connects your Minecraft server with your Discord server by linking player accounts and automatically syncing LuckPerms ranks to Discord roles.

This plugin removes the need for manual role management and provides a clean, automated system for keeping your Discord roles updated based on in-game ranks.

It is built for performance, simplicity, and reliability, making it suitable for both small servers and large networks.

---

What this plugin offers​

Account Linking System​

Players can link their Minecraft account to Discord using a simple and secure process.

• Run /discord link in-game
• Receive a unique code
• Paste the code in the configured Discord channel
• The account is linked instantly

Each code is time-limited and unique, ensuring secure linking.

---

Automatic Rank Sync​

The plugin integrates with LuckPerms to sync ranks directly to Discord roles.

• Detects player groups (primary and inherited)
• Assigns matching Discord roles
• Removes roles when ranks are removed
• Updates instantly without requiring a restart

This ensures your Discord always reflects your server ranks.

---

Role Management System​

• Supports linked and not-linked roles
• Automatically removes the "not linked" role after linking
• Adds a "linked" role when the player connects their account
• Fully configurable role mapping

---

Discord Integration​

• Dedicated sync channel for linking
• Log channel for events and updates
• Status channel for live server information
• Optional webhook support for logs

---

Live Server Status​

Display your server activity directly inside Discord:

• Shows online/offline status
• Displays player count
• Updates automatically at a set interval

---

In-Game Messages​

Players receive clear messages during the linking process:

• Link code generation
• Successful linking confirmation
• Unlink confirmation

---

Discord Bot Messages​

The bot sends updates in Discord such as:

• Linking instructions
• Account linked confirmation
• Role update logs
• Server status updates

---

Configuration System​

The plugin is fully configurable through config.yml:

• Bot token and server ID
• Channel IDs (sync, logs, status)
• Role IDs (linked, not linked, rank roles)
• Code length and expiry time
• Cooldowns for commands
• Server status settings

---

Console Output​

On startup, the plugin prints useful information such as:

• Loaded rank mappings
• Linked role and unlinked role
• Sync settings
• Status system status

This helps with debugging and setup.

---

How it works​

1. Player runs /discord link
2. Plugin generates a unique code
3. Player pastes it in Discord
4. Bot verifies the code
5. Account is linked
6. Roles are synced automatically

---

Installation Process​

Step 1: Download

• Go to BuiltByBit
• Purchase DiscordSync
• Download the .jar file

Step 2: Install

• Copy DiscordSync.jar into your plugins/ folder
• Start your server once

Step 3: Dependencies

• Install LuckPerms (any version)
• Make sure you are using a Velocity proxy

Step 4: Configuration

• Open plugins/DiscordSync/config.yml
• Enter your bot token, server ID, channel IDs, and role IDs (make sure bot has the highest role in the server)

Step 5: Restart & Done

• Restart your server
• Check console for: "DiscordSync] Plugin enabled!"

---

Requirements​

• Velocity
• Java 21
• LuckPerms
• Discord bot with proper permissions

---

Commands​

• /discord link – Generate a link code
• /discord unlink – Unlink your account
• /discord reset <player> – Reset another player’s link

---

Support​

• Discord: armanrazakhan
• Instagram: armanrazakhan
• Email: [email protected]

---

Why use Discord Sync?​

• Fully automatic system
• No manual role handling
• Clean and simple setup
• Works instantly after linking
• Lightweight and optimized

---

Images​