DiscordSRV
DiscordSRV
The most powerful, configurable, widely loved, open-source Discord bridge plugin out there.
Build server - get the absolute latest builds (or old ones) here
Competition - See why you should be using DiscordSRV over the competitors
DiscordSRV's Discord server - come here for quick support and to tell us feature requests
Source at GitHub
Wiki on GitHub
Intended usage
Using this plugin, you are able to give players the ability to chat in-game to chat with players on your Discord server as well as having people on the Discord server be able to chat with people on the server- this is useful for the situation of someone not being at their computer and being able to talk in-game.
As well as that, this plugin also has a remote console feature. You can designate a text channel for the plugin to listen on where messages sent to that channel are run as commands by the server console. You should restrict sending this channel to a developer or high ranking role only. Due to how Discord's permissions work, though, you can have some server roles being able to see the console, yet not being able to send messages in that channel, thus creating a read-only console for trusted staff members.
Both the chat and console link are toggleable through the configuration file. Some, but not all, options can be refreshed with /discord reload, by an op. VanishNoPacket permissions like silent join/quit, fake join/quit and join without announcing are checked when sending player join messages in the chat channel.
Install
Java 8+ is required. It's recommended to go to DiscordSRV's wiki at https://github.com/Scarsz/DiscordSRV/wiki/Installation for picture instructions or watch one of the vidoes below to walk you through the installation.
If you want a straight-forward install, though, you can just follow these steps:
- Create a new application at https://discordapp.com/developers/applications/
- On the application's page, go to the "Bot" tab, click "Add Bot", and confirm
- Optional: set your bot's avatar. If you don't do it now, you can later by command.
- Click the copy button under "Token" on the bot tab, we'll be using it later
- Install the plugin, run & stop the server, then open the configuration file
- Paste the token you copied earlier into the BotToken value
- Go to https://scarsz.me/authorize & paste your application's Client ID value to the page
- Find your client ID in the "General Information" tab
- In the config option labeled Channels, input the Discord channel ID you want to be for your chat under "global"- you can set more channels up here and their linked channels.
- If you are using TownyChat, change the channel to "general" instead of "global"
- For reference, to obtain a channel ID, go to the cog on the bottom left of Discord, go to the appearance tab, enable developer mode. From there you can right click a guild, channel, user, or role and there will be a "Copy ID" option
- Optionally add a console channels ID in the config to access your server console from Discord
- Run through all the config options, you'll be surprised with how many features this plugin has
- Profit
Supported plugins
DiscordSRV implements with a fair amount of plugins for chat and vanish functionality. We recommend VentureChat by Aust1n46 but plugins such as Herochat, VentureChat, Essentials, Premium/Super vanish, VanishNoPacket, and Multiverse all have functionality in DiscordSRV.
Commands/permissions
/discord
All of DiscordSRV's commands can be exposed from /discord. This includes but isn't limited to /discord toggle which toggles sending Discord messages back/forth for you- tell your players about this command!
discordsrv.chat
Allows people to have their chat sent to Discord. Go figure. Given by default, only exists so you can negate this permission from people/groups.
OP
All the admin commands for DiscordSRV require you to be an OP. To see the help, run /discordsrv in-game.
FAQ
How do I fix the error "Unsupported major.minor version 52.0?"
Update the server's Java JRE version to Java 8. <1.8 is unsupported.
I reloaded the plugin/server and now it won't work
DON'T RELOAD THE PLUGIN. IT BREAKS IT.
When I join/quit my server, a message isn't sent in the chat channel for me. What gives?
You have one of VanishNoPacket's/Essentials' permissions to join/quit silently. To disallow this, give yourself or the group one of the following depending on what you want to allow.
-discordsrv.silentjoin -discordsrv.silentquit
Donations
First off, thank you from the bottom of my heart for the pizza. If you would like to donate, go to https://paypal.me/Scarsz. $10 is the suggested amount but you can donate however much you would like- anything is a massive thank you from me. In the note put your Discord username and if you're in DiscordSRV's server you'll be set as a donator and you'll receive some neat perks in the future. If you donated without the note, send me a PM on Discord and I'll manually check it.
Developers
If you want to interface DiscordSRV with your plugin, you can do so by adding the Maven dependency or adding the plugin jar to your project. For an example of this, see https://github.com/Scarsz/DiscordSRV-ApiTest. Be sure to add "DiscordSRV" to your plugin's plugin.yml depends/softdepends list.
Data usage
Data collection
Anything and everything shown at https://bstats.org/plugin/bukkit/DiscordSRV will be visible to the public with your server included in the statistics. This is only for statistics, no private information of your server is sent. If you don't want your server included in this, specify the config option "MetricsDisabled" and set it to "true" in the config.
Update checking
I have absolutely no clue why you would want to disable this, but if you do, set the "UpdateCheckDisabled" config option to "true".
I have absolutely no clue why you would want to disable this, but if you do, set the "UpdateCheckDisabled" config option to "true".
I run a 1.7.10 modserver and when you remove support for old MC-Version in a new PluginVersion then i have a broken Plugin. I disable automatic update/updatechek on all Plugins on my Server and test new Version manualy bevor i update. When the new Version not run on a old Serverversion, then i have everytime the "new version aviable" from many plugins in the consolelog.
thanks for make a option for disable the UpdateCheck xD
Was wondering why this plugin does not have support for &9 color chat. If you guys could, please implement it.
This is a very good plugin, i recommend it to every server owner as this will help to make your server easier controlled you have access everywhere! I had Some problems but i joined the discord server and they helpen me out!
Good job!!!!
Simply the best Discord plugin out there! Integrates with the most commonly used chat plugins. Developer updates it's snapshot's very regularly and is willing to help you. Any questions/issues are very swiftly handled in the DiscordSRV discord chat. This plugin only gets better the more your use it! I recommend it to anyone using Discord for his/her server on a regular basis!
This is the best Discord Plugin I've ever used! I recommend every minecraft discord users to use this plugin if they want to connect their minecraft server with discord! Lots of features and configurable options! Really Amazing plugin! I rate it: 10/10
I keep getting things from my server console in my discord Example: [Mon Oct 17 17:15:40 PDT 2016 INFO] [ArmorWeight] Enabling ArmorWeight v0.3.12 [Mon Oct 17 17:15:40 PDT 2016 INFO] [ArmorWeight] Enabled successfully. [Mon Oct 17 17:15:40 PDT 2016 INFO] [Parties] Enabling Parties v1.11 [Mon Oct 17 17:15:40 PDT 2016 INFO] Server permissions file permissions.yml is empty, ignoring it
@WhosHenry
Please join the Discord guild
@ScarszRawr
@ScarszRawr
I updated from v 11.0 to 12.2 and that must have caused it. Was working fine in v 11.0
@WhosHenry
Join the Discord guild and we can determine what's causing it fam
I'm getting this error when I send a message from the Discord channel to the server - http://pastebin.com/fbYmQ4d4 I am on v 12.2
Hi!
Most of the server in Japan, are using "LunaChat" plugin as Chat Plugin.
http://forum.minecraftuser.jp/viewtopic.php?f=38&t=13739
I got some requests of adding connection feature of LunaChat and Discord.
So, I want to add LunaChatHook in DiscordSRV.
Can I send a pull request to the develop branch of your repository?
After adding LunaChatHook, many Japanese servers will use DiscordSRV. :D
@freakyy85
The problem is that Minecraft does not support emoticons. What you can do is deactivating automatic replacement of plaintext-smileys within Discords settings under Text and Pictures -> Emoji
Hi!
Awesome plugin but one thing. The smileys dont get through. If you on discord write :) the smiley or plain text is not displayed on Minecraft. Can you fix that?
Thanks! freaky.
@TiTech1 ...yes?
can someone simplify what it does? how do they communicate from discord and the server, like if I said "Hello" in discord, it would show up on the server chat?
@evernife
Shouldn't be, join the Discord guild
Ty.
Another question, there is something that i need to config to make colors work?
Because it doesn't work for me T.T
@evernife /discord toggle
Is there a way pro prevent the receive os messages from the bot?
For exemple
Some of my players dont like the spam of the discord (lots of people use it), so, is there a permission to deny the receive os messages?
@Androkai
That worked :-)
And hopefully it will be possible one day to show (MultiVerse) world aliases/prefixes in the Minecraft => Discord chat ;-)