Подключение CivBot к серверу¶

Администратор сервера подключает CivBot к серверу Discord: добавляет бота, задаёт канал истории игр, канал сбора игр и роль модератора. После этого модератор ставит панель игры, и игроки создают игры.

Что нужно¶

Право «Управлять сервером» — с ним добавляют бота на сервер и выполняют /guild config, которая задаёт каналы и роль модератора.
Право «Администратор» или роль модератора сервера — нужно что-то одно из двух, чтобы поставить панель игры командой /moderator panel. Владелец сервера сразу имеет все права Discord.
Ссылка-приглашение CivBot — по ней бота добавляют на сервер.
Два текстовых канала — один для карточек сборов, второй для тредов игр. Можно создать новые или взять существующие.
Доступ игроков к каналам — игроки видят канал, где стоит панель игры, канал сбора игр и канал истории игр. В треде игры они отправляют Steam-ссылку и завершают игру командой /игра завершить (/game finish); на сервере, с которым работает сайт CivBot, игрок игры может завершить её и на сайте — Завершение игры на сайте. Чтобы писать в треде игры, игрокам нужно право «Отправлять сообщения в ветках» в канале истории игр.

Права бота в каналах¶

Бот работает в нескольких каналах, и в каждом ему нужны свои права Discord. Дайте их до первой игры в настройках канала, на вкладке прав доступа.

Канал	Что там делает бот	Какие права нужны боту
Канал сбора игр	Отправляет и обновляет карточки сборов с эмодзи наций	«Просматривать канал», «Отправлять сообщения», «Встраивать ссылки», «Использовать внешние эмодзи»
Канал истории игр	Создаёт тред каждой игры, пишет в нём и убирает сообщение со Steam-ссылкой	«Просматривать канал», «Создавать публичные ветки», «Отправлять сообщения в ветках», «Встраивать ссылки», «Читать историю сообщений», «Управлять сообщениями», «Использовать внешние эмодзи»
Канал, где стоит панель игры	Ставит панель и каждые 5 мин обновляет список игр	«Просматривать канал», «Отправлять сообщения», «Читать историю сообщений»
Канал, где выполняют `/guild config`	Обновляет поля карточки настроек после выбора в меню	«Просматривать канал», «Встраивать ссылки», «Читать историю сообщений»

Сейв в треде игры действует на сервере, с которым работает сайт CivBot: игроки бросают файл сейва в тред игры, и бот ставит под сообщением реакции ⏳, а потом ✅ или ❌. Чтобы реакции появлялись, боту в канале истории игр нужно ещё право «Добавлять реакции». Подробнее — Сейв в треде игры.

Шаги¶

Добавьте бота на сервер. Откройте ссылку-приглашение CivBot и выберите свой сервер. Бот регистрирует сервер сам, отдельной команды для этого нет. Если бота когда-то удаляли, он возвращается с прежними настройками, рейтингами и нумерацией игр. Проверка: бот появился в списке участников сервера.
Подготовьте два канала. В канал сбора игр бот будет отправлять карточки сборов. В канале истории игр он будет создавать тред каждой игры после старта. Оба канала должны быть обычными текстовыми: меню настроек предлагает только такие. Дайте боту права из таблицы Права бота в каналах. Проверка: в правах обоих каналов для бота включено всё, что указано в таблице.
Откройте карточку настроек. Выполните /guild config в текстовом канале, где бот может просматривать канал и читать историю сообщений. Бот публикует английскую карточку «Configure your server!» с меню «Select what you want to configure ...» и кнопкой «Delete this message». Меню перестаёт отвечать через 3 мин без действий, тогда выполните команду ещё раз. Проверка: вверху карточки видно название вашего сервера, а в полях, которые ещё не заданы, стоит «Not set».
Задайте канал истории игр. В меню под карточкой выберите «Channels». Бот приватно отправит меню выбора каналов, которое исчезнет через 60 с. В меню «History channel...» выберите канал истории игр. Проверка: в поле «🏛️ Lobbies history channel:» на карточке появился выбранный канал.
Задайте канал сбора игр. В том же приватном сообщении, в меню «Active games channel...», выберите канал сбора игр. Если сообщение уже исчезло, снова выберите «Channels» под карточкой. Проверка: в поле «🚀 Lobbies active games channel:» появился выбранный канал.
Задайте роль модератора. В меню под карточкой выберите «Roles», а в приватном меню «Moderator role ...» — роль. Это меню тоже исчезает через 60 с. Модератором бот считает владельца сервера, участников с правом «Администратор» и всех, у кого есть эта роль. Участникам роль выдают так же, как любую другую роль Discord. Проверка: в поле «Moderator:» появилась выбранная роль.
Поставьте панель игры. Выполните /moderator panel в канале, где игроки будут создавать игры: для этого нужно право «Администратор» или роль модератора. Бот публикует панель с кнопками «FFA», «Duel», «Статистика игрока», «Информация» и списком последних игр, отдельного ответа на команду нет. Подробнее — Панель игры. Проверка: нажмите «Информация» на панели, и в приватной карточке будут строки «Канал истории игр: #…» и «Канал сбора игр: #…». Эту карточку бот пишет на языке вашего клиента Discord, поэтому в английском клиенте строки будут на английском.
Создайте пробный сбор. Нажмите «FFA» на панели. В приватном сообщении «Выберите тип игры» нажмите «Vanilla», «Patch» или «KEK». Проверка: в канале сбора игр появляется карточка сбора в состоянии «Сбор», а вы на ней — первый игрок.
Отмените пробный сбор. Нажмите 🗑️ на карточке сбора: сбор исчезнет, а номера игра не получит. Проверка: карточки сбора больше нет в канале сбора игр.

