# DiscordSRV

## Включение

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

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

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

{% endtab %}
{% endtabs %}

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

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

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

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

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

![](/files/-MiMmLCupNDwpwAqUPWZ)

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

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

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

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

* Игрок создает/удаляет клан
* Игрок вступает в клан/выходит из клана
* Игрок клана получил повышение или понижение&#x20;
* Игрок соединил/отсоединил свой аккаунт с 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:


---

# 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/russian/integracii/discordsrv.md?ask=<question>
```

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.
