Imperior Development

DiscordSync

Link Minecraft accounts with Discord and keep roles synced in real time. This wiki documents installation, configuration, commands, permissions, and troubleshooting.

LuckPerms Integration Verification Code Flow Discord Role Sync Webhook Logs
Discord
Built for fast, reliable Minecraft to Discord verification.

Installation

  1. Install LuckPerms on your server (recommended for role syncing).
  2. Drop the DiscordSync jar into the plugins folder.
  3. Start the server once to generate files, then stop it.
  4. Fill out plugins/DiscordSync/config.yml.
  5. Map ranks in plugins/DiscordSync/ranks/permissions.yml.
The verification message can be re-sent using /message-discord-send.

Configuration

Core settings live in config.yml:

language: "en"

discord:
  guild:
    guild_id: "YOUR_GUILD_ID"
    update_nickname: true
    nickname_format: "%discord_name% - %minecraft_name%"
  bot:
    token: "BOT_TOKEN"
    channel_id: "VERIFICATION_CHANNEL_ID"
    webhook-url: "YOUR_WEBHOOK_LOGS_URL"

Ranks

Ranks mapping lives in ranks/permissions.yml:

permissions:
  vip:
    lp_rank: "vip"
    role_id: "ROLE_ID_DISCORD"
  vip+:
    lp_rank: "vip+"
    role_id: "ROLE_ID_DISCORD"

Permissions

  • discordsync.admin - allows /message-discord-send.
  • discordsync.use - allows /sync.
  • discord.sync.use - allows /unsync.

Commands

  • /sync - generates a 6-digit code for Discord verification.
  • /message-discord-send - posts or refreshes the verification embed.
  • /unsync - unlinks your Minecraft account.
  • /profile nick - shows the Discord user linked to a Minecraft nickname.

Features

  • Boost rewards with customizable commands and cooldowns.
  • Verification embed supports server banner preview.
  • Server name and IP placeholders for all messages and embeds.
  • /unsync confirmation and configurable cooldowns for /sync and /profile.
  • Ranks converter tool to generate permissions.yml.

Troubleshooting

  • Check that the bot has permission to manage roles and nicknames.
  • Verify the Discord role ID exists in the same guild.
  • Ensure the LuckPerms primary group matches lp_rank.
  • Use /message-discord-send after changing embeds.