Команды бота¶

Команды CivBot, сгруппированные по тому, кто ими пользуется: игроки, модераторы и администраторы сервера. Рядом с каждой командой — что она делает, какие у неё параметры и кто может её выполнить.

Как выполнять команды¶

Наберите «/» в поле сообщения на сервере, и Discord покажет команды CivBot. Выберите команду, и Discord подскажет её параметры. Выберите параметр, и Discord сам допишет его название с двоеточием: вам останется ввести значение, например ходы:212.

Команды выполняют на сервере, где работает CivBot, а не в личных сообщениях боту. Каждая команда работает с играми, игроками и настройками именно этого сервера.

Большинство ответов бот отправляет приватно: их видите только вы. Часть отказов исчезает сама через 3–20 с. Для всех в канале бот публикует панель игры, таблицы лидеров из /leaderboard show и /leaderboard season, карточку /stats show и карточку настроек /guild config.

Русские названия есть только у группы /игра и пункта меню «Профиль на сайте». В русском клиенте Discord команды группы называются /игра завершить (/game finish) и /игра обновить (/game refresh). Их параметры тоже русские: победитель, тип_победы, ходы и игра. У остальных команд и параметров только английские названия. Подсказки к /gametime, /leaderboard season и /search games_by_players Discord показывает на русском. Подробнее — Язык бота.

Команды для игроков¶

Эти команды может выполнить любой участник сервера. Исключение — /игра завершить: результат игры записывает её участник или модератор.

Команда	Что делает	Что указать
`/игра завершить` (`/game finish`)	Записывает победителя, тип победы и количество ходов: игра получает состояние «Завершена», а в FFA меняется рейтинг; выполняет участник игры или модератор	`победитель`, `тип_победы`, `ходы`; вне треда игры ещё `игра`
`/игра обновить` (`/game refresh`)	Перерисовывает карточку игры в треде по последним данным; саму игру не меняет	`игра` — только вне треда игры
`/stats show`	Публикует в канале карточку статистики игрока на языке сервера	`user` — чья статистика; без него — ваша
Пункт «Show Stats»	Приватно показывает карточку статистики игрока на языке вашего Discord	—
Пункт «Профиль на сайте»	Приватно даёт кнопку-ссылку на профиль игрока на сайте	—
`/nations stats`	Показывает, сколько раз каждую нацию банили и выбирали в играх сервера, где баны ставили не меньше 3 игроков	`period`, `status`, `private`
`/gametime`	Рисует тепловую карту: в какие дни недели и часы стартуют игры сервера	`timezone`, `is_private`, `force_update`
`/search games_by_players`	Показывает игры сервера, в которых вместе играли все указанные игроки	`player1`, `player2`, `player3`…`player6`, `private`

Завершение и обновление игры¶

В треде игры обе команды сами определяют, о какой игре идёт речь. Вне треда номер игры указывают в параметре игра. Номер виден в названии треда, например «248 — FFA 6 Patch».

Команда /игра завершить завершает только игру в состоянии «В процессе», и только когда у каждого игрока выбрана нация или сайт прочитал её из сейва. Победителем может быть только игрок этой игры.

Игру можно завершить и на сайте кнопкой «Завершить игру»; это может сделать только участник игры, а результат и рейтинг те же. Подробнее — Завершение игры на сайте.

Параметр	Что указать
`победитель`	Игрока этой игры, который победил
`тип_победы`	Один тип из списка: «Туристическая 🎨», «Научная 🧪», «Дипломатическая 🕊️», «Военная 🗡️» или «Признание победителя 🤝»
`ходы`	Количество ходов партии, целое число от 1 до 330
`игра`	Номер игры; нужен только вне треда игры

/игра завершить победитель:@Orion тип_победы:Научная ходы:212

Игра получает состояние «Завершена» сразу: подтверждения других игроков бот не просит. На /игра завершить бот приватно отвечает «Done!», а на /игра обновить — «Обновлено». После завершения игры без сейва бот один раз оставляет в треде напоминание «Сохраните историю этой игры» с кнопкой «На сайте»; это действует на сервере, с которым работает сайт CivBot. Подробнее — Завершение игры, Тред игры, Сейв в треде игры.

Статистика игрока¶

Карточку из /stats show видят все в канале. Переключить на ней вкладку или период может каждый, кто её видит. Пункт «Show Stats» показывает такую же карточку только вам. Его открывают в меню приложений, щёлкнув правой кнопкой мыши по игроку. Кнопки карточки отключаются после 3 мин без нажатий. Подробнее — Статистика игрока.

Профиль на сайте¶

Это действует на сервере, с которым работает сайт CivBot. В меню приложений щёлкните правой кнопкой мыши по игроку и выберите «Профиль на сайте»: бот приватно упомянет игрока и даст кнопку «🌐 Профиль на сайте». Она открывает Профиль игрока этого игрока, а вход на сайт идёт через Discord. Если игрока бот ещё не знает, он отвечает «У этого игрока ещё нет игр на сайте.». На другом сервере ответ — «Сайт не показывает игры этого сервера.».