Что должно быть готово¶

Бот есть среди участников сервера
Канал сбора игр и канал истории игр — текстовые каналы, которые видят игроки
У бота есть права из таблицы «Права бота в каналах» в каждом его канале
На карточке /guild config заполнены поля «🏛️ Lobbies history channel:», «🚀 Lobbies active games channel:» и «Moderator:»
Роль модератора выдана тем, кто будет управлять играми
Панель игры стоит в канале, который видят игроки
«Информация» на панели показывает оба канала
Пробная карточка сбора появилась в канале сбора игр, а потом исчезла после 🗑️

Что ещё можно настроить¶

Таблица лидеров — модератор выполняет /leaderboard show в канале, где должна висеть таблица лидеров текущего сезона. Бот обновляет её каждый час, а новая команда убирает предыдущую таблицу. Боту в этом канале нужны «Просматривать канал», «Отправлять сообщения», «Встраивать ссылки», «Читать историю сообщений» и «Использовать внешние эмодзи». Проверка: бот отвечает «Leaderboard has been created!», а в канале появляется таблица «Топ игроков». Подробнее — Таблица лидеров.
Журнал событий — модератор выполняет /guild log_channel с параметром channel, и бот записывает туда события сборов и игр. Та же команда без параметра отключает журнал. Боту в этом канале нужны «Отправлять сообщения» и «Встраивать ссылки», иначе записи не поступают. Проверка: бот отвечает «Log channel set to #… successfully.», а когда кто-то создаёт игру на панели, в журнале появляется запись «🎮 Игра создана». Подробнее — Журнал событий.
Оповещение о сборе — чтобы участники игры могли звать новых игроков кнопкой «Оповестить о сборе» на карточке сбора, модератор выполняет /guild notifications configure с параметром channel. Необязательные параметры: cooldown_minutes — перерыв между оповещениями одной игры, 3–60 мин, по умолчанию 15 мин; role — роль, которую упоминает бот; restricted_role — роль, с которой нельзя отправлять оповещения. Проверка: бот отвечает «Оповещения о сборе настроены.», а /guild notifications status показывает «Готов». Подробнее — Настройка оповещений о сборе.
Язык бота — карточки сборов, панель и журнал бот пишет на основном языке сервера; его меняют в настройках сообщества сервера Discord. Поддерживаются украинский, русский и английский, для других языков бот пишет по-английски. Приватные ответы панели игры бот пишет на языке клиента Discord того, кто нажал кнопку. Надписи кнопок панели остаются на языке, который был при /moderator panel, поэтому после смены языка поставьте панель заново. Подробнее — Язык бота.

Поля карточки настроек¶

Поля «🏛️ Lobbies history channel:», «🚀 Lobbies active games channel:» и «Moderator:» задают шаги 4–6. Ещё четыре поля карточки описаны в таблице.

Поле	Что показывает	Как задать
«Steam Game (ID) for manage SteamLinks:»	Игру Steam с её номером; по умолчанию — Civilization V. Поле не меняет того, как бот читает Steam-ссылки: он всегда принимает ссылки `steam://joinlobby/…` игры Civilization V	Модератор выполняет `/guild steam_game_id` с параметром `game_id`; бот отвечает «Done ✅» или «Failed ❌»
«🏆 Lobbies leaderboard channel:»	Канал таблицы лидеров; «Not set», если таблицу не ставили	Команда `/leaderboard show` в нужном канале
«Autobans:»	Список наций, который бот задаёт серверу при регистрации; на баны в играх сервера он не влияет	В меню настроек пункта для него нет
«Autobans count:»	Число из настроек сервера (по умолчанию 2); на количество банов в игре не влияет	В меню настроек пункта для него нет. Лимиты банов задаёт тип игры, см. Создание игры

Что может пойти не так¶

«Информация» на панели отвечает «History channel is not set». На сервере не задан канал истории игр. Задайте его в /guild config → «Channels» → «History channel...».
У карточки /guild config заголовок «Guild not configured». Бот ещё не зарегистрировал сервер. Он делает это, когда его добавляют, а если бот тогда не работал — при следующем запуске. Подождите несколько минут и выполните команду ещё раз.
/guild config отвечает «You don't have permissions to do that!». Для этой команды нужно право Discord «Управлять сервером». Этот ответ исчезает через 3 с.
/moderator panel отвечает «Moderator role not set. Please contact server administrator.» или «You are not moderator.». У вас нет ни права «Администратор», ни роли модератора. Задайте роль модератора в /guild config и выдайте её тому, кто будет ставить панель.

См. также¶

Эта страница переведена с помощью ИИ и сверена с терминами бота.