Чат-бот (Discord и Telegram)

Чат-бот подключает Lords Bot к вашему собственному боту в Discord или Telegram. Из чата можно посмотреть, какие аккаунты в сети, запускать и останавливать аккаунты, получать журналы и снимок экрана, а также оповещения, например об истёкшем ключе доступа. Участники гильдии тоже могут пользоваться банком гильдии из чата.

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

1. Создайте своего бота в Discord или Telegram и скопируйте его токен.
2. Подключите его: вставьте токен в Lords Bot и нажмите Подключиться (Connect).
3. Выберите чат: отправьте !set в канал или группу, которую хотите использовать. Вы станете администратором чат-бота.
4. Пользуйтесь: управляйте аккаунтами командами, получайте оповещения и дайте гильдии пользоваться банком из чата.

Настройка чат-бота #

В главном окне откройте Настройки > Опции > Прочие настройки (Settings > Options > Other Settings) и перейдите на вкладку Чат Бот (Chat Bot). Затем выполните шаги для Discord или Telegram.

Discord #

1. Перейдите на https://discord.com/developers/applications и создайте новое приложение (application).
2. Откройте страницу Bot приложения и скопируйте токен бота. Никому не сообщайте токен.
3. На той же странице включите Message Content Intent. Lords Bot нужен этот доступ, чтобы читать команды. Сохраните изменения. Если он выключен, Lords Bot остановится с ошибкой, которая подскажет его включить.
4. В Lords Bot вставьте токен в поле Токен бота: (Bot Token:), выберите Discord и нажмите Подключиться.
5. Когда статус покажет Discord Подключен (Discord Connected), нажмите Добавить бота в Discord (Add Bot to Discord) и добавьте бота на свой сервер.

Совет: если Discord пишет, что интеграция «requires code grant», вернитесь на портал разработчиков и выключите для своего бота параметр OAuth2 code grant.

Telegram #

1. Откройте https://t.me/BotFather в Telegram и отправьте /newbot.
2. Выберите имя, затем имя пользователя, которое заканчивается на bot. BotFather пришлёт вам токен бота.
3. Отправьте BotFather /setprivacy, выберите своего бота и выберите Disable. Так бот сможет читать в группах сообщения, которые начинаются с !.
4. В Lords Bot вставьте токен в поле Токен бота:, выберите Telegram и нажмите Подключиться.
5. Когда статус покажет Telegram Подключен (Telegram Connected), нажмите Добавить бота в Telegram (Add Bot to Telegram) и добавьте бота в свою группу.

Только для Telegram можно отметить Использовать прокси? (Use Proxy?) и выбрать один из ваших прокси для подключения чат-бота.

Привязка чата #

Команды работают только после того, как вы привяжете бота к одному чату:

1. В канале Discord или группе Telegram, которую хотите использовать, отправьте !set (или /set).
2. Бот ответит Группа успешно назначена! (Group assigned successfully!)

Чат, в который вы отправили set, теперь становится чатом чат-бота, а вы — его администратором. Команды чат-бота может использовать только администратор и только в этом чате. В Discord после отправки set команды также появляются на этом сервере как слэш-команды.

Администратор чат-бота (тот, кто отправил set) — не то же самое, что авторизованные пользователи банка гильдии. Их добавляют отдельно для каждого банка на вкладке Авторизованные пользователи (Authorized Users).

Чтобы перенести чат-бота в другой чат, отправьте /cleargroup в текущем чате или нажмите Очистить данные (Clear Data) на вкладке Чат Бот, а затем снова отправьте set в новом чате.

Другие кнопки на вкладке «Чат Бот» #

Элемент	Что делает
Отключить (Disconnect)	Отключает чат-бота.
Просмотр журнала (View Log)	Показывает журнал подключения чат-бота. Загляните в него, если статус пишет Что-то пошло не так, проверьте журнал (Something went wrong, check log).
Очистить данные	Забывает привязанный чат и администратора.
Сообщать о новых версиях в чат (Post new versions in chat)	Один раз публикует номер новой версии в чате, когда выходит обновление. По умолчанию: вкл.
Информационное поле	Показывает Идентификатор чата (Chat ID), Идентификатор администратора (Admin ID) и в Discord — Идентификатор гильдии (Guild ID, ваш сервер).

Если чат-бот не может подключиться, он пробует снова через 15 секунд и затем каждый раз ждёт дольше, вплоть до раза в 5 минут. Неверный токен или выключенный Message Content Intent в Discord вместо этого останавливают его с ошибкой.

Команды #

Эти команды может использовать только администратор чат-бота в чате, привязанном через set. Команды могут начинаться с /, ! или ,. В Discord они также работают как слэш-команды, а поле аккаунта подсказывает имена аккаунтов по мере ввода.

В Discord слеш-команды видны только участникам сервера с правом Управлять сервером (Manage Server). Чтобы показать их другой роли, откройте Настройки сервера > Интеграции (Server Settings > Integrations), выберите своего бота и разрешите эту роль. Поле аккаунта находит любую часть имени или начало IGG ID и показывает, запущен ли аккаунт. Если команду нельзя использовать, ответ видите только вы.