Поиск игр по игрокам¶

Команда /search games_by_players ищет игры сервера, в которых играли вместе все указанные игроки. Обязательны player1 и player2, до четырёх других добавьте в player3…player6. По умолчанию ответ приватный; чтобы показать его всем в канале, добавьте private:False. Результат бот показывает страницами с кнопками листания, которые отключаются после 3 мин без нажатий. Тексты ответов на русском: «Игры с участием указанных игроков не найдены». На сайте похожий поиск дают Игры на сайте и поиск в верхней панели.

/search games_by_players player1:@Orion player2:@Vega

Статистика наций и время игр¶

Эти две команды по умолчанию отвечают приватно. Чтобы показать ответ всем в канале, добавьте private:False, а для /gametime — is_private:False.

Команда /nations stats считает только игры, которые стартовали за выбранный период и в которых баны ставили не меньше 3 разных игроков. Поэтому игр Duel в этой статистике нет. Без параметров команда берёт такие завершённые игры за последние 30 дней.

Период задаёт параметр period:

period:week — 7 дней;
period:month — 30 дней;
period:season — 90 дней, а не сезон рейтинга;
period:year — 365 дней;
period:all — все игры.

Параметр status:active показывает игры в состоянии «В процессе».

Команда /gametime рисует карту по киевскому времени. Другой пояс выберите в параметре timezone: начните набирать название города на английском, и Discord предложит подходящие пояса. Например, с timezone:Europe/Berlin карта будет по берлинскому времени. Числа для карты бот обновляет не чаще чем раз в час, а force_update:True обновляет их сразу. Подробнее — Статистика наций и время игр.

Команды для модераторов¶

Эти команды выполняет только модератор: владелец сервера, участник с правом Discord «Администратор» или с ролью модератора сервера. Роль модератора задаёт администратор сервера командой /guild config. Подробнее — Игроки, модераторы и администраторы.

Команда	Что делает	Что указать
`/moderator panel`	Ставит в текущем канале панель игры: список последних игр и кнопки «FFA», «Duel», «Статистика игрока», «Информация»	—
`/leaderboard show`	Публикует в текущем канале таблицу лидеров текущего сезона, которую бот обновляет каждый час	—
`/leaderboard season`	Публикует в текущем канале таблицу лидеров указанного или предыдущего сезона, которую бот не обновляет	`season_id` — номер сезона; без него бот берёт предыдущий сезон
`/season list`	Приватно показывает список сезонов: до 10 сезонов с пометкой «🟢 Active» или «⚫ Closed», номером и датами	—
`/season info`	Приватно показывает карточку активного сезона: «Status», «Начало», «Продолжительность» в днях и номер сезона	—
`/guild steam_game_id`	Задаёт Steam Game ID сервера; бот отвечает «Done ✅» или «Failed ❌», а выбранное значение видно на карточке из `/guild config`	`game_id` — один из списка: Civilization V или Spacewar
`/guild log_channel`	Включает журнал событий в указанном канале или выключает его	`channel` — канал журнала; без него журнал выключается
`/guild notifications configure`	Включает оповещения о сборе и задаёт их настройки	`channel`, `cooldown_minutes`, `role`, `restricted_role`
`/guild notifications status`	Приватно показывает настройки оповещений и то, готов ли бот их отправлять	—
`/guild notifications disable`	Выключает оповещения о сборе	—

Панель игры и таблица лидеров¶

Панель игры и таблица лидеров появляются в канале, где выполнили команду. Бот обновляет на сервере только одну панель игры и одну таблицу лидеров. Повторная команда /moderator panel или /leaderboard show удаляет прежнее сообщение, даже если оно в другом канале. Так панель или таблицу переносят в другой канал.

На /moderator panel бот отдельно не отвечает: в канале просто появляется панель. Список игр на ней бот обновляет каждые 5 мин, а также сразу после старта, завершения или прерывания игры. На /leaderboard show бот приватно отвечает «Leaderboard has been created!».

Команда /leaderboard season не меняет ни канал таблицы лидеров, ни таблицу текущего сезона. Номер сезона для её параметра season_id покажет /season list. Начинает и закрывает сезон только владелец бота, потому что сезон общий для всех серверов. Подробнее — Панель игры, Таблица лидеров, Сезоны.

Журнал событий и оповещения о сборе¶

Команда /guild log_channel с параметром channel включает журнал событий в этом канале. Бот приватно отвечает «Log channel set to #… successfully.» Та же команда без параметра выключает журнал, и бот отвечает «Log channel cleared successfully.»

Команда /guild notifications configure каждый раз задаёт все настройки оповещений заново:

Параметр	Что задаёт	Что будет без него
`channel`	Текстовый канал для оповещений	Discord не даст отправить команду
`cooldown_minutes`	Перерыв между оповещениями одной игры, от 3 до 60 мин	15 мин
`role`	Роль, которую бот упоминает над оповещением	Роль для оповещений снимается
`restricted_role`	Роль, обладатели которой не могут отправлять оповещения	Ограничивающая роль снимается

/guild notifications configure channel:#поиск-игры cooldown_minutes:20 role:@Игроки

Чтобы изменить один параметр, сначала посмотрите остальные командой /guild notifications status. Потом укажите их в /guild notifications configure ещё раз: параметр, которого вы не указали, бот сбрасывает, как показано в таблице. Подробнее — Журнал событий, Настройка оповещений о сборе.

Команды для администраторов сервера¶

Администратор сервера — участник с правом Discord «Управлять сервером». Владелец сервера и участники с правом «Администратор» имеют это право автоматически.

Команда	Что делает	Что указать
`/guild config`	Публикует в канале англоязычную карточку настроек сервера с меню «Select what you want to configure ...»	—

Пункт «Channels» задаёт канал истории игр (меню «History channel...») и канал сбора игр (меню «Active games channel...»). Пункт «Roles» задаёт роль модератора (меню «Moderator role ...»). Эти меню бот отправляет приватно, и они исчезают через 60 с.

Право «Управлять сервером» само по себе модератором не делает. Чтобы ставить панель игры и таблицу лидеров, нужно право «Администратор» или роль модератора. Подробнее — Подключение CivBot к серверу.

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

Команды /game нет в списке. В русском клиенте Discord эта группа называется /игра. Наберите /игра и выберите /игра завершить или /игра обновить.
Бот пишет «Moderator role not set. Please contact server administrator.» Так отвечают /moderator panel, /guild log_channel и /guild steam_game_id, когда на сервере не задана роль модератора, а у вас нет права «Администратор». Попросите администратора сервера задать роль модератора и выдать её вам.
Бот пишет «You are not moderator.» Роль модератора на сервере задана, но у вас её нет, как и права «Администратор». Попросите администратора сервера выдать вам роль модератора.
Бот пишет «You must be a moderator to use this command.» Команды /leaderboard show, /leaderboard season, /season list и /season info выполняет только модератор. Попросите модератора сервера.
Команда оповещений отвечает «У вас нет доступа к этому действию.» Команды /guild notifications выполняет только модератор. Попросите администратора сервера выдать вам роль модератора.
Бот не выполняет /guild config и пишет «You don't have permissions to do that!» Этот приватный ответ исчезает через 3 с. Для /guild config нужно право Discord «Управлять сервером». Попросите администратора сервера.
/leaderboard season отвечает «Предыдущие сезоны не найдены». Прошлых сезонов ещё нет. Таблицу текущего сезона публикует /leaderboard show.
/игра завершить отвечает «You are not in this lobby.» В параметре игра указан номер игры, в которой вы не играете, а вы не модератор. Проверьте номер в названии треда игры.
/игра завершить отвечает «Game ID not found.» Команда выполнена вне треда игры без параметра игра. Выполните её в треде игры или укажите номер игры.
/игра завершить отвечает «Can't do this command in current lobby state.» Игра с номером в параметре игра не в состоянии «В процессе»: её уже завершили или прервали, либо такого номера нет. Проверьте номер в названии треда игры.
/игра завершить отвечает «Game was already finished by another player or not found. Please refresh to see results.» Игру уже завершили или прервали, например, пока вы набирали команду. Её состояние видно на карточке игры в треде.
/игра завершить отвечает «Все игроки должны выбрать нации перед завершением игры!» У кого-то из игроков ещё не выбрана нация, и сайт не прочитал её из сейва. Выберите её в треде игры или на сайте и повторите команду.
/игра завершить отвечает «Победитель должен быть игроком этой игры.» В параметре победитель указан тот, кто не играет в этой игре. Выберите игрока из карточки игры.
/игра обновить отвечает «Укажите game_id или вызовите команду из треда игры». Команда выполнена вне треда игры без номера. Добавьте параметр игра или выполните команду в треде игры.
«Профиль на сайте» отвечает «Сайт не показывает игры этого сервера.» Этот пункт действует только на сервере, с которым работает сайт CivBot.
«Профиль на сайте» отвечает «У этого игрока ещё нет игр на сайте.» Бот ещё не знает этого игрока; профиль появится, когда он сыграет.
/search games_by_players отвечает «Необходимо указать минимум двух игроков». Указан один игрок или дважды один и тот же. Выберите не меньше двух разных.
Discord не принимает число в параметре. Параметр ходы принимает целое число от 1 до 330, а cooldown_minutes — от 3 до 60.
Надпись на русском. Команда /gametime отвечает на русском при любом языке сервера. Шапка таблицы лидеров («Топ игроков») тоже всегда русская. Подробнее — Язык бота.

См. также¶

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