PluginGPL-3.0-or-later
Simple Discord Chat Bridge
Mirror your Minecraft Chat onto your Discord server and Back! Allows for extended customization of text feedback.
51
Downloads
0
Followers
2 months ago
Updated
📦
2
Versions
📖About Simple Discord Chat Bridge
Entangle your Minecraft chat with a channel on your Discord Server.
What?
A barebones connection between Minecraft and Discord. Everything runs locally on your server, meaning you are completely independent of any 3rd Party Discord-Bots and APIs (except official Discord and Mojang API ofc).So far the only other major feature except chat mirroring is simple (emergent) account linking. Some future features and completions can be found in the linked issue tracker.
Customization:
- Customize the Appearance of your Discord Bot
- Player Engagement: Decide whether to send a connection reminder to unlinked Players after joining.
- Customizable Death Messages
- Emergent Whitelist: Decide whether you only want to let players join that have already linked their account half-way from Discord. (Useful if you want a server to be private to your Discord Server)
- Decide whether players who disconnect via discord while online should be kicked.
- You can change all the Text fields in the config to your liking, thus making it possible to change the language without limits.
- If you want to set an Avatar for Server messages (like people joining and leaving), you can do so by running the plugin successfully once, and then changing the Webhook it has created. You find it under the settings of your mirror channel in the "Integrations" tab.
Why?
When playing on a Minecraft Server and no one is online, it can strenghten the feeling of "2 week phase is over". By linking your Minecraft chat to Discord, it can make the whole community more involved in the Gameplay. The secondary feature of linking Discord users to Minecraft players allows the transition to feel more smooth. It feels as if the people writing messages on Discord are right there with you on the server, even when they are using Discord from their phone!Stay tuned for updates to the Gallery! The icon is also very improvised.
How? (10min)
- Install the plugin and start the server once to generate default config
-
Create the Discord Application
- Create a new Application (make sure you are signed in)
- Generate and save the token (I have heard you are supposed to keep that one secret)
-
Configure the Application
Bot-Tab- enable server members intent
- enable message content intent
- set Banner, Name and Avatar as you like
- Scope:
applications.commandsbot - Permissions:
Manage WebhooksRead Message HistorySend Messages
- Add the Application to your Discord Server
-
Grab the Channel Id from your Discord Server
-
Enable Developer Mode in User settings on Discord
- Find your channel Id by right clicking the desired channel and clicking "Copy Channel Id"
-
Enable Developer Mode in User settings on Discord
- Go to the Config and set the Token and Channel Id
- Further Customize your experience in the Config
- You are ready to go!
Important Notes
- Be aware that anyone with access to the config file can see the bot-token and thus has full access to the bot.
- From 2.0 onwards there are config fields for the webhook token and id. Those should be left empty and will be set automatically.
- Messages are formatted. For more info look at the Discord (if you want to e.g. mention a role) and Minimessage docs.
FAQ
Why is the file size so large? The jars provided in the versions are shaded. That means they contain all libraries that are needed for the plugin to work within. What are the bot permissions for?-
Manage Webhooks- Used to create the webhook that sends messages as custom identities. -
Read Message History- Needed to read messages so they can be mirrored to Minecraft -
Send Messages- Needed to send messages into Discord incase the webhook is offline - server members intent - Used to resolve all members of the server into the internal name cache so names can be displayed instead of ids
- message content intent - Used to read the content of messages so they can be mirrored to Minecraft