В Telegram нажмите кнопку меню / рядом с полем сообщения, чтобы выбрать команду. Если отправить /start, /stop, /restart, /info, /log или /shortlog без аккаунта, бот ответит кнопкой для каждого аккаунта; нажмите на одну, чтобы выполнить команду для этого аккаунта.

Если командой пользуется кто-то, кроме администратора, бот отвечает Вы не уполномочены использовать эту команду (You are not authorized to use that command). В любом другом чате он отвечает Команды администратора можно использовать только в чате, где был использован /Set. (Admin Commands can only be used in the chat where: /Set was used.) Исключение — /setcastle: администратор может использовать её в любом чате, где есть бот.

Банк гильдии в чате #

Банк гильдии может отвечать на команды в любом канале Discord или группе Telegram, где есть ваш чат-бот, а не только в чате администратора. Повторите эти шаги для каждого банка.

Добавление банка в чат (администратор) #

В групповом чате отправьте /setcastle и имя или IGG ID аккаунта банка, например /setcastle MyBank. Бот ответит Учетная запись привязана к чату (Account Assigned to Chat). Чтобы убрать банк, отправьте /unsetcastle MyBank в чате администратора чат-бота.

Регистрация пользователя банка (каждый игрок) #

Каждый игрок один раз связывает свой аккаунт Discord или Telegram со своим игровым ником:

1. В групповом чате отправьте команду банка, например !bal. (Используйте префикс банка, если он отличается от !.)
2. Бот ответит Пожалуйста, отправьте банку: (Please send the bank:) и командой вроде !reguser 123456789.
3. Отправьте именно эту команду банку в игре — в чат гильдии или почтой. Банк ответит Зарегистрированный социальный аккаунт (Social account registered).
4. Снова отправьте !bal в групповой чат. Вы получите свой баланс.

Теперь из чата можно использовать любую команду банка, доступную вашему рангу. Чтобы отвязать аккаунт, отправьте !unreguser банку в игре. Полный список — в разделе Команды банка гильдии.

Примечание: сначала проверяются команды чат-бота. Команда банка с тем же названием, что и команда чат-бота, например !stop, в чате считается командой чат-бота. Такие команды банка отправляйте в игре.

Оповещения об аккаунтах #

Чат-бот может публиковать оповещения об аккаунтах в чате администратора. Они включаются для каждого аккаунта отдельно: откройте окно аккаунта и перейдите в Настройки > Общие настройки > Специальные (Settings > General > Advanced), затем в группу Чат-бот (Chat Bot). Чтобы настроить много аккаунтов сразу, используйте Глобальные настройки или шаблон.

Параметр	Что публикует
Публиковать статус в чат-боте (Post Status in Chatbot)	Включает оповещения чат-бота для этого аккаунта.
Истечение срока действия ключа доступа (Access Key Expiry)	Когда ключ доступа истекает, обновляется или не может обновиться.
Изменение статуса подключения (Connection Status Change)	Когда аккаунт уходит в офлайн (один раз за отключение), когда он возвращается, и при первом подключении после того, как вы его запустили.
Только после офлайна (мин) (Only after offline for (min))	Больше 0: ждёт столько минут, прежде чем сообщить, что аккаунт офлайн; переподключение за это время ничего не публикует. 0 публикует сразу.
Кто-то подключился к аккаунту (Other Login)	Когда в аккаунт входит кто-то другой.
Статус расписания (Schedule Status)	Когда начинается и заканчивается отдых по расписанию и когда аккаунт входит во время отдыха, чтобы проверить задачи.
Ограничение RSS приближается (Nearing RSS limit)	Когда еда, камень, дерево, руда или золото достигают 4 миллиардов — это близко к лимиту игры.
Публиковать входящие сборы / атаки (Post incoming rallies / attacks)	Когда на замок идёт сбор или атака, с упоминанием администратора. Одно оповещение на атаку: следующее приходит, когда сторожевая башня очистится.
Загрузить статистику (Upload Stats)	Публикует отчёты статистики, которые сохраняет этот аккаунт (статистика подарков, список гильдии и статистика Поручений гильдии, включаются на странице «Гильдия»), файлами в чат, куда этот аккаунт добавлен через /setcastle. Пока вы этого не сделаете, ничего не публикуется. Когда параметр включён, команда банка !stats all, отправленная из этого чата, тоже загружает отчёт файлом. Глобальные настройки (Global Settings) и шаблоны его не меняют: включайте его на каждом аккаунте.

Пока включено Публиковать статус в чат-боте, некоторые оповещения публикуются всегда, например когда аккаунт забанен или заблокирован или когда достигнут лимит аккаунтов.

Оповещения, пришедшие одновременно, отправляются одним сообщением. Если у нескольких аккаунтов одно и то же оповещение, оно публикуется один раз со списком аккаунтов под ним.