WardenCoredocs
Discord-бот

Пересылка логов

Пересылка игровых событий в каналы Discord

В активной разработке

Пересылка логов находится в активной разработке. Новые типы событий и улучшения форматирования добавляются регулярно. Если вы заметите неточности или некорректные данные в пересылаемых логах, пожалуйста, сообщите разработчику.

WardenCore может автоматически пересылать игровые события в каналы Discord в реальном времени. Каждый раз, когда игрок убивает другого игрока, входит на сервер, открывает сундук или совершает любое отслеживаемое действие, бот публикует отформатированный embed в назначенном канале Discord.

Настройка пересылки логов

Откройте настройки пересылки логов

В панели WardenCore перейдите в Settings > Discord > Log Channels.

Выберите каналы

Для каждого типа событий выберите канал Discord из выпадающего списка. Оставьте невыбранным, чтобы отключить пересылку для этого типа событий.

Используйте отдельный канал для каждого типа событий. Отправка нескольких типов событий в один канал приводит к превышению лимитов Discord и может сделать бота нестабильным.

Сохраните

Нажмите Save. Пересылка событий начнётся немедленно. Бот группирует embed-сообщения для соблюдения лимитов Discord (до 10 embed в одном сообщении, отправка каждые 5 секунд).

Совет: используйте отдельные каналы

Создайте выделенные каналы Discord для разных типов логов -- например, #pvp-kills, #admin-log, #chat-log, #login-log. Это помогает поддерживать порядок и упрощает поиск конкретных событий.

Доступные типы событий

Основные

КаналОписание
Chat (Public)Глобальные сообщения чата
Chat (All)Все сообщения чата (глобальный, локальный, отрядный, админский)
Kills (PvP)Убийства игрок против игрока
Kills (PvE)Смерти от окружения и ИИ
LoginВход и выход игроков
AdminВыполнение админ-команд
Admin (Public)Публичные административные объявления
Admin AlertsОповещения о подозрительной активности
New PlayerУведомления о первом входе нового игрока
Bot CommandsКанал для ввода и ответов на команды бота

Экономика

КаналОписание
TradeТорговля между игроками
BankБанкоматы и банковские операции

События

КаналОписание
ChestВзаимодействия с сундуками
RaidРейды на базы
VehicleЗахват и использование транспорта
SquadСоздание, вступление, выход из отряда
QuestМиссии и задания
Name ChangeСмена имени игрока
ViolationsНарушения с летающим транспортом (кики и баны отображаются в канале Login)
Fame PointsИзменения очков славы
SentryСобытия турелей

Геймплей

КаналОписание
LockpickingВзлом игровых замков
Lockpicking (World)Взлом мировых замков
DialpadПопытки ввода кода на панели
Dial LockВзаимодействия с кодовыми замками
Lock BombПодрыв замков
Bomb DefusalПопытки обезвреживания бомб
BunkerМини-игра в бункере
PuzzleЛоги решения головоломок
TrapУстановка и срабатывание ловушек
ExplosiveЛоги использования взрывчатки
Chest BuryЗакапывание сундуков
Base FlagВзаимодействия с флагами базы
Bunker LockСтатус активации бункера

Как выглядят embed логов

Каждый тип событий генерирует отформатированный embed в Discord с соответствующими деталями. Например:

  • Embed PvP-убийств содержат убийцу, жертву, оружие, дистанцию и миниатюру карты с местом события
  • Embed входов показывают имя игрока, Steam ID и IP-адрес

Конфиденциальность

Embed входов содержат IP-адреса игроков (персональные данные). Рекомендуется ограничить доступ к каналу логов входов только для администраторов и модераторов.

  • Embed торговли группируют несколько предметов одной торговой сессии в один embed с итогами

Производительность пересылки логов

WardenCore группирует embed логов для соблюдения лимитов Discord:

  • Embed группируются по каналам и отправляются каждые 5 секунд
  • До 10 embed отправляются в одном сообщении (максимум Discord)
  • Буфер из 500 записей предотвращает проблемы с памятью в периоды высокой активности
  • При переполнении буфера самые старые записи удаляются

Это означает, что во время интенсивной активности (например, крупного PvP-сражения) может быть небольшая задержка перед появлением всех событий в Discord. В обычных условиях события появляются в течение нескольких секунд.

Частые проблемы

Логи не появляются в Discord

  • Убедитесь, что канал выбран для нужного типа событий в панели
  • Проверьте, что у бота есть права на отправку сообщений в целевой канал

Задержка логов

Небольшая задержка нормальна. Embed группируются каждые 5 секунд, и у Discord есть лимиты запросов. При очень высокой активности задержки могут быть немного больше. Это сделано намеренно, чтобы не превышать лимиты API Discord.

Слишком много сообщений

Если канал перегружен, рассмотрите возможность отключения менее важных типов событий или распределения событий по большему количеству каналов. Например, PvE-убийства на загруженном сервере могут генерировать много трафика -- можно отключить пересылку PvE или направить её в менее приоритетный канал.

Пропущенные события после перезапуска сервера

События, произошедшие, пока бот был офлайн, не пересылаются задним числом. Пересылка логов захватывает только события в реальном времени. Исторические данные всегда доступны в просмотрщике логов панели WardenCore.

Содержание