DiscordRelay
PluginGPL-3.0-or-later

DiscordRelay

A plugin for relaying chat between Discord and Minecraft.

36
Downloads
0
Followers
5 months ago
Updated
📦
1
Versions

📖About DiscordRelay

header

A plugin for relaying chat between Discord and Minecraft.

Features

  • Two-way chat between Discord and Minecraft
  • Display messages in Discord (optionally in embeds) for common events like player joins or deaths
  • Role ping protection from Minecraft
  • Simple Developer API for creating new Discord commands
  • Built-in Discord commands:
    • !playerlist
    • !serverinfo
    • !playerinfo <player name>
    • !cape <player name>
    • !skin <player name>
    • !avatar <player name>
  • Built-in /discord in-game command so players can see info about your Discord server
  • Automatic updating of the relay channel topic in Discord!
  • Change the bot's status type between Playing, Streaming and Listening
  • Restart the bot with /drelay restart without restarting the server
  • Reload the config with /drelay reload
  • PlaceholderAPI support
    ...and more!

Permissions

Permission Default Description
drelay.reload op Allow using the /drelay reload command to reload the config
drelay.restart op Allow using the /drelay restart command to restart the bot
drelay.allowrolepings op Allow the player to ping users/roles by typing e.g. <@382274626269307392>
drelay.sendtodiscord everyone The players chat messages will be sent to Discord
drelay.receivefromdiscord everyone The player will see messages sent from Discord

Plugin Setup

  1. Create a new application here
  2. Navigate to the "Bot" tab on the left side and press "Add Bot"
  3. Press "Click to Reveal" and copy the token to your config.yml file
  4. Go to the following page and click "Authorize"
https://discord.com/oauth2/authorize?client_id=YOUR-CLIENT-ID-HERE&permissions=11264&scope=bot

(Make sure to replace YOUR-CLIENT-ID-HERE with your "Application ID" which can be found on the General Information tab)

  1. Ensure "Message Content Intent" is ticked
    image
  2. Enable developer mode in Discord by going to settings then the "Advanced" tab
  3. Right-click the channel you would like to be used for relaying chat and select "Copy ID"
  4. Paste the copied ID into your config.yml file
  5. Make sure the bot has permissions to send and receive messages

It may look a bit daunting but it's actually quite easy!