Чат-бот (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 нужен этот доступ, чтобы читать команды. Сохраните изменения.
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).
Очистить данные	Забывает привязанный чат и администратора.
Информационное поле	Показывает Идентификатор чата (Chat ID), Идентификатор администратора (Admin ID) и в Discord — Идентификатор гильдии (Guild ID, ваш сервер).

Команды #

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

Если командой пользуется кто-то, кроме администратора, бот отвечает Вы не уполномочены использовать эту команду (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)	Когда аккаунт подключается, переподключается или отключается.
Кто-то подключился к аккаунту (Other Login)	Когда в аккаунт входит кто-то другой.
Статус расписания (Schedule Status)	Когда начинается и заканчивается отдых по расписанию и когда аккаунт входит во время отдыха, чтобы проверить задачи.
Ограничение RSS приближается (Nearing RSS limit)	Когда еда, камень, дерево, руда или золото достигают 4 миллиардов — это близко к лимиту игры.
Загрузить статистику (Upload Stats)	Публикует отчёты статистики, которые сохраняет этот аккаунт (статистика подарков, список гильдии и статистика Праздника гильдии, включаются на странице «Гильдия»), файлами в чат, куда этот аккаунт добавлен через /setcastle. Пока вы этого не сделаете, ничего не публикуется. Когда параметр включён, команда банка !stats all, отправленная из этого чата, тоже загружает отчёт файлом.

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