Skip to content

MC-Linker/Discord-Linker

Repository files navigation

Discord-Linker

SpigotMC Modrinth CurseForge Hangar Discord

The server-side plugin/mod for MC Linker — the easiest way to connect your Minecraft server with Discord. No custom bot creation or configuration files needed!

Features

  • Chat Bridge — Relay messages bidirectionally between Minecraft and Discord
  • Player Stats — View player statistics, advancements, and inventories from Discord
  • Command Execution — Run Minecraft commands directly from Discord with tab completions
  • Server Moderation — Ban, kick, and manage players from Discord
  • Account Linking — Connect Discord accounts with Minecraft players
  • Status Channels — Display live online player counts in Discord
  • Synced Roles — Sync Discord roles with Minecraft teams or LuckPerms groups
  • Console Forwarding — Forward your server console output to a Discord channel

Supported Platforms

Platform Versions
Spigot 1.8+
Fabric 1.16.5+
Forge 1.16.5 – 1.20.x
NeoForge 1.21.1+
Hybrid (MohistMC, Magma, Arclight) Supported

Setup

  1. Invite the MC Linker Discord bot from the App Directory or from Top.gg
  2. Download the plugin from Modrinth, CurseForge, Hangar, or Aternos
  3. Install it on your Minecraft server and restart
  4. Run /connect plugin in Discord and follow the instructions
  5. Optionally run /chatchannel add #channel in Discord to set up the chat bridge

In-Game Commands

Command Description
/linker reload Reload configuration and reconnect
/linker connect <code> Connect server to Discord bot
/linker disconnect Disconnect server from Discord
/linker bot_port [port] Get or set the bot port (for custom-bot connections)
/linker debug Toggle debug mode
/verify <code> Verify your Minecraft account with Discord
/discord Get the Discord server invite link
/dm <user> <message> Send a Discord DM to a user (accepts Discord username/id or, if linked, MC username/uuid)

Plugin Integrations (Hooks)

Discord-Linker supports optional integrations with popular permission plugins to power the Synced Roles feature:

Hook Platform Description
LuckPerms All platforms Sync Discord roles with LuckPerms groups. Supports live group change events.
Vault Spigot only Sync Discord roles with any Vault-compatible permission plugin's groups.

If both LuckPerms and Vault are present, LuckPerms takes priority. Vanilla Minecraft teams are used as a fallback when neither hook is available.

Discord Bot Commands

Run /help in Discord for a full list of commands, or check the MC Linker Guide for more details.

Links

License

CC BY-NC 4.0 — Attribution-NonCommercial 4.0 International