# DiscordSRV

## Включение

Чтобы включить эту функцию всё, что вам нужно сделать – включить её в `config.yml` и установить [DiscordSRV](https://www.spigotmc.org/resources/discordsrv.18494/). 

{% tabs %}
{% tab title="config.yml" %}

```yaml
discordchat:
    enable: true
```

{% endtab %}
{% endtabs %}

{% hint style="warning" %}
**Внимание**

Пожалуйста, убедитесь, что вы используете последнюю версию DiscordSRV (>=1.23.0)
{% endhint %}

## Как это работает?

### Автоматически

В начале запуска вашего сервера, SimpleClans создаст категории для ваших кланов, внутри категорий будет отдельный текстовый канал для каждого клана:

![](https://738280454-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" %}
**Внимание**

Имейте ввиду, что ваша структура в дискорде будет отличаться от скриншота.\
`clan1`, `clan2`, `clan3`, `clan4` будут находиться в **одной** категории, пока категория не достигнет своего лимита (в таком случае, SimpleClans создаст ещё одну категорию).
{% endhint %}

**Это позволит игрокам общаться в специально созданных для них каналах.**

Канал Discord будет создан/удален/изменен, когда:

* Игрок создает/удаляет клан
* Игрок вступает в клан/выходит из клана
* Игрок клана получил повышение или понижение 
* Игрок соединил/отсоединил свой аккаунт с Discord'ом

{% hint style="info" %}
**Заметка 1**

Только связанные игроки имеют доступ к своим кланам в дискорде, но сообщения от несвязанных будут также отправляться.
{% endhint %}

{% hint style="info" %}
**Заметка 2**

Если вы являетесь администратором сервера и не можете написать сообщение в чат другого клана, спросите себя: позволяет ли вам SimpleClans отправлять сообщения в чаты других кланов? \
\
Вы могли бы использовать `/clan mod place <`клан`>`, чтобы присоединиться и отправить сообщение в нужный чат.
{% endhint %}

### Вручную

Начиная с версии 2.16.2, у вас есть возможность отключить авто-создание каналов и контроллировать ситуацию собственноручно.&#x20;

Чтобы включить ручное создание, надо выключить следующий пункт:

```yaml
discordchat:
    auto-creation: false
```

Наши поздравления! Теперь все лидеры с специальным резрешением (`simpleclans.leader.discord.create`) могут создать их собственный канал.

Для этого им необходимо исполнить следующую команду:

```
/clan discord create
```

Более того, если вы используете экономический плагин, вы также можете указать цену за создание:

```yaml
economy:
    purchase-discord-create: true
    discord-creation-price: 1000
```

### Основные заметки

{% hint style="info" %}
**Заметка 1**

Только привязанные игроки имеют доступ к их кланам в дискорде, но сообщения от непривязанных будут отправлены в том числе.
{% endhint %}

{% hint style="info" %}
**Заметка 2**

Если вы админ сервера и не можете написать сообщения в другие чаты, спросите себя: *позволяет ли SimpleClans писать вам сообщения в другие чаты кланов?*\
Вы можете использовать `/clan mod place <нужный клан>`, чтобы присоединиться и отправить сообщения в этот чат.
{% endhint %}

## Говоря об ограничениях дискорда...

> Максимум только 50 каналов в одной категории

Поэтому, когда категория будет заполнена 50 каналами, SimpleClans создаст новую категорию и разместит в ней новый канал.

> Максимум 500 кланов в дискорде сервере

Поэтому, если у вас более 500 кланов, то SimpleClans не сможет обработать их все.\
Вы можете использовать `discordchat.text.clans-limit` в конфигурации для ограничения количества каналов на вашем дискорд сервере.

## Конфигурация

| Опция                              | Значение                                                                                            |
| ---------------------------------- | --------------------------------------------------------------------------------------------------- |
| `discordchat.enable`               | Включает интеграцию с DiscordSRV                                                                    |
| `discordchat.discord-format`       | Формат сообщений из майнкрафта в дискорд                                                            |
| `discordchat.format`               | Формат сообщений из дискорда в майнкрафт                                                            |
| `discordchat.spy-format`           | <p>Формат сообщений из дискорда к админам</p><p>(<code>simpleclans.admin.all-seeing-eye</code>)</p> |
| `discordchat.rank`                 | Формат ранга                                                                                        |
| `discordchat.text.category-format` | <p>Наименование категории <br>("SC – TextChannel")</p>                                              |
| `discordchat.text.category-ids`    | <p>Айди категорий. <br>Вы можете добавить их вручную, если хотите.</p>                              |
| `discordchat.text.whitelist`       | Белый список кланов создаст только кланы, указанные в нём.                                          |
| `discordchat.text.clans-limit`     | Ограничение каналов на дискорд сервере. Максимум - 500.                                             |

## Опции, которые НЕ будут работать

Некоторые конфигурации DiscordSRV не будут работать на каналах SimpleClans'а. \
Вот небольшой список:

* `DiscordChatChannelDiscordToMinecraft` – Вы можете отключить дискорд интеграцию в конфиге SimpleClans'а.
* `DiscordChatChannelRequireLinkedAccount` *–* Интеграция с дискордом требует наличие только привязанных игроков.
* `DiscordChatChannelBlockBots` – Мы все роботы :robot:, теперь вы знаете правду.
* `DiscordChatChannelBlockedIds` – И где же я могу заблокировать свой айпи? :thinking:
* `DiscordChatChannelBroadcastDiscordMessagesToConsole` – У вас есть шпионский чат для администраторов.
* `DiscordChatChannelTruncateLength` – Кто-нибудь знает что такое `Truncate`? :smile:
* `DiscordChatChannelRolesAllowedToUseColorCodesInChat` – Нет.

Ну, хотя бы `DiscordChatChannelEmojiBehavior` будет работать нормально. :thumbsup: