# DiscordSRV ## Enabling To enable this feature all what you need to do is enable it in `config.yml`and install [DiscordSRV](https://www.spigotmc.org/resources/discordsrv.18494/): {% tabs %} {% tab title="config.yml" %} ```yaml discordchat: enable: true ``` {% endtab %} {% endtabs %} {% hint style="warning" %} **Notice**\ Please, make sure you have the latest version of DiscordSRV (>=1.23.0) {% endhint %} ## How does it work? ### Automatically At the beginning of the launch of your server, SimpleClans will create categories for the number of your clans, inside the categories, there will be a separate text channel for each clan: ![](https://3147254304-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MDzSURjf29qvGnoWu7Z%2F-MiMiyZZnqeMdVrHLS--%2F-MiMmLCupNDwpwAqUPWZ%2F%D0%B8%D0%B7%D0%BE%D0%B1%D1%80%D0%B0%D0%B6%D0%B5%D0%BD%D0%B8%D0%B5.png?alt=media\&token=a3f69129-809f-4cfc-9184-c5ddd3ef0a31) {% hint style="warning" %} **Notice**\ Take **attention** that you will have a different structure:\ `clan1`, `clan2`, `clan3` and `clan4` will be placed in **one category**, until it's reached the limit, then creates a new category. {% endhint %} **This will allow players to communicate in channels specially created for them.** Discord channel will be created/deleted/modified when: * Clan player creates/deletes a clan * Clan player is joining/resigning from his clan * Clan player got a promotion or a demotion * Player just linked to Discord ### Manually Since SimpleClans 2.16.2, it's possible to disable auto clan creation and create the discord channel by command. To enable manually this way, you have to disable related config option: ```yaml discordchat: auto-creation: false ``` Our congratulations! Now all leaders with a specified permission (`simpleclans.leader.discord.create`) can create their discord channel. With that permission they are allowed to use a command to create their clan's discord channel: ``` /clan discord create ``` Furthermore, if you're using an economy plugin, you can specify a price for clan creation: ```yaml economy: purchase-discord-create: true discord-creation-price: 1000 ``` ### General notes {% hint style="info" %} **Note 1** \ Only linked players have an access to their clans in discord, but the messages from un-linked will sent too. {% endhint %} {% hint style="info" %} **Note 2**\ If you're the server owner and you can't write a message to another chats, ask yourself: \ \&#xNAN;*is SimpleClans allow to you to send the message to other clan chats?* \ You could use `/clan mod place ` to join and send the message to that chat. {% endhint %} ## Discord limits > Only 50 channels at category as maximum So when the category will be filled with 50 channels, SimpleClans will create a new category and place a new channel there. > Maximum 500 channels at discord server That is why, if you have more than 500 clans, then SimpleClans won't catch all of them.\ You could use `discordchat.text.clans-limit` at configuration. ## Configuration ### DiscordChat section | Config value | Description | | ------------------------------------------ | ------------------------------------------------------------------------------------------------------------ | | `discordchat.enable` | Enables the DiscordSRV integration | | `discordchat.discord-format` | The message format from minecraft to discord | | `discordchat.format` | The message format from discord to minecraft | | `discordchat.spy-format` |

The message format from discord to server admins
(simpleclans.admin.all-seeing-eye)

| | `discordchat.rank` | The rank format | | `discordchat.auto-creation` | Turns off automatic discord channels creation. Use `clan discord create` command for manually creation | | `discordchat.min-linked-players-to-create` | The count of minimum linked players to be able to create the discord channel | | `discordchat.text.category-format` | The name of category ("SC – TextChannel") | | `discordchat.text.category-ids` | The ids of SC categories. You may add your own category here if you want to | | `discordchat.text.whitelist` | This will allow only specified clans be created | | `discordchat.text.clans-limit` | Limit of discord channels. Maximum is 500. | ### Economy section | Config value | Description | | --------------------------------- | -------------------------------------------------------- | | `economy.purchase-discord-create` | Allows leaders to purchase the discord channel creation. | | `economy.discord-creation-price` | How much channel purchasing will cost? | ## DiscordSRV configuration Some of DiscordSRV configurations won't work on SC channels.\ There is the small list: * `DiscordChatChannelDiscordToMinecraft` – Do you really need to disable it in DiscordSRV's config, when you may disable it in SC config?thinking * `DiscordChatChannelRequireLinkedAccount` *–* Our implementation requires only linked players. * `DiscordChatChannelBlockBots` – We're all robots, now you know the truthrobot * `DiscordChatChannelBlockedIds` – Where is an option to block my IP? * `DiscordChatChannelBroadcastDiscordMessagesToConsole` – You have spy chat for admins for that. * `DiscordChatChannelTruncateLength` – Does anyone know what `truncate` is? * `DiscordChatChannelRolesAllowedToUseColorCodesInChat` – No. At least, `DiscordChatChannelEmojiBehavior` will work.smiley --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://wiki.roinujnosde.me/simpleclans/integration/discordsrv-integration.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.