THIS IS A DEDICATED SERVER SIDE MOD! YOU WILL NEED A PROPER SERVER TO USE IT! THIS MOD WILL NOT WORK IN SINGLE PLAYER, OR LAN MODE!!!!


Simple Discord Link is a Minecraft mod that allows you to bridge the gap between your Minecraft and Discord server. With features like Chat Relay, Whitelisting, Linked commands and more, it's a must-have for anyone running a modded server.

Some features include:
- Minecraft to Discord and Discord to Minecraft Chat Relay
- Server Console to Discord Relay
- Executing Minecraft Commands from Discord
- Access Control. Similar to Whitelisting
- A Quick Server Status Overview
- View active players on the server
- Format chat between Minecraft and Discord
- And many more features!

You are allowed to include this mod in your modpack, BUT, all downloads have to go through our offical Modrinth and Curseforge pages. You are not allowed to re-upload the mod to any other sites.
You are free to clone the code and distribute the mod as your own, but I ask that you please change the name, and you are not allowed to use any of our official docs/resources, as those are licensed under ARR.
The artwork contained on this page is licensed under All Rights Reserved (by HypherionSA) and may not be re-used anywhere else, aside from our official Curse/Modrinth/Documentation pages. This license excludes the BisectHosting logo, which is licensed under their respective licenses
How to Install Simple Discord Link (Mod)
Simple Discord Link by hypherionsa is verified for Fabric, Forge, Neoforge, Quilt across Minecraft versions 1.16.5, 1.18.1, 1.18.2, 1.19, 1.19.1, 1.19.2, 1.19.3, 1.19.4 (latest release: 3.4.5, file size: 9.6 MB). Follow the steps below to install it safely from ModCraft.tv:
- Click the Download button above and select your Minecraft version (1.16.5, 1.18.1, 1.18.2, 1.19, 1.19.1, 1.19.2, 1.19.3, 1.19.4) and platform (Fabric, Forge, Neoforge, Quilt).
- Make sure you have the compatible loader or environment installed for Fabric, Forge, Neoforge, Quilt.
- Move the downloaded Simple Discord Link file into your Minecraft
.minecraft/modsfolder and launch the game.
All Versions
+ Add Version| Name | Game version | Platforms | Published | Downloads | Actions |
|---|---|---|---|---|---|
| 1mo ago | 1 | ||||
| 4mo ago | 1 | ||||
| 4mo ago | 1 | ||||
| 5mo ago | 1 | ||||
| 6mo ago | 1 | ||||
| 7mo ago | 1 | ||||
| 11mo ago | 1 | ||||
| last yr. | 1 | ||||
| last yr. | 1 | ||||
| last yr. | 1 | ||||
| last yr. | 1 | ||||
| last yr. | 1 | ||||
| last yr. | 1 | ||||
| last yr. | 1 | ||||
| last yr. | 1 | ||||
| last yr. | 1 | ||||
| last yr. | 1 | ||||
| last yr. | 1 | ||||
| last yr. | 1 | ||||
| last yr. | 1 | ||||
| last yr. | 1 | ||||
| last yr. | 1 | ||||
| last yr. | 1 | ||||
| last yr. | 1 | ||||
| last yr. | 1 | ||||
| last yr. | 1 | ||||
| last yr. | 1 | ||||
| last yr. | 1 | ||||
| last yr. | 1 | ||||
| last yr. | 1 | ||||
| last yr. | 1 | ||||
| last yr. | 1 | ||||
| last yr. | 1 | ||||
| last yr. | 1 | ||||
| last yr. | 1 | ||||
| last yr. | 1 | ||||
| last yr. | 1 | ||||
| last yr. | 1 | ||||
| last yr. | 1 | ||||
| last yr. | 1 | ||||
| last yr. | 1 | ||||
| last yr. | 1 | ||||
| last yr. | 1 | ||||
| last yr. | 1 | ||||
| last yr. | 1 | ||||
| last yr. | 1 | ||||
| last yr. | 1 | ||||
| last yr. | 1 | ||||
| last yr. | 1 | ||||
| last yr. | 1 | ||||
| last yr. | 1 | ||||
| last yr. | 1 | ||||
| last yr. | 1 | ||||
| last yr. | 1 | ||||
| last yr. | 1 | ||||
| last yr. | 1 | ||||
| last yr. | 1 | ||||
| last yr. | 1 | ||||
| last yr. | 1 | ||||
| last yr. | 1 | ||||
| last yr. | 1 | ||||
| last yr. | 1 | ||||
| last yr. | 1 | ||||
| last yr. | 1 | ||||
| last yr. | 1 | ||||
| last yr. | 1 | ||||
| last yr. | 1 | ||||
| last yr. | 1 | ||||
| last yr. | 1 | ||||
| last yr. | 1 | ||||
| last yr. | 1 | ||||
| last yr. | 1 | ||||
| last yr. | 1 | ||||
| last yr. | 1 | ||||
| last yr. | 1 | ||||
| last yr. | 1 | ||||
| last yr. | 1 | ||||
| last yr. | 1 | ||||
| last yr. | 1 | ||||
| last yr. | 1 | ||||
| last yr. | 1 | ||||
| last yr. | 1 | ||||
| last yr. | 1 | ||||
| last yr. | 1 | ||||
| last yr. | 1 | ||||
| last yr. | 1 | ||||
| last yr. | 1 | ||||
| last yr. | 1 | ||||
| last yr. | 1 | ||||
| last yr. | 1 | ||||
| last yr. | 1 | ||||
| last yr. | 1 | ||||
| last yr. | 1 | ||||
| last yr. | 1 | ||||
| last yr. | 1 | ||||
| last yr. | 1 | ||||
| last yr. | 1 | ||||
| last yr. | 1 | ||||
| last yr. | 1 | ||||
| last yr. | 1 | ||||
| last yr. | 1 | ||||
| last yr. | 1 | ||||
| last yr. | 1 |
- REQUIRES [CraterLib](https://www.curseforge.com/minecraft/mc-mods/craterlib) - [Modrinth](https://modrinth.com/mod/craterlib)
- [Online Config Editor](https://editor.firstdark.dev)
- [Documentation](https://sdlink.fdd-docs.com)
- This single jar works on 1.18.2-26.2
- Requires CraterLib 3.1.3 or newer*
### If you find a bug please report it. If nobody reports issues, they can't be fixed
- Changes**:
- Added official config toggle to ignore canceled chat events (fixes compat with mods like FTB Teams, etc). Requires CraterLib update - HypherionSA
- Add config toggle to relay commands used by hidden players. Disabled by default - HypherionSA
- Bug Fixes**:
- FTB Ranks that do not include conditionally assigned ranks in rank sync - John Clardy
- Topic updates should update thread channel parent topic - HypherionSA
- REQUIRES [CraterLib](https://www.curseforge.com/minecraft/mc-mods/craterlib) - [Modrinth](https://modrinth.com/mod/craterlib)
- [Online Config Editor](https://editor.firstdark.dev)
- [Documentation](https://sdlink.fdd-docs.com)
- This single jar works on 1.18.2-26.2
- Requires CraterLib 3.1.2 or newer*
### If you find a bug please report it. If nobody reports issues, they can't be fixed
- Bug Fixes**:
- Fixed %player_avatar% embed placeholder always using linked discord avatars instead of the minecraft avatars
- REQUIRES [CraterLib](https://www.curseforge.com/minecraft/mc-mods/craterlib) - [Modrinth](https://modrinth.com/mod/craterlib)
- [Online Config Editor](https://editor.firstdark.dev)
- [Documentation](https://sdlink.fdd-docs.com)
- This single jar works on 1.18.2-26.2
- Requires CraterLib 3.1.2 or newer*
### If you find a bug please report it. If nobody reports issues, they can't be fixed
- Bug Fixes**:
- Fixed LuckPerms/FTB sync throwing NPE and not assigning roles
- Fixed Command Relays always using the server as author
- Fixed Stopping/Stopped/Console Relay causing rare errors during bot shutdown
- Fixed Starting/Started/Stopping/Stopped messages not sending when they should when using webhooks
- REQUIRES [CraterLib](https://www.curseforge.com/minecraft/mc-mods/craterlib) - [Modrinth](https://modrinth.com/mod/craterlib)
- [Online Config Editor](https://editor.firstdark.dev)
- [Documentation](https://sdlink.fdd-docs.com)
- This single jar works on 1.18.2-26.1.2
- Requires CraterLib 3.1.2 or newer*
- Changes**:
- Added config flag to disable filtering IPs in console relay
- Adapt for CraterLib Adventure Revert
- Bug Fixes**:
- Fixed accounts being unverified not triggering role removal events
- Fixed unverify command not unverifying all accounts associated with the user
- REQUIRES [CraterLib](https://www.curseforge.com/minecraft/mc-mods/craterlib) - [Modrinth](https://modrinth.com/mod/craterlib)
- [Online Config Editor](https://editor.firstdark.dev)
- [Documentation](https://sdlink.fdd-docs.com)
- This single jar works on 1.18.2-26.1.2
- Requires CraterLib 3.1.1 or newer*
- Bug Fixes**:
- Fixed the error message that shows up when allowMentionsInChat is enabled
- Fixed Custom emotes being sent in minecraft not rendering correctly in discord
- Changes**:
- Added automatic config migration handling between V4 experimental and V3
- REQUIRES [CraterLib](https://www.curseforge.com/minecraft/mc-mods/craterlib) - [Modrinth](https://modrinth.com/mod/craterlib)
- [Online Config Editor](https://editor.firstdark.dev)
- [Documentation](https://sdlink.fdd-docs.com)
- This single jar works on 1.18.2-26.1
- Requires CraterLib 3.1.0 or newer*
- New Features**:
- Added
useLinkedAvatarto allow using either discord avatars or minecraft skins when using linkedNames - stackpan
- Bug Fixes**:
- Fix for Slash Commands in fr_fr lang - flyzar73
- Fixed Linked Commands not working on 1.21.11+ - HypherionSA
- Fixed chat messages and events not being relayed when vanish is installed on 1.20.1 - HypherionSA
- Strip out
§ksymbol from messages - #210 - HypherionSA
- REQUIRES [CraterLib](https://www.curseforge.com/minecraft/mc-mods/craterlib) - [Modrinth](https://modrinth.com/mod/craterlib)
- [Online Config Editor](https://editor.firstdark.dev)
- [Documentation](https://sdlink.fdd-docs.com)
- This single jar works on 1.18.2-1.21.10
- Requires CraterLib 3.0.0 or newer*
- New Features**:
- Added support for PlayerRoles Syncing (https://modrinth.com/mod/player-roles) - HypherionSA
- Added support for CobblemonGuilds - HypherionSA
- Allow disabling verification via DMs - HypherionSA
- Bug Fixes**:
- LuckPerms integration will now correctly remove ranks from players - #202 - u32
- Fixed %player_avatar% placeholder returning incorrect avatar with LinkedNames enabled in embeds - HypherionSA - #199
- REQUIRES [CraterLib](https://www.curseforge.com/minecraft/mc-mods/craterlib) - [Modrinth](https://modrinth.com/mod/craterlib)
- [Online Config Editor](https://editor.firstdark.dev)
- [Documentation](https://sdlink.fdd-docs.com)
- This single jar works on 1.18.2-1.21.8
- Requires CraterLib 2.1.5 or newer*
- New Features**:
- French Translations - DylanDelobel
- Added notice for modpacks potentially (unintentionally) blocking discord messages with Utilitarian Mod - HypherionSA
- Added compatibility with the PluralKit Discord bot with two new config options (
pluralKitCompatandpluralKitCompatMessageDelay) - mg95 - Traditional Chinese Translations - JamesHAc
- Changes**:
- Linked Commands will no longer send "command not allowed" output in invalid channels when allowedChannels are configured - [#187](https://github.com/hypherionmc/sdlink/issues/187) - HypherionSA
- REQUIRES [CraterLib](https://www.curseforge.com/minecraft/mc-mods/craterlib) - [Modrinth](https://modrinth.com/mod/craterlib)
- [Online Config Editor](https://editor.firstdark.dev)
- [Documentation](https://sdlink.fdd-docs.com)
- This single jar works on 1.18.2-1.21.8
- Requires CraterLib 2.1.5 or newer*
- Bug Fixes**:
- Add Missing Player Data to Server Embeds (Embeds that are usually sent as the server) - hypherionsa
- Fix mcPrefix with old mc formatting (Player names) in Minecraft Chat not showing - hypherionsa
- Fix Events Channel messages going to chat channel, even when event channel is defined - hypherionsa
- Fix Linked Names in chat formatting showing up as Unknown - hypherionsa
- Fix Username filters not applying - hypherionsa
- Fix Console relay causing an error on server shutdown - hypherionsa
- Fix profile data persisting on Server messages - hypherionsa
- Fix Linked Names feature using incorrect UUID for players - hypherionsa
- Fix CustomEmotes not loading and CustomEmotes not being usable when mentions are disabled - hypherionsa
- New Features**:
- Add config option to use the server author for Chat Webhook messages (because it was requested) - hypherionsa
- Add new
CONSOLEtarget option for filter entries - ArkoSammy12 - Add %mcname% placeholder for other message types going to discord - hypherionsa
- REQUIRES [CraterLib](https://www.curseforge.com/minecraft/mc-mods/craterlib) - [Modrinth](https://modrinth.com/mod/craterlib)
- [Online Config Editor](https://editor.firstdark.dev)
- [Documentation](https://sdlink.fdd-docs.com)
- This single jar works on 1.18.2-1.21.7
- Requires CraterLib 2.1.5 or newer*
- Bug Fixes**:
- Fix Translation system being able to grab the wrong default files from resources - hypherionsa
- Possible bug fix for shutdown hang when an error occurs on shutdown - hypherionsa
- Added temporary code to forcefully regenerate language files that are invalid, due to file loading bug - hypherionsa
- Fixed channel IDs being set to "" causing a startup failure - hypherionsa
- Fix config migrator crash when migrating configs older than version 21 (3.2.0 and older) - hypherionsa
- Fix LinkedNames breaking in chat messages, when there is an unlinked account in the database - hypherionsa
- Fix Player Counts not excluding vanished players - hypherionsa
- Fix ignoreConsole flag on message filtering being reversed - hypherionsa
- New Features**:
- Add config toggle, to silence invalid/disallowed command feedback messages for linked commands - hypherionsa
- Add
%role_color%placeholder for embeds, to use the user color of linked accounts - hypherionsa - Integration with Advanced Chat, to prevent private chats from being relayed to discord - hypherionsa
- Added better replied to message indications in game - hypherionsa
- Add support for FTB Teams
chatcommand - hypherionsa - Allow mentioning users, channels and roles from chat without client side install - hypherionsa
- Config Editor command now sends link to user that executed the command - hypherionsa
- Implement basic support for custom emotes sent in Minecraft Chat - hypherionsa
- Portuguese Translations by Lucasmiel0406
- Changes**:
- Swap to own Avatar service, due to ongoing issues with 3rd party services - hypherionsa
- REQUIRES [CraterLib](https://www.curseforge.com/minecraft/mc-mods/craterlib) - [Modrinth](https://modrinth.com/mod/craterlib)
- [Online Config Editor](https://editor.firstdark.dev)
- [Documentation](https://sdlink.fdd-docs.com)
- This single jar works on 1.18.2-1.21.5
- Requires CraterLib 2.1.4 or newer*
### Warning: This is a config breaking update. As always, your old config file will be backed up. If you need to revert, simply rename
simple-discord-link.old to simple-discord-link.toml- Bug Fixes**:
- Fix /discordverify command permissions, so that it's usable by everyone - hypherionsa
- Fix Database engine failing to read database files that end with 2 empty lines - hypherionsa
- Don't relay raw Config Editor URLs to Console Relay - hypherionsa
- Fix
%player_name%placeholder not being usable in Chat Embeds - hypherionsa - Fix certain methods of bypassing the mention filter - unsigned-32-bit-integer - [#PR 151](https://github.com/hypherionmc/sdlink/pull/151)
- Webhook names containing
_being formatted as\_- hypherionsa - [#152](https://github.com/hypherionmc/sdlink/issues/152) - Fixed events that happen on login (like rank sync) not running when Join messages are disabled, or the user is vanished - hypherionsa
- Replaced Embed Parser with GSON to prevent escaped character errors caused by JACKSON..... You still suck - hypherionsa
- Fixed messages containing
"not being relayed to Discord when using Embeds - hypherionsa
- New Features**:
- Added Vanish Config flag to disable fake join/leave messages - hypherionsa
- Allow Regex matching for Message filtering - hypherionsa
- Allow message filtering to be used on Usernames as well - hypherionsa
- Access Control/Optional Verification can now give multiple
verifiedRoles - hypherionsa - Allow advancements and death messages to respect game rules - hypherionsa
- Hard coded english messages and responses can now be translated into different languages (TRANSLATORS WANTED) - hypherionsa
- Added flag to disable message filter on console messages - hypherionsa
- Allow Message Filtering system to be used on Discord -> MC messages and usernames too - hypherionsa
- Added Spanish Translations - ArkoSammy12
- Changes**:
- Renamed Advancements config field from
achievementstoadvancements- hypherionsa - Renamed
ignoredMessagestofiltering- hypherionsa
- Experimental Features**:
- Added new Experimental Feature System - hypherionsa
- Added SDLink Relay System. Allowing multiple bots to relay their chats, and other things to multiple servers. Only available as an experimental flag for now - hypherionsa
- REQUIRES [CraterLib](https://www.curseforge.com/minecraft/mc-mods/craterlib) - [Modrinth](https://modrinth.com/mod/craterlib)
- [Online Config Editor](https://editor.firstdark.dev)
- [Documentation](https://sdlink.fdd-docs.com)
- This single jar works on 1.18.2-1.21.7
- Requires CraterLib 2.1.3 or newer*
- Bug Fixes**:
- Fix bot randomly reconnecting to discord, and reloading everything and causing ratelimit spams
- Remove left over debug logging from LuckPerms rank syncing
- Fixed deathMessages config option being ignored - [#147](https://github.com/hypherionmc/sdlink/issues/147)
- Escape underscore (_) from usernames, so discord does not format it. - [#145](https://github.com/hypherionmc/sdlink/issues/145)
- New Features**:
- Add a new %current_time% placeholder for embeds, usable with
<t:TIME>and similar - [#143](https://github.com/hypherionmc/sdlink/issues/143)
- REQUIRES [CraterLib](https://www.curseforge.com/minecraft/mc-mods/craterlib) - [Modrinth](https://modrinth.com/mod/craterlib)
- [Online Config Editor](https://editor.firstdark.dev)
- [Documentation](https://sdlink.fdd-docs.com)
- This single jar works on 1.18.2-1.21.4
- Requires CraterLib 2.1.3 or newer*
- Bug Fixes**:
- Fixed Emojis not working with Emojiful - [#138](https://github.com/hypherionmc/sdlink/issues/138)
- Remove synced ranks when account is unverified - [#134](https://github.com/hypherionmc/sdlink/issues/134)
- Don't try to sync mentions to client when running on paper
- Fix database engine not regenerating database files when they are deleted while the server is running
- Fixed Forwarded messages not being relayed to discord - [#141](https://github.com/hypherionmc/sdlink/issues/141)
- Added checker to prevent bot from getting stuck in NotReady state - [#139](https://github.com/hypherionmc/sdlink/issues/139)
- New Features**:
- Added Optional verification, to allow people to use most (not all) features that required access control to be enabled, without it being enabled.
- Added basic spam checker to prevent spammed messages from being relayed to discord. Should help with command spams and ratelimits
- Allow Verify and Unverify commands to be used in DM, and verification codes can also be DM'ed to the bot
- Compatibility with Player Revive Mod - [#107](https://github.com/hypherionmc/sdlink/issues/107)
- Added feature to log Whitelist changes to a channel - [#78](https://github.com/hypherionmc/sdlink/issues/78)
- Config Option to add your own Avatar Service URL
- Technical Changes**:
- Updated Discord JDA to Stable 5
- REQUIRES [CraterLib](https://www.curseforge.com/minecraft/mc-mods/craterlib) - [Modrinth](https://modrinth.com/mod/craterlib)
- [Migration guide](https://sdlink.fdd-docs.com/migration/) for V2 users
- [Online Config Editor](https://editor.firstdark.dev)
- Requires CraterLib 2.1.2 or newer*
- Breaking Changes**:
- This update potentially breaks real verified accounts on "offline" servers. If that's the case, unverify and reverify your account.
- Bug Fixes**:
- Fix Role Checker showing Role Role (instead of just Role)
- Added missing permissions to invite link and permission checker
- Fixed issues with geyser/floodgate servers using access control
- Fixed Linked Commands not respecting discord role ordering - [130](https://github.com/hypherionmc/sdlink/issues/130)
- Finally fixed inverted Vanish Api Check
- Fixed Channel Overrides and Access Control not reloading without server restart
- Fix Join/Leave, Command Messages and Advancements not using linked player names - [131](https://github.com/hypherionmc/sdlink/issues/131)
- New Features**:
- Add Mini Message formatting support to access control messages
- Add support for multiple, random bot statuses - [#44](https://github.com/hypherionmc/sdlink/issues/44)
- Add option to trigger Minecraft commands on role changes [#77](https://github.com/hypherionmc/sdlink/issues/77)
- Added a basic developer api. Please request additional features on GitHub/Discord
- Added
sdconfigeditorminecraft command, to integrate with our Online Config Editor - Support for Paper. Only currently available on [NightBloom](https://nightbloom.cc/project/sdlink/files?loader=paper)
- Removed reliance on JSONDB and greatly reduce mod size
- FTB Ranks and LuckPerms ranks syncing
- REQUIRES [CraterLib](https://www.curseforge.com/minecraft/mc-mods/craterlib) - [Modrinth](https://modrinth.com/mod/craterlib)
- [Migration guide](https://sdlink.fdd-docs.com/migration/) for V2 users
- [Online Config Editor](https://editor.firstdark.dev)
- Requires CraterLib 2.1.1 or newer*
- New Features**:
- You can now override message destinations with Channel IDs and Webhook URLS
- Added a config setting to disable linked command messages from being deleted
- Re-Added nickname syncing for account linking, with config option to disable
- Added support for FTB Essentials Muting System
- Added config option to disable Discord -> MC message relay
- Allow adding the current timestamp to embeds, by setting
timestampto1 - Added a new config file to enable/disable compat with other mods
- Added integration with Maintenance Mode
- Added support for MiniMessage formatting for the
mcprefix




