# SyncCord
\n ### The Modern Minecraft-Discord Integration Plugin<\/p>\n
<\/p>\n
**SyncCord** is a high-performance, deeply customizable plugin that builds a bridge between your Minecraft server and your Discord community. It seamlessly connects the two platforms in real-time, from chat messages to administrative commands.<\/p>\n
\n 
\n <\/p>\n
—<\/p>\n
## Key Features<\/p>\n
* \ud83d\udd17 **Two-Way Chat Relay:** Minecraft chat messages instantly appear in a dedicated Discord channel, and vice-versa. The plugin handles formatting, colors, and ping prevention. ---<\/p>\n ## Installation and Setup<\/p>\n ### Step 1: Create a Discord Bot<\/p>\n 1. Go to the Discord Developer Portal and create a **New Application**. ### Step 2: Configure the Plugin<\/p>\n 1. Place the `SyncCord.jar` file into your server's `plugins` folder. Channels: RoleSync: ConsoleRelay: ---<\/p>\n ## Commands<\/p>\n ### Minecraft Commands<\/p>\n * `\/discord link` - Generates a one-time code to link your account. ### Discord Commands<\/p>\n *The commands use the `prefix` set in `config.yml` (default: `?`).*<\/p>\n * `?dclink ---<\/p>\n ## Permissions<\/p>\n * `synccord.reload` - Allows the use of the `\/synccord reload` command.<\/p>\n ## Dependencies<\/p>\n * **LuckPerms:** Required for role synchronization. The plugin will run without it, but rank-related features will be disabled.<\/p>\n","protected":false},"excerpt":{"rendered":" DiscordSRV 2.0 – A Hungarian made simple but hopefully better DiscordSRV<\/p>\n","protected":false},"featured_media":56287,"template":"","meta":{"_minecraft_slug":"dev-synccord","_minecraft_project_id":"QqFFgjjd","_minecraft_author":"ywxlol","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":141,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"dev-synccord.zip","_minecraft_size_bytes":19944053,"_minecraft_version_count":2,"_minecraft_updated_at":"2026-05-15T18:45:25.810918Z","_minecraft_date_created":"2025-10-29T07:44:48.538651Z","_minecraft_date_modified":"2025-10-29T16:47:43.329352Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/dev-synccord","_minecraft_icon_attachment_id":56287,"_minecraft_imported_at":"2026-06-03T02:43:31+00:00","_minecraft_import_hash":"0a4c1c0c9a09fed41746da9dade9d139","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[87,127,867,129,123,92],"mod_loader":[132,134],"minecraft_version":[52,53,54,55,56,57,58,59,36,60,93,94,101,102,62,37,40,73,74,38,78,79,80,81,82],"class_list":["post-56286","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-adventure","mod_category-paper","mod_category-social","mod_category-spigot","mod_category-technology","mod_category-utility","mod_loader-paper","mod_loader-spigot","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-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 * \u2699\ufe0f **Advanced Command Relay:** Execute server commands directly from Discord! Using the `?` prefix, you can issue any console command if you have the required Discord role.
\n * \ud83d\udd10 **Secure Account Linking:** A simple, code-based system (`\/discord link` -> `?dclink `) allows players to securely link their Minecraft and Discord accounts.
\n * \ud83d\udc51 **Automatic Role Synchronization:** The plugin uses the **LuckPerms** API to automatically synchronize player ranks. Upon account linking and rank changes, the corresponding Discord role is assigned automatically.
\n * \ud83d\udce2 **Event Notifications:** Important server events (server start\/stop, player join\/leave) are displayed as formatted, embedded messages in Discord.
\n * \ud83d\udda5\ufe0f **Console Relay:** Server console log messages (INFO, WARN, ERROR) can be forwarded to a separate Discord channel, aiding in server administration.
\n * \ud83d\udee0\ufe0f **Extreme Customization:** In the `config.yml` file, nearly every message, format, color, and operational parameter can be customized, from the appearance of the Minecraft-Discord chat to the messages posted after moderation commands.
\n * \ud83d\udd04 **Reload Command:** The plugin can be reloaded without a server restart using the `\/synccord reload` command.<\/p>\n
\n 2. In the **Bot** menu, click the **Add Bot** button.
\n 3. Under the bot's settings, enable the following **Privileged Gateway Intents**:
\n * **SERVER MEMBERS INTENT**
\n * **MESSAGE CONTENT INTENT**
\n 4. Click the **Reset Token** button, then copy the token that appears. **Treat this token like a password and never share it with anyone!**
\n 5. In the **OAuth2 -> URL Generator** menu, select the `bot` and `applications.commands` scopes.
\n 6. In the **Bot Permissions** section, grant the necessary permissions (minimum: `Send Messages`, `Read Message History`, `Manage Roles`, `Embed Links`).
\n 7. Copy the generated URL and use it to invite the bot to your Discord server.<\/p>\n
\n 2. Start the server to generate the `plugins\/SyncCord\/config.yml` file.
\n 3. Stop the server.
\n 4. Open the `config.yml` file and fill in the required fields:
\n ```yaml
\n # The token you copied from the Discord Developer Portal
\n BotToken: \"PASTE_YOUR_BOT_TOKEN_HERE\"<\/p>\n
\n # Where chat and events will appear
\n chat: \"DISCORD_CHAT_CHANNEL_ID\"
\n # Where console logs and commands are handled
\n console: \"DISCORD_CONSOLE_CHANNEL_ID\"<\/p>\n
\n enabled: true
\n roles:
\n # Minecraft Group Name: \"Discord Role ID\"
\n default: \"123456789012345678\"
\n admin: \"098765432109876543\"<\/p>\n
\n commands:
\n enabled: true
\n allowedRoles:
\n # Discord roles that can use commands
\n - \"SERVER_ADMIN_ROLE_ID\"
\n ```
\n 5. Start the server again. If everything is configured correctly, your bot will be online and the plugin will be operational!<\/p>\n
\n * `\/discord unlink` - Unlinks your Minecraft and Discord accounts.
\n * `\/synccord reload` - Reloads the plugin's configuration files.<\/p>\n` - Links your account using the code received in Minecraft.
\n * `?dcunlink` - Unlinks your account.
\n * `?