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"

1. /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.