DyDiscord — Minecraft and Discord Made Simple

Link your accounts. Share your chat. Connect your community.

DyDiscord is a Minecraft–Discord integration plugin for survival, SMP and community servers. Connect player accounts, bring conversations together and follow your server through your own Discord bot.

DyDiscord combines private account linking, two-way chat, Minecraft-to-Discord roles, configurable rewards and giveaways in one plugin. Version 1.1.0 adds a live server status card, DyClaim and DyRTP event logs, PlaceholderAPI placeholders, German, Spanish and Russian, MiniMessage formatting and a developer API, while preserving existing account links, custom settings and translations.

New in 1.1.0

Server status card. One Discord message shows Online or Offline, players, version and TPS (on Paper and its forks). DyDiscord edits the same message on a timer and marks it Offline on a normal shutdown. Turn it on with status-card in bot.yml.

Logs from DyClaim and DyRTP. Claims created and removed, trust changes, ownership transfers and random teleports are posted to a channel you choose. Each kind has its own switch under plugin-logs; a blank channel turns them off.

PlaceholderAPI. %dydiscord_linked%, %dydiscord_discord_name% and %dydiscord_bot_connected% for scoreboards, tab lists and chat formats.

More languages. German, Spanish and Russian join English and Turkish for Minecraft and Discord messages. lang: auto follows the Minecraft client language.

MiniMessage. On Paper and Purpur, Minecraft messages may use tags such as <green> or <gradient:#55ff55:#55ffff> next to & codes. Names and chat from players are never read as tags. Spigot keeps & codes.

Modern cards. Every bot message except relayed chat uses Discord's container layout with a coloured accent.

For developers. DyDiscordAPI looks up linked accounts, and AccountLinkEvent and AccountUnlinkEvent report changes.

Version 1.0.2 added the /dyd and /dyda shortcuts, safer defaults, container giveaways and clearer setup errors.

Choose your server build

Package	JAR	First startup
Small	`DyDiscord-1.1.0.jar`	Internet access to resolve required libraries
Standalone	`DyDiscord-1.1.0-standalone.jar`	Libraries included; available on GitHub

Install one JAR per server. Both packages provide the same features for Bukkit, Spigot, Paper and Purpur, with Minecraft 1.20.x–26.x as the current compatibility range. Stop the server and back up the full DyDiscord folder before replacing the JAR. Existing accounts do not need to be linked again.

Java 17 bytecode; use the runtime required by your server. Folia and proxy platforms are outside the current support claim. Optional integrations must support your selected server too. Compatibility notes · Upgrade guide · Downloads

Why DyDiscord?

Your bot, your community. Use your own Discord application and keep account linking, chat and console output in separate channels. The bot runs inside Minecraft; no separate bot process or external database is required.

Private account management. Players link through a private Discord form and view their account details privately. Unlinking requires confirmation. The account panel and private slash commands share the same account system.

Choose what you use. Enable either chat direction, event messages, role synchronization, rewards or console access as needed. You can turn off the panel and keep command-based account access.

Five languages. English, Turkish, German, Spanish and Russian messages are included. Commands use English words, and Turkish also accepts its own command words and ASCII spellings. Help and TAB follow the effective language and permissions. Explicit game/player language choices are respected; otherwise game messages follow the client or bot language.

Link accounts, your way

Players run /dydiscord link, then enter their temporary, single-use code through Discord /link or the account panel. The panel keeps Link Account → Unlink → My Account in one card, using your server icon or a custom image.

Each Minecraft account links to one Discord account. Linking never grants Minecraft permissions or OP. Account records remain in local SQLite storage across restarts and supported upgrades.

Share the conversation

Forward public Minecraft chat to Discord, Discord chat to Minecraft, or both. Message formats and optional join, leave and death embeds are configurable; player messages are not translated.

Minecraft ranks can come from LuckPerms, with Vault Chat as a display fallback. Discord messages use the member's server display name and highest eligible role, including its primary color. Players can use /dydiscord chat on|off to show or hide incoming Discord chat for themselves.

Forwarded messages do not create Discord mention notifications. Bot/webhook messages, edits and attachments are not relayed. Unknown Minecraft chat listeners pause outbound forwarding to protect private or moderated conversations; those systems need a supported integration.

Keep Discord roles in step

Give linked members configured Discord roles without requiring LuckPerms. With LuckPerms, map real direct, inherited and temporary Minecraft group memberships to Discord role IDs. Temporary ranks are checked while players are offline, and unlinking or changed rules retain the information needed to clean up old managed roles.

Synchronization runs Minecraft → Discord only. Only configured roles are managed; unrelated roles stay untouched. The bot needs Manage Roles and sufficient role hierarchy. Privileged, integration-managed and console-access roles are blocked from automatic distribution.

Reward participation

Optional first-link and boost rewards run your installed providers' console commands. Use your existing rank, economy or website system to provide temporary ranks, currency, items or site credit. DyDiscord does not bundle those providers, and command dispatch does not prove an external reward was delivered.

Create persistent button giveaways with optional linked-account or role requirements. DyDiscord records entries and draws winners; the owner delivers the prizes. Discord server information, player lists, configured addresses and useful links help members find what they need.

Follow your server from Discord

Relay actual server output to a separate console channel. Optionally authorize trusted Discord roles to run Minecraft console commands. Log forwarding and command execution have separate switches. Public console channels are allowed, so anyone with channel access can read the output.

The relay shows real server output without extra technical acceptance/rejection replies. Normal shutdown attempts a short yellow notification before disconnecting; bot restarts and reloads do not send it. Delivery cannot be guaranteed during crashes or network failures.

A separate status card keeps one message up to date with the server state, and an optional log channel follows DyClaim and DyRTP activity.

Familiar commands

Command	Purpose
`/discord`	Show the Discord invitation
`/dydiscord link`	Get your private linking code
`/dydiscord status`	View your linked account
`/dydiscord unlink`	Start unlink confirmation
`/dydiscord chat on` or `off`	Show or hide incoming Discord chat
`/dyda help [page]`	Browse permitted administrator commands
`/dyda doctor`	Check setup, intents and permissions
`/dyda reload`	Apply valid settings and translations

Turkish examples include /dydiscord eşle, /dydiscord kaldır, /dydiscord sohbet aç, /dyda yardım and /dyda kontrol. The long /dydiscord admin path remains available.

Get started

Install one of the packages and start your server to generate the files.
Create your own Discord bot, invite it and configure token and guild-id in plugins/DyDiscord/bot.yml.
Reload valid settings, choose the channels you need and run /dyda doctor.
Enable the required Discord intents for the features you use. Message commands, console input and incoming Discord chat need Message Content Intent; member-event features need Server Members Intent.

Settings and messages include short English comments. Anonymous bStats statistics can be turned off with metrics.enabled: false. Back up the complete data folder before upgrades; restoring local data does not undo Discord role changes or reward commands already executed.

Source and support

Documentation · Türkçe rehber · Report an issue · Discord support · License

By Claww / DyPlugin.

DyDiscord