CCLogger: Полное логирование действий игроков на Paper

CCLogger: Полное логирование действий игроков на Paper серверах

Контроль над происходящим на сервере Minecraft — задача не из лёгких. Игроки общаются, выполняют команды, заходят и выходят, а администратору нужно понимать, кто, когда и что сделал. Плагин CCLogger создан именно для этого: он записывает каждое действие в удобное хранилище, позволяя в любой момент восстановить полную картину событий. Никакой магии — только асинхронная запись, гибкие форматы и мощный поиск.

Какие события попадают в лог

CCLogger фиксирует три ключевые категории активности. Во-первых, все сообщения чата — с временной меткой, названием мира и точными координатами отправителя. Во-вторых, любые команды, введённые игроками или консолью. Для конфиденциальных команд вроде /login или /register можно настроить чёрный список, чтобы пароли случайно не сохранялись в открытом виде. В-третьих, события подключения: вход, выход и кик. Таким образом, у вас под рукой оказывается полная хроника жизни сервера.

Гибкие хранилища: от простого файла до Redis

Одно из главных преимуществ CCLogger — поддержка сразу пяти бэкендов для хранения логов. Выбор зависит от масштаба проекта и личных предпочтений:

• File — обычные текстовые файлы. Идеально для небольших серверов, не требует настройки, всё читается глазами.
• SQLite — локальная база данных. Тоже без лишних телодвижений, но уже позволяет делать SQL-запросы для анализа.
• MySQL — привычная реляционная СУБД. Подходит для сетей серверов, где нужен общий доступ к логам.
• MongoDB — документоориентированное хранилище, которое легко масштабируется горизонтально. Оцените, если объём данных быстро растёт.
• Redis — сверхбыстрая in-memory база. Хороша при высокой нагрузке, когда важна мгновенная запись.

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

Приватность и соответствие GDPR

Современные реалии требуют аккуратного обращения с IP-адресами. CCLogger предлагает четыре режима логирования IP, чтобы вы могли соблюсти нормы конфиденциальности:

• disabled — IP не сохраняются вовсе.
• truncated — последний октет обнуляется (192.168.1.42 становится 192.168.1.0).
• hashed — bcrypt-хеш с ежедневно меняющейся солью. Обратимое восстановление невозможно, но можно сравнивать хеши.
• full — полный адрес, если законодательство не запрещает.

Такой подход позволяет гибко настроить уровень детализации под свою юрисдикцию, не жертвуя безопасностью.

Оповещения в реальном времени

Помимо пассивной записи, CCLogger умеет активно следить за подозрительной активностью. Вы можете задать список ключевых слов (например, «hack», «cheat», «exploit») и команд (таких как /op или /gamemode). Как только кто-то произнесёт или выполнит триггер, операторы с правом cclogger.notify мгновенно получат уведомление прямо в игре. Все срабатывания дополнительно фиксируются в отдельном файле — вы ничего не пропустите.

Веб-дашборд для глубокого анализа

В состав плагина входит современный дашборд на React (по умолчанию отключён). Он открывает совершенно новый уровень работы с логами:

• Обзорная статистика с разбивкой по типам событий и круговая диаграмма распределения.
• Живая лента активности, которая автоматически обновляется; её можно ставить на паузу и фильтровать по типу.
• Полнотекстовый поиск по всем записям с фильтрами по игроку, дате и категории.
• Профили игроков с аватарками (через Crafatar), сводкой статистики и историей действий.
• Экспорт результатов в JSON или CSV для внешнего анализа.

Встроенный REST API с JWT-аутентификацией и ограничением частоты запросов позволяет интегрировать дашборд в любую внешнюю систему. А для быстрого старта достаточно включить веб-интерфейс в конфигурации и указать порт.

Установка и первые шаги

CCLogger работает на Paper 1.21+ и Folia, требует Java 21. Установка элементарна: скачайте JAR-файл плагина, поместите в папку plugins/ и перезапустите сервер. После запуска появится конфиг plugins/CCLogger/config.yml с настройками по умолчанию — плагин сразу начнёт писать логи в SQLite. Если вы предпочитаете другой бэкенд, просто измените параметр storage.type и выполните /cclogger reload. Кстати, для удобного управления модами и плагинами многие администраторы выбирают лаунчер foxygame.net: он позволяет прямо из меню скачивать и обновлять дополнения, не отвлекаясь от настройки сервера.

Команды и разрешения

Управление плагином осуществляется через несколько команд, доступных в зависимости от прав:

• /cclogger — выводит справку по всем подкомандам.
• /cclogger reload — перезагружает конфиг (требуется cclogger.reload).
• /cclogger count <слово> [игрок] — подсчитывает, сколько раз слово встречалось в логах (право cclogger.statistics).
• /cclogger clear — архивирует и очищает текущие логи (право cclogger.admin).

Основные разрешения: cclogger.* даёт полный доступ (по умолчанию у операторов), cclogger.notify — для получения оповещений, cclogger.exempt — исключает игрока из логирования. Детально всё описано в документации плагина.

Итог: прозрачность без компромиссов

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