DiscordLinker

Your Discord server and your Minecraft server. One channel. One community.

DiscordLinker turns a Discord channel into your server's second home: every message, death, advancement and join in
Minecraft shows up in Discord — and every message in Discord shows up in Minecraft. One jar, one config file, two
minutes to set up.

:zap: TL;DR

• :arrows_counterclockwise: Full two-way chat bridge — no scripts, no extra processes
• :bust_in_silhouette: Players appear in Discord with their own name and Minecraft skin (webhook)
• :robot: Slash commands: /list, /status, /link
• :link: Account linking — Discord messages show your Minecraft name in-game
• :trophy: Deaths, advancements, joins, leaves and server events relayed automatically
• :hammer: Every relay and message format is configurable, reloadable in-game

🎥 Watch it in action

Demo video coming soon — check the images below while you wait!

📸 Screenshots

• Banner — the DiscordLinker banner
• Minecraft chat in Discord — players with their skins, deaths, advancements,
  member list
• Discord chat in Minecraft — the [Discord] side of the bridge
• Slash commands & account linking — /list, /status, /link

✨ Why DiscordLinker?

| DiscordLinker | Typical chat-link plugins |
|--------------------------------------------|-----------------------------------------|
| Plugin + bot in one jar | Separate bot + plugin to install |
| Webhook avatars — players look like players | Plain bot messages only |
| Account linking built in | Usually missing |
| Slash commands + text commands | Text commands only |
| Live player-count status | Static or no status |
| Auto-creates its webhook | Manual webhook setup |

🚀 Quick Start

1. Create a bot at discord.com/developers/applications → New
   Application → Bot → copy the token
2. ⚠️ Enable MESSAGE CONTENT INTENT in the Bot settings — the bot cannot read chat without it
3. Invite the bot with Send Messages + Manage Webhooks permissions
4. Copy your channel ID (Discord Settings → Advanced → Developer Mode → right-click channel → Copy Channel ID)
5. Drop DiscordLinker.jar into plugins/, start the server, then edit plugins/DiscordLinker/config.yaml:

discord:
  token: "YOUR_DISCORD_BOT_TOKEN"
  channel-id: "YOUR_DISCORD_CHANNEL_ID"

6. /discordlinker reload — done. ✅

🎮 Commands

In-game

| Command | What it does |
|------------------------------|-------------------------------------------|
| /discordlinker status | Show the bot's connection status |
| /discordlinker reload | Apply config changes without restart |
| /discordlinker say <msg> | Send a message to Discord from the server |
| /link <code> | Complete your Discord account link |

In Discord

| Command | What it does |
|------------|---------------------------------------------|
| /list | Who's online right now |
| /status | Which channel is linked |
| /link | Get a code, then run /link <code> in-game |
| !list | Text version of /list |
| !help | Show available commands |

🔗 Account linking

Run /link in Discord, run /link <code> in Minecraft — your Discord messages now show your Minecraft name
in-game. Permanent, stored in linked-users.yml.

⚙️ Config overview

Everything in plugins/DiscordLinker/config.yaml, with sensible defaults — most servers never change anything
beyond the token and channel ID. Highlights:

| Setting | Default | What it does |
|----------------------------------|-------------------------------------------|------------------------------|
| discord.token | — | Your bot token |
| discord.channel-id | — | The channel to link |
| discord.status | with {players}/{max} players | Bot activity text |
| settings.use-webhook | true | Player name + skin in Discord|
| settings.status-update-interval| 60 | Live player count, 0 = off |
| settings.relay-* | true (chat, join/leave, deaths, adv.) | Toggle each relay |
| messages.* | pre-formatted | Every message is editable |

Placeholders: {player}, {message}, {user}, {advancement}. Color codes (&7, &b) work in-game,
Discord markdown works in Discord.

🛟 Support

• 🐛 Found a bug or want a feature? Open an issue on GitHub
• 💬 Questions? Join the Discord server
• 📖 Full documentation and examples: see this page's config section and the bundled config.yaml

📦 Changelog

v1.1.0 — Webhook avatars, slash commands, account linking, live player-count status, /discordlinker say,
translated advancement names, mention support
v1.0.0 — First release: two-way chat bridge, join/leave/death/advancement relays, !list

🛠️ Build from source

JDK 21+ and the included Gradle wrapper:

./gradlew build   →   build/libs/DiscordLinker.jar

📄 License

MIT — free to use, modify and share, just keep the license notice.