# DiscordSync<\/p>\n
DiscordSync is a powerful and efficient Minecraft plugin designed to bridge the gap between your Minecraft server and Discord community. It allows players to link their accounts, synchronizing ranks and roles in real-time, and provides rewards for server boosters.<\/p>\n
## \u2728 Features<\/p>\n
– **Account Linking:** Secure 6-digit code verification system to link Minecraft and Discord accounts.
\n– **Role Synchronization:** Automatically syncs LuckPerms ranks with Discord roles.
\n– **Boost Rewards:** Customizable rewards for Discord server boosters with configurable commands and cooldowns.
\n– **Slash Commands:** Native Discord slash commands like `\/profile` to view linked accounts.
\n– **Multilingual Support:** Support for English, Spanish, and Turkish out of the box.
\n– **Webhook Integration:** Log all sync activities to a Discord channel via webhooks.
\n– **Dynamic Placeholders:** Use `%server_name%` and `%server_ip%` in messages and embeds.<\/p>\n
## \ud83d\ude80 Installation<\/p>\n
1. **Dependencies:** Ensure you have LuckPerms installed (highly recommended).
\n2. **Download:** Place the `DiscordSync-1.1.0.jar` into your server’s `plugins` folder.
\n3. **Start:** Start the server to generate the default configuration files.
\n4. **Configure:**
\n – Edit `plugins\/DiscordSync\/config.yml` with your Bot Token and Guild ID.
\n – Map your ranks to Discord roles in `plugins\/DiscordSync\/ranks\/permissions.yml`.
\n5. **Restart:** Restart the server or use `\/discordsync reload` (if available) to apply changes.<\/p>\n
“`yaml
\n# Main configuration for DiscordSync
\n# All user-facing messages have been moved to the ‘messages’ folder.<\/p>\n
language: “es” # Supported: en, es, tr
\nserver-name: “SERVERNAME”
\nserver-ip: “play.example.net”<\/p>\n
cooldowns:
\n sync-seconds: 10
\n profile-seconds: 10<\/p>\n
unsync:
\n confirm-timeout-seconds: 20<\/p>\n
boost-rewards:
\n enabled: false
\n reward-commands:
\n – “give %player% diamond 1”
\n cooldown-days: 30<\/p>\n
discord:
\n # Settings related to the Discord server (guild)
\n guild:
\n guild_id: “YOUR_GUILD_ID”
\n update_nickname: true
\n # Placeholders: %discord_name%, %minecraft_name%
\n nickname_format: “%discord_name% – %minecraft_name%”<\/p>\n
# Settings related to the Discord Bot
\n bot:
\n token: “BOT_TOKEN”
\n channel_id: “VERIFICATION_CHANNEL_ID”
\n webhook-url: “YOUR_WEBHOOK_LOGS_URL”<\/p>\n
# Embed color settings. Colors are in RGB format (0-255).
\n embed-colors:
\n main: { r: 88, g: 101, b: 242 }
\n success: { r: 0, g: 255, b: 0 }
\n fail-invalid: { r: 255, g: 0, b: 0 }
\n fail-expired: { r: 255, g: 100, b: 0 }
\n help: { r: 100, g: 100, b: 255 }<\/p>\n
“`<\/p>\n
# Lenguage English for DiscordSync<\/p>\n
“`yaml
\n# English Language File for DiscordSync<\/p>\n
general:
\n no-permission: “You don’t have permission to use this command.”
\n only-players: “Only players can use this command.”
\n error:
\n title: “Error”
\n description: “An error occurred, please try again: %error_message%”<\/p>\n
discord:
\n already-synced: “Your account is already synced!”
\n not-synced: “Your account is not synced.”
\n unsync-success: “Your account has been unlinked.”
\n unsync-failed: “Could not unlink your account. Please try again.”
\n unsync-confirm: “Type \/unsync confirm within %seconds%s to unlink your account.”
\n unsync-expired: “Confirmation expired. Run \/unsync again to continue.”
\n sync-cooldown: “Please wait %seconds%s before using \/sync again.”
\n sync-code: “Your account sync code is: %code%. Click the ‘Verify’ button in the message and enter the code.”
\n webhook-sync-success: “Minecraft player `%player_name%` has synced their account with Discord user `%discord_tag%`.” # This will be replaced by embed
\n webhook:
\n embed-title: “User Account Linked”
\n embed-description: “A Minecraft player has successfully linked their account.”
\n field-mc-nick: “Minecraft Nick”
\n field-mc-uuid: “UUID”
\n field-discord-user: “Discord User”
\n field-status: “Status”
\n status-verified: “Verified”<\/p>\n
bot:
\n # General bot messages
\n starting: “Discord bot is starting.”
\n login: “Bot logged into the server: %bot_name%”
\n token-required: “Bot token is missing, please enter your bot’s token in the config.yml file.”
\n failed-start: “Bot failed to start: %error_message%”
\n channel-id-required: “Enter your channel ID in the channel_id section of the config.yml file.”
\n embed-sent: “The verification message has been sent to Discord.”<\/p>\n
# Slash commands
\n slash-commands:
\n registering: “Loading slash commands…”
\n registered: “Slash commands have been registered.”<\/p>\n
# Help command
\n help-command:
\n name: “help”
\n description: “Shows the list of available commands.”<\/p>\n
# Profile command
\n profile-command:
\n name: “profile”
\n description: “Shows who is linked to a Minecraft nickname.”
\n option-nick: “nick”
\n option-nick-description: “Minecraft nickname to look up.”
\n cooldown: “Please wait %seconds%s before using this command again.”
\n not-found: “Not user found.”
\n embed-title: “%server_name% – Discord Sync”
\n embed-description: |
\n – Nick Minecraft: %minecraft_name%
\n – Discord ID: %discord_id%
\n – DiscordUsername: %discord_tag%
\n – Rank: %rank%
\n embed-footer: “%server_name% – Discord Sync”<\/p>\n
# Main verification embed text
\n embed-main:
\n title: “%server_name% Account Verification!”
\n description: |
\n Welcome to the **%server_name%** verification!
\n To access all features and sync your roles, please link your account.<\/p>\n
**How does it work?**
\n 1. Join the server: `%server_ip%`
\n 2. Use the command `\/sync` in the chat.
\n 3. You will receive a unique code. Click the ‘Verify’ button below and enter it!<\/p>\n
Thank you for being part of our community!
\n footer: “%server_name% | Verification System”
\n button-verify: “Verify”
\n button-tutorial: “Tutorial”
\n modal-title: “Account Linking”
\n modal-input-label: “Verification Code”
\n modal-input-placeholder: “Example: ABC123”<\/p>\n
# Verification result embeds
\n embed-success:
\n title: “Success!”
\n description: “Your Minecraft account has been successfully linked.”
\n embed-fail-invalid:
\n title: “Linking Error”
\n description: “The code you entered is incorrect or does not exist. Please try again.”
\n embed-fail-expired:
\n title: “Linking Error”
\n description: “Your linking code has expired. Please generate a new one on the Minecraft server.”<\/p>\n
# Help embed
\n embed-help:
\n title: “Help Commands”
\n description: “Here is the list of available commands:”<\/p>\n
sync:
\n # Role sync messages
\n role-given: “The role has been assigned: %msg%”
\n role-failed: “Could not assign the role: %msg%”
\n role-removed: “The role has been removed: %msg%”
\n role-removal-failed: “Could not remove the role: %msg%”<\/p>\n
# Sync messages
\n successful: “Your account has been linked successfully!”
\n error: “Invalid or already used code! Please get a new code in-game.”
\n nickname:
\n not-configured: “Nickname format or guild ID is not configured. Skipping nickname update.”
\n guild-not-found: “Could not find the configured guild with ID: %guild_id%. Skipping nickname update.”
\n success: “Successfully updated nickname for %discord_tag% to ‘%new_name%’.”
\n error:
\n permission: “Failed to update nickname for %discord_tag%. Reason: MISSING PERMISSION – %permission_name%”
\n hierarchy: “Failed to update nickname for %discord_tag%. Reason: HIERARCHY – Cannot modify a user with a higher or equal role.”
\n other: “Failed to update nickname for %discord_tag%. Reason: %error_message%”
\n member-not-retrieved: “Could not retrieve member with ID %discord_id% to update nickname. Reason: %error_message%”<\/p>\n
boost:
\n rewards:
\n granted: “Boost reward delivered. Thanks for boosting!”
\n revoked-mc: “Your boost rewards were removed. Thanks for supporting the server!”
\n revoked-dm: “You stopped boosting the server. Your boost rewards were removed. Thanks for supporting us!”
\n“`<\/p>\n
## \ud83d\udee0 Commands & Permissions<\/p>\n
### In-Game Commands
\n– `\/sync` – Generate a pairing code. (`discordsync.use`)
\n– `\/unsync` – Unlink your Discord account. (`discord.sync.use`)
\n– `\/message-discord-send` – Send\/Refresh the verification embed in Discord. (`discordsync.admin`)<\/p>\n
### Discord Commands ## \ud83d\udcc4 Documentation<\/p>\n For more detailed information on configuration, rank mapping, and troubleshooting, visit our Online Documentation.<\/p>\n —<\/p>\n Developed with \u2764\ufe0f by **Ikari Development** and **Imperior Development** (Advvy & AlexClient)<\/p>\n","protected":false},"excerpt":{"rendered":" Link your account to Discord and configure your plugin.<\/p>\n","protected":false},"featured_media":57462,"template":"","meta":{"_minecraft_slug":"discordsync","_minecraft_project_id":"7Rrf79Ft","_minecraft_author":"alexclient","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":6,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"discordsync.zip","_minecraft_size_bytes":34365316,"_minecraft_version_count":2,"_minecraft_updated_at":"2026-05-16T12:22:46.341811Z","_minecraft_date_created":"2026-05-02T21:52:15.079466Z","_minecraft_date_modified":"2026-04-24T00:12:44.065637Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/discordsync","_minecraft_icon_attachment_id":57462,"_minecraft_imported_at":"2026-06-03T03:58:49+00:00","_minecraft_import_hash":"054141820e2e2502bd39f75857d54cff","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,126,127,867,129,123,92],"mod_loader":[130,132,134],"minecraft_version":[438,446,449,110,111,112,113,114,115,116,117,118,119,120,46,47,48,49,50,51,52,53,54,55,56,57,58,59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-57461","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-management","mod_category-paper","mod_category-social","mod_category-spigot","mod_category-technology","mod_category-utility","mod_loader-bukkit","mod_loader-paper","mod_loader-spigot","minecraft_version-1-13","minecraft_version-1-13-1","minecraft_version-1-13-2","minecraft_version-1-14","minecraft_version-1-14-1","minecraft_version-1-14-2","minecraft_version-1-14-3","minecraft_version-1-14-4","minecraft_version-1-15","minecraft_version-1-15-1","minecraft_version-1-15-2","minecraft_version-1-16","minecraft_version-1-16-1","minecraft_version-1-16-2","minecraft_version-1-16-3","minecraft_version-1-16-4","minecraft_version-1-16-5","minecraft_version-1-17","minecraft_version-1-17-1","minecraft_version-1-18","minecraft_version-1-18-1","minecraft_version-1-18-2","minecraft_version-1-19","minecraft_version-1-19-1","minecraft_version-1-19-2","minecraft_version-1-19-3","minecraft_version-1-19-4","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n– `\/profile
\n– `\/help` – View available bot commands.<\/p>\n