Журнал событий¶

Журнал событий — канал сервера, куда CivBot записывает действия игроков и модераторов в сборах и играх. Включает его модератор, а читают, чтобы выяснить, кто кого выгнал, кто отменил сбор или прервал игру.

Что нужно¶

Перед началом нужны четыре вещи:

Права модератора — журнал включает владелец сервера, участник с правом Discord «Администратор» или с ролью модератора сервера; подробнее — Игроки, модераторы и администраторы.
Канал — текстовый канал сервера для журнала; доступ к нему задают права канала в Discord, а бот их не меняет.
Права бота — в канале журнала боту нужны права «Просматривать канал», «Отправлять сообщения» и «Встраивать ссылки».
Панель игры — на сервере уже стоит панель игры: на ней создают пробную игру в шаге 3; подробнее — Панель игры.

Шаги¶

Подготовьте канал. Создайте текстовый канал для журнала или выберите существующий. В настройках канала дайте боту права «Просматривать канал», «Отправлять сообщения» и «Встраивать ссылки». Проверка: бот есть в списке участников этого канала. Сможет ли бот туда писать, покажет шаг 3.
Включите журнал. В любом канале сервера наберите /guild log_channel и в параметре channel выберите канал журнала, например /guild log_channel channel:#журнал-событий. Проверка: бот приватно отвечает «Log channel set to #журнал-событий successfully.»
Проверьте первую запись. Сама команда в журнал ничего не пишет: записи появляются вместе с событиями. Создайте игру на панели игры и сразу отмените сбор кнопкой 🗑️ на карточке сбора. Проверка: в журнале появляются записи «🎮 Игра создана» и «🗑️ [Сбор] Игра отменена».

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

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

Чтобы отключить журнал, выполните /guild log_channel без параметра channel. Бот приватно ответит «Log channel cleared successfully.» Новых записей больше не будет, а уже отправленные останутся в канале.

Что записывает бот¶

Бот записывает в журнал восемь видов событий. Каждое событие — отдельное сообщение в канале журнала.

Событие	Когда появляется	Что в записи
«🎮 Игра создана»	Игрок создал игру на панели игры	«@Orion создал игру», где «игру» — ссылка на карточку сбора; тип и режим игры
«➕ Игрок присоединился»	Игрок записался в сбор	Кто присоединился, список «Были в лобби (2):», если в сборе уже кто-то был, и строка «Всего: 3»
«🚪 Игрок вышел»	Игрок вышел из сбора	Кто вышел, список «Остались (2):», если в сборе кто-то остался, и строка «Всего: 2»
«❌ Игрок выгнан»	Участник игры или модератор выгнал игрока кнопкой «Выгнать»	Кто кого выгнал: «@Orion выгнал @Kai»
«🗑️ [Сбор] Игра отменена»	Участник игры или модератор отменил сбор кнопкой 🗑️	Кто отменил сбор: «@Orion отменил игру»
«🗑️ [Игра #248] Игра отменена»	Участник игры или модератор прервал игру кнопкой «Отменить игру» в треде игры	Кто прервал игру, и строка «Причина: …», если причину указали
«🔄 Обмен слотами»	Два игрока FFA обменялись слотами по взаимному запросу	«@Orion и @Vega обменялись слотами» и ссылка «Перейти к игре» на карточку игры
«📣 Оповещение о сборе»	Участник игры или модератор отправил оповещение кнопкой «Оповестить о сборе»	Кто отправил, строка вроде «Patch FFA6 · 4/6», «Канал: #…» и ссылка «Перейти к игре» на карточку сбора

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

Журнал бот пишет на основном языке сервера в Discord: на украинском, русском или английском. Если основной язык сервера другой, журнал ведётся на английском. Подробнее — Язык бота.

Структура записи¶

Записи составлены по одному образцу:

Время — первая строка под заголовком, с точностью до секунды. Внизу записи стоит ещё и дата со временем. И то и другое Discord показывает в вашем часовом поясе.
Кто что сделал — основная строка с упоминаниями игроков; упоминания в журнале никого не оповещают.
Игра — последняя строка: тип и режим заглавными буквами и создатель игры, например «PATCH FFA | Создатель: @Orion».
Цвет полосы — зелёный для создания игры и входа, оранжевый для выхода, красный для изгнания и отмены, синий для обмена слотами и оповещения.
Аватар — справа вверху: того, кто выполнил действие, а в записи об изгнании — изгнанного игрока; у записи об обмене слотами аватара нет.

Номер игра получает при старте, поэтому в записях о сборе его нет. В записях о стартовавшей игре номер стоит в начале последней строки: «Игра #248 • PATCH FFA | Создатель: @Orion». В записи «🎮 Игра создана» последняя строка содержит только тип и режим, без создателя: он назван в основной строке. Запись «📣 Оповещение о сборе» вместо строки с создателем содержит строку вроде «Patch FFA6 · 4/6»: тип игры, режим и наибольшее число игроков в нём (FFA6 — FFA до 6 игроков), а дальше — сколько игроков уже записалось (4 из 6).

Чего нет в журнале¶

Журнал содержит только события из раздела Что записывает бот. Бот не записывает туда:

старт игры, с драфтом или без;
завершение игры командой /игра завершить (/game finish) или на сайте;
сбор, который исчез сам, потому что 3 часа никто не нажимал его кнопки;
готовность, баны, выбор наций и Steam-ссылки;
обновление игры командой /игра обновить (/game refresh).

Стартовавшую игру ищите по треду в канале истории игр: на карточке игры в треде написано её состояние — «В процессе», «Завершена» или «Прервана». Подробнее — Тред игры.

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

В журнале пусто. Сама команда /guild log_channel в журнал ничего не пишет: первая запись появляется с первым событием, например при создании игры. Если игры уже создавали, а записей нет, боту не хватает в канале журнала права «Просматривать канал», «Отправлять сообщения» или «Встраивать ссылки». Дайте боту эти права в настройках канала. Команду повторять не нужно: записи появятся со следующего события.
Записи вдруг перестали появляться. Канал журнала удалили, у бота забрали в нём права, или кто-то отключил журнал командой без параметра channel. Верните боту права или выполните /guild log_channel с нужным каналом.
Бот отвечает «Moderator role not set. Please contact server administrator.» На сервере не задана роль модератора, а у вас нет права «Администратор». Попросите администратора сервера задать роль модератора и выдать её вам. Подробнее — Игроки, модераторы и администраторы.
Бот отвечает «You are not moderator.» Роль модератора на сервере задана, но у вас её нет, как и права «Администратор». Попросите администратора сервера выдать вам эту роль.
Сбор пропал, а записи об отмене нет. Если игра стартовала, ищите её тред в канале истории игр: старт в журнал не пишется. Сбор, в котором 3 часа никто не нажимал кнопок, бот убирает сам и в журнал этого тоже не пишет. Запись «🗑️ [Сбор] Игра отменена» появляется, только когда сбор отменяют кнопкой 🗑️.
В журнале нет старта или завершения игры. Эти события бот в журнал не записывает. Ищите тред игры в канале истории игр.
Записи на английском или другом языке. Журнал ведётся на основном языке сервера в Discord, а не на языке вашего клиента. Подробнее — Язык бота.

См. также¶

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