![DiscordSRV](https://lol.scarsz.me/AiKvTS/Logo-filled-stroke.png) **The most powerful, configurable, open-source Discord bridge plugin out there.** **Supports All Minecraft Versions from 1.7.9 to 1.21.x** _**We only give support for the latest release/dev builds; please update before asking for help**_ ## Features - Bridge between Minecraft and Discord chats - Forward your Minecraft Console to a Discord text channel and execute commands from Discord - Broadcast alerts based on certain events ([`alerts.yml`](alerts)) - Voice Proximity through the Discord Voice Chat ([`voice.yml`](voice)) - Require linking accounts (or certain role/s) to play ([`linking.yml`](linking)) - Link your Minecraft account to your discord account ([`config.yml`](config) & [`synchronization.yml`](synchronization)) - Minecraft group <-> Discord role sync - Minecraft (display) name -> Discord (nick) name sync - Minecraft <-> Discord ban sync - Rewarding players (for being in the Discord server / boosting etc) - Knowing who's who (with /discord linked, verification) - Administrative purposes - Supports many languages - Chinese, Danish, Dutch, English, Estonian, French, German, Japanese, Korean, Polish, Russian, Spanish, and Ukrainian - Support for popular chat plugins (listed below) - Highly customizable ### Plugins we hook into: * #### Chat * [Herochat], [LegendChat], [LunaChat], [TownyChat], [VentureChat] * #### Vanish * [Essentials], [PhantomAdmin], [SuperVanish], [VanishNoPacket] * #### World * [Multiverse] * [Vault] * [LuckPerms] * [PlaceholderAPI] - [DiscordSRV Expansion Placeholders](papi-placeholders) ### Plugins that use our API: * [DiscordSRV StaffChat] * [ChatControlRed] * [CMI] * [Plan] * [EmojiChat] * [PurpleIRC] * [ChatReplay] * [AuctionHouse] * [Staff Facilities] * [Staff++] * [LiteBansBridge] * [MCSF (My Christian Swear Filter)] * [MZP-VoteParty] * [InteractiveChat DiscordSRV Addon] (Not associated with DiscordSRV) * [DiscordSRVUtils] (Not associated with DiscordSRV) * [ActivityRoles] * [EconomyShopGUI] * [DiscordSchematicUploader] (Not associated with DiscordSRV) * [KiaiMC] * [SlashAdditions] * [Custom Bans Plus] * [DiscordSRVOAuth] (Not associated with DiscordSRV) * [Villager Announcer] * [DiscordNickSync] ## Intended usage By using this plugin, you are able to give players the ability to chat in-game with players on your Discord server, as well as having people on the Discord server be able to chat with people in the minecraft server - This can be useful for players that still want to communicate with players in-game, but can't access the Minecraft server for whatever reason. This plugin has a remote console feature. You can designate a text channel for the plugin to forward console messages, which also runs all messages sent into that channel 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, you can have some server roles have access to see the console, while also not allowing them to send messages in that channel, thus creating a read-only console for trusted staff members. Both chat and console are toggleable through the configuration file. Some options can be refreshed with `/discordsrv reload` by an OP or a player with the `discordsrv.reload` permission. ## Bot Permissions ### Server Permissions | Permission | Features | |--------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | `Manage Roles` | [role synchronization](https://config.discordsrv.com/synchronization/GroupRoleSynchronizationGroupsAndRolesToSync) and [adding roles to linked players](https://config.discordsrv.com/config/MinecraftDiscordAccountLinkedRoleNameToAddUserTo) | | `Manage Channels` | [channel topic updater](https://config.discordsrv.com/messages/ChannelTopicUpdaterChatChannelTopicFormat) and the [voice module](https://config.discordsrv.com/voice/_) | | `Ban Members` | [ban synchronization](https://config.discordsrv.com/synchronization/BanSynchronizationDiscordToMinecraft) | | `Manage Nicknames` | [nickname synchronization](https://config.discordsrv.com/synchronization/NicknameSynchronizationEnabled) | | `Manage Webhooks` | [experimental webhook usage](https://config.discordsrv.com/config/Experiment_WebhookChatMessageDelivery) | | | (Server-wide permission is _recommended_, but can be applied on a per-channel basis) | ### Channel Permissions | Permission | Features | |---------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | `Read Text Channels & See Voice Channels` | Required for DiscordSRV's channel options (including [console](https://config.discordsrv.com/config/DiscordConsoleChannelId) and [voice lobby](https://config.discordsrv.com/voice/Lobby%20channel)), the [voice module category](https://config.discordsrv.com/voice/Voice%20category) and any other channels you want for [canned responses](https://config.discordsrv.com/config/DiscordCannedResponses) | | and `Send Messages` | | | `Manage Messages` | when messages are deleted by [playerlist](https://config.discordsrv.com/config/DiscordChatChannelListCommandEnabled) & [chat channel commands](https://config.discordsrv.com/config/DiscordChatChannelConsoleCommandEnabled) | | `Embed Links` | optionally for embedding ingame-posted links and required when embed messages are used [death](https://config.discordsrv.com/messages/MinecraftPlayerDeathMessage), [join/Leave](https://config.discordsrv.com/messages/MinecraftPlayerJoinMessage) | | `Mention @everyone, @here and All Roles` | for mentioning @everyone if added to [allowed mentions in config.yml](https://config.discordsrv.com/config/DiscordChatChannelAllowedMentions) and [mentions enabled](https://config.discordsrv.com/config/DiscordChatChannelTranslateMentions) | | `Add Reactions` and `Read Message History` | for when the bot reacts with "💬" and "❗" to notify a [truncated message](https://config.discordsrv.com/config/DiscordChatChannelTruncateLength) is being sent from Discord to Minecraft | | `Move Members`, `Mute Members` and `Manage Permissions` | required for the [voice lobby](https://config.discordsrv.com/voice/Lobby%20channel) and [voice category](https://config.discordsrv.com/voice/Voice%20category) | ## Installation Visit the [Installation](installation) page for clear and in-depth instructions on installing and setting up DiscordSRV. ## Donations First off, thank you from the bottom of my heart for the pizza. If you would like to donate, go to https://scarsz.me/donate. $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 (DiscordSRV version 1.18.0+) to your project. You also need to add the JDA repository. For an example of this, see [DiscordSRV-ApiTest](https://github.com/DiscordSRV/DiscordSRV-ApiTest). Be sure to add "DiscordSRV" to your plugin's `plugin.yml` depends/softdepends list. ### Maven ```xml Scarsz-Nexus https://nexus.scarsz.me/content/groups/public/ ... com.discordsrv discordsrv 1.29.0 provided ``` ### Gradle ```js repositories { maven { url 'https://nexus.scarsz.me/content/groups/public/' } } dependencies { compileOnly 'com.discordsrv:discordsrv:1.29.0' } ``` ## 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.yml file. ## Update checking DiscordSRV checks for updates using GitHub's API, and makes sure the version is safe to use via a minimum version (security feature), you may disable update checking by setting `UpdateCheckDisabled` to `true` in the config.yml file; however this may leave your server at risk if there is a security issue/exploit and you're running a vulnerable version. [Herochat]: https://www.spigotmc.org/resources/34305/ [LegendChat]: https://www.spigotmc.org/resources/6268/ [LunaChat]: https://github.com/ucchyocean/LunaChat/ [TownyChat]: https://www.spigotmc.org/resources/towny-72694/ [VentureChat]: https://www.spigotmc.org/resources/771/ [Essentials]: https://www.spigotmc.org/resources/9089/ [PhantomAdmin]: https://www.spigotmc.org/resources/37845/ [SuperVanish]: https://www.spigotmc.org/resources/1331/ [VanishNoPacket]: https://dev.bukkit.org/projects/vanish/ [Multiverse]: https://dev.bukkit.org/projects/multiverse-core/ [Vault]: https://www.spigotmc.org/resources/34315/ [LuckPerms]: https://luckperms.net/ [PlaceholderAPI]: https://www.spigotmc.org/resources/6245/ [DiscordSRV StaffChat]: https://www.spigotmc.org/resources/44245/ [ChatControlRed]: https://mineacademy.org/chatcontrol/ [CMI]: https://www.spigotmc.org/resources/3742/ [Plan]: https://www.spigotmc.org/resources/32536/ [EmojiChat]: https://www.spigotmc.org/resources/50955/ [PurpleIRC]: https://www.spigotmc.org/resources/2836/ [ChatReplay]: https://www.spigotmc.org/resources/28982/ [AuctionHouse]: https://www.spigotmc.org/resources/61836/ [Staff Facilities]: https://www.spigotmc.org/resources/13097/ [Staff++]: https://www.spigotmc.org/resources/83562/ [LiteBansBridge]: https://www.spigotmc.org/resources/76326/ [MCSF (My Christian Swear Filter)]: https://www.spigotmc.org/resources/54115/ [MZP-VoteParty]: https://www.spigotmc.org/resources/89754/ [InteractiveChat DiscordSRV Addon]: https://www.spigotmc.org/resources/83917/ [DiscordSRVUtils]: https://www.spigotmc.org/resources/85958/ [ActivityRoles]: https://modrinth.com/plugin/activityroles/ [EconomyShopGUI]: https://www.spigotmc.org/resources/69927/ [DiscordSchematicUploader]: https://modrinth.com/plugin/discordschematicuploader/ [KiaiMC]: https://modrinth.com/plugin/KiaiMC/ [SlashAdditions]: https://modrinth.com/plugin/slashadditions/ [Custom Bans Plus]: https://www.spigotmc.org/resources/89075/ [DiscordSRVOAuth]: https://modrinth.com/plugin/discordsrvoauth/ [Villager Announcer]: https://modrinth.com/plugin/villager-announcer/ [DiscordNickSync]: https://modrinth.com/plugin/discord-nick-sync