> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cakestudio.fun/llms.txt
> Use this file to discover all available pages before exploring further.

# Интеграция с ботом

> Управление регионами через Discord и Telegram.

## 🤖 Интеграция с Discord и Telegram

Управляйте своими регионами, не заходя в игру! CakeRegionsPlus поддерживает полную интеграцию с ботами для Discord и Telegram, предоставляя удобный интерфейс для взаимодействия с вашими приватами.

#### Для игроков: Как привязать аккаунт?

Чтобы начать пользоваться ботом, вам нужно один раз привязать свой игровой аккаунт.

**Привязка Discord**

1. В игре введите команду `/ps link discord`. Вы получите уникальный одноразовый код.
2. Найдите Discord-бота вашего сервера и напишите ему в личные сообщения команду `/link` с вашим кодом. Например: `/link 1a2b3c`.
3. Готово! Ваш аккаунт привязан.

**Привязка Telegram**

1. В игре введите команду `/ps link telegram`. Плагин покажет вам имя Telegram-бота и уникальный код.
2. Найдите этого бота в Telegram и отправьте ему сообщение в формате `/link <код>`. Например: `/link 1a2b3c`.
3. Готово! Ваш аккаунт привязан.

#### Функционал ботов

После привязки вам станут доступны следующие возможности:

* **Просмотр списка регионов:** Команда `/regions` покажет вам все ваши регионы с основной информацией.
* **Управление регионами:** Через удобные кнопки вы сможете:
  * Просмотреть детальную информацию (прочность, топливо, координаты).
  * Посмотреть список участников, владельцев и создателя.
  * Добавлять и исключать участников и владельцев.
  * Настраивать права доступа для участников.

<img src="https://mintcdn.com/cakestudio/3fB0PNgRlocIvdwt/cakeregions/images/image-(23).png?fit=max&auto=format&n=3fB0PNgRlocIvdwt&q=85&s=e541974937fe9943c3f882f3f07be355" alt="Список регионов" width="743" height="784" data-path="cakeregions/images/image-(23).png" />

<img src="https://mintcdn.com/cakestudio/3fB0PNgRlocIvdwt/cakeregions/images/image-(19).png?fit=max&auto=format&n=3fB0PNgRlocIvdwt&q=85&s=a7cdfc4915877edc8384463a0155c47f" alt="Информация о регионе" width="588" height="294" data-path="cakeregions/images/image-(19).png" />

<img src="https://mintcdn.com/cakestudio/3fB0PNgRlocIvdwt/cakeregions/images/image-(20).png?fit=max&auto=format&n=3fB0PNgRlocIvdwt&q=85&s=43ab6be8b347964c484e8e1044fc1b47" alt="Управление участниками" width="529" height="321" data-path="cakeregions/images/image-(20).png" />

<img src="https://mintcdn.com/cakestudio/3fB0PNgRlocIvdwt/cakeregions/images/image-(21).png?fit=max&auto=format&n=3fB0PNgRlocIvdwt&q=85&s=c2d7ccb23850cec6f883e3f54c4129e4" alt="Добавление участника" width="608" height="266" data-path="cakeregions/images/image-(21).png" />

<img src="https://mintcdn.com/cakestudio/3fB0PNgRlocIvdwt/cakeregions/images/image-(22).png?fit=max&auto=format&n=3fB0PNgRlocIvdwt&q=85&s=3239a2ec1530cbde113a816cc52e8fca" alt="Настройка прав" width="586" height="236" data-path="cakeregions/images/image-(22).png" />

<img src="https://mintcdn.com/cakestudio/3fB0PNgRlocIvdwt/cakeregions/images/image-(26).png?fit=max&auto=format&n=3fB0PNgRlocIvdwt&q=85&s=87ab2c37603bc03ea749c66c47a6f27c" alt="Удаление участника" width="756" height="625" data-path="cakeregions/images/image-(26).png" />

<img src="https://mintcdn.com/cakestudio/3fB0PNgRlocIvdwt/cakeregions/images/image-(27).png?fit=max&auto=format&n=3fB0PNgRlocIvdwt&q=85&s=6b65d2709e757d035aeea472649a4d4c" alt="Подтверждение удаления" width="772" height="425" data-path="cakeregions/images/image-(27).png" />

<img src="https://mintcdn.com/cakestudio/3fB0PNgRlocIvdwt/cakeregions/images/image-(28).png?fit=max&auto=format&n=3fB0PNgRlocIvdwt&q=85&s=0fd1f6b03c79b9e73d8b48b9bef54033" alt="Назначение владельца" width="726" height="455" data-path="cakeregions/images/image-(28).png" />

<img src="https://mintcdn.com/cakestudio/3fB0PNgRlocIvdwt/cakeregions/images/image-(29).png?fit=max&auto=format&n=3fB0PNgRlocIvdwt&q=85&s=cc1709b57ed2190c36c643ecbaee1b46" alt="Снятие прав владельца" width="822" height="384" data-path="cakeregions/images/image-(29).png" />

<img src="https://mintcdn.com/cakestudio/3fB0PNgRlocIvdwt/cakeregions/images/image-(30).png?fit=max&auto=format&n=3fB0PNgRlocIvdwt&q=85&s=179dad66917d7cd51f2e2f305773fbf4" alt="Список регионов в ТГ" width="756" height="292" data-path="cakeregions/images/image-(30).png" />

<img src="https://mintcdn.com/cakestudio/3fB0PNgRlocIvdwt/cakeregions/images/image-(31).png?fit=max&auto=format&n=3fB0PNgRlocIvdwt&q=85&s=88367c3371b886065c0ff47fa6d3f96d" alt="Меню региона в ТГ" width="886" height="387" data-path="cakeregions/images/image-(31).png" />

#### Для администраторов: Настройка ботов

Чтобы интеграция заработала, администратору сервера необходимо настроить ботов.

<img src="https://mintcdn.com/cakestudio/3fB0PNgRlocIvdwt/cakeregions/images/image-(32).png?fit=max&auto=format&n=3fB0PNgRlocIvdwt&q=85&s=447b540eaf4675e4a5e7743370b72c03" alt="Настройка бота 1" width="832" height="506" data-path="cakeregions/images/image-(32).png" />

<img src="https://mintcdn.com/cakestudio/3fB0PNgRlocIvdwt/cakeregions/images/image-(33).png?fit=max&auto=format&n=3fB0PNgRlocIvdwt&q=85&s=0a067aaf2aab46b13e57d5b8f71be292" alt="Настройка бота 2" width="624" height="475" data-path="cakeregions/images/image-(33).png" />

<img src="https://mintcdn.com/cakestudio/3fB0PNgRlocIvdwt/cakeregions/images/image-(34).png?fit=max&auto=format&n=3fB0PNgRlocIvdwt&q=85&s=b953075bab0456002e5b23d918089227" alt="Настройка бота 3" width="748" height="474" data-path="cakeregions/images/image-(34).png" />

<img src="https://mintcdn.com/cakestudio/3fB0PNgRlocIvdwt/cakeregions/images/image-(35).png?fit=max&auto=format&n=3fB0PNgRlocIvdwt&q=85&s=2fd0f912a3882174c68d3503b0ef11ad" alt="Настройка бота 4" width="734" height="368" data-path="cakeregions/images/image-(35).png" />

**Настройка Discord-бота**

1. Зайдите в файл `plugins/CakeRegionsPlus/social/discord.yml`.
2. Установите `bot.enabled` в `true`.
3. Создайте своего бота на [Discord Developer Portal](https://discord.com/developers/applications), включите ему `Privileged Gateway Intents` (SERVER MEMBERS INTENT).
4. Вставьте **токен** вашего бота в поле `bot.token`.
5. Добавьте ID администраторов в `admin-accounts`.
6. Перезагрузите плагин (`/ps admin reload`).

**Настройка Telegram-бота**

1. Зайдите в файл `plugins/CakeRegionsPlus/social/telegram.yml`.
2. Установите `bot.enabled` в `true`.
3. Создайте бота через [@BotFather](https://t.me/BotFather) в Telegram и получите токен.
4. Вставьте **токен** в поле `bot.bot-token` и **имя пользователя** бота (без @) в `bot.bot-username`.
5. Добавьте ID администраторов в `admin-accounts`.
6. Перезагрузите плагин (`/ps admin reload`).