Подробный гайд по установке и настройке CS2-Chat-Logger на сервере Counter-Strike 2

Важно:

• CS2-Chat-Logger обычно представляет собой плагин для SourceMod 2.x. Точные имена файлов и параметры могут отличаться в зависимости от репозитория (GitHub/GitLab). Данный гайд описывает универсальный и безопасный путь установки, актуальный для архитектуры CS2 на 2024–2026 гг. Всегда сверяйтесь с README.md автора плагина.

1. Требования

Компонент	Минимальная версия	Примечание
CS2 Dedicated Server	Последняя стабильная ветка SteamCMD
Metamod:Source	2.0.0+ (Source 2)	Обязательно для работы SM
SourceMod	2.0.0+ (ветка cs2)	Поддерживает .smx плагины
Права на сервер	root или пользователь с доступом к файлам сервера
База данных (опционально)	SQLite / MySQL	Для расширенного логирования

2. Подготовка окружения (Metamod + SourceMod)

Если на вашем сервере ещё не установлены Metamod:Source и SourceMod:

cd /путь/к/серверу/cs2/

# Скачайте актуальные сборки с официальных сайтов
# Metamod: https://www.sourcemm.net/downloads.php
# SourceMod: https://www.sourcemod.net/downloads.php (ветка cs2)

# Распакуйте архивы в корень сервера, сохранив структуру папок
# Проверьте установку:
./game/csgo/bin/linux64/cs2 +game_type 0 +game_mode 0 +map de_dust2 +exec server.cfg

В консоли сервера выполните:

meta version
sm version

Обе команды должны вернуть информацию о версиях. Если нет — проверьте пути и файлы gameinfo.gi / metamod.vdf.

3. Загрузка CS2-Chat-Logger

1. Перейдите в официальный репозиторий проекта (обычно GitHub).
2. Скачайте последний релиз (Release → Assets).

3. В архиве обычно находятся:

• CS2-Chat-Logger.smx (скомпилированный плагин)
• CS2-Chat-Logger.sp (исходник, опционально)
• cfg/ или configs/ (файлы конфигурации)
• translations/ (локализация)
• README.md / INSTALL.md

4. Установка файлов

Скопируйте файлы в соответствующие директории сервера CS2:

# Плагин
cp CS2-Chat-Logger.smx /путь/к/серверу/cs2/game/csgo/addons/sourcemod/plugins/

# Конфигурация (если есть .cfg или .json)
cp chatlogger.cfg /путь/к/серверу/cs2/game/csgo/cfg/sourcemod/
# или
cp chatlogger.json /путь/к/серверу/cs2/game/csgo/addons/sourcemod/configs/

# Локализация (опционально)
cp ru.txt /путь/к/серверу/cs2/game/csgo/addons/sourcemod/translations/

Примечание:

• Точные пути могут отличаться. Если в README указано game/csgo/addons/sourcemod/configs/ — используйте его. Структура CS2 чувствительна к регистру на Linux.

5. Настройка утилиты

5.1. Основной конфигурационный файл

Откройте cfg/sourcemod/chatlogger.cfg (или аналог) и настройте ключевые параметры:

// Включение/выключение логирования
sm_chatlogger_enable "1"

// Путь к папке логов (относительно корня сервера)
sm_chatlogger_logpath "logs/chat/"

// Формат имени файла: %Y-%m-%d заменяется на дату
sm_chatlogger_filename "chat_%Y-%m-%d.log"

// Логировать ли команды администраторов (!admin, !kick и т.д.)
sm_chatlogger_log_admin_commands "1"

// Формат строки лога
// Доступные переменные: {time}, {player}, {steamid}, {msg}, {team}
sm_chatlogger_format "[{time}] [{team}] {player} ({steamid}): {msg}"

// Использовать БД вместо файлов? (0 - файлы, 1 - SQLite, 2 - MySQL)
sm_chatlogger_use_db "0"

5.2. Настройка базы данных (если sm_chatlogger_use_db "2")

Отредактируйте addons/sourcemod/configs/databases.cfg:

"Databases"
{
    "chatlogger"
    {
        "driver"    "mysql"
        "host"      "127.0.0.1"
        "database"  "cs2_chatlog"
        "user"      "cs2_user"
        "pass"      "ваш_пароль"
        "port"      "3306"
    }
}

Примечание:

• Плагин обычно создаёт таблицы автоматически при первом запуске. Убедитесь, что у пользователя БД есть права CREATE, INSERT, SELECT.

5.3. Права доступа (admin_overrides.cfg / admin_groups.cfg)

Если плагин поддерживает команды вроде sm_chatreload или sm_chatflush, добавьте в addons/sourcemod/configs/admin_overrides.cfg:

Overrides
{
    "sm_chat_reload"    "z"   // только root
    "sm_chat_clear"     "b"   // администраторы
}

6. Перезапуск и проверка работы

1. Перезагрузите плагины в консоли сервера:

   sm plugins reload CS2-Chat-Logger

2. Проверьте статус:

   sm plugins list

В выводе должен присутствовать CS2-Chat-Logger.smx со статусом [LOADED].

3. Отправьте тестовое сообщение в игровой чат.

4. Проверьте появление файла:

   ls -la /путь/к/серверу/cs2/game/csgo/logs/chat/
   cat /путь/к/серверу/cs2/game/csgo/logs/chat/chat_2026-04-07.log

7. Частые проблемы и решения

Симптом	Причина	Решение
Plugin failed to load	Несоответствие версии SM/CS2	Обновите SourceMod до ветки cs2, пересоберите .sp если есть
Логи не создаются	Нет прав на запись или неверный путь	chmod -R 755 logs/, проверьте sm_chatlogger_logpath
Плагин грузится, но не пишет	Конфликт с другими чат-плагинами	Отключите simple-chatprocessor, admin-chat и аналоги
Ошибки в логах сервера	Отсутствует databases.cfg или неверные креды	Проверьте синтаксис, запустите sm database test chatlogger
Сообщения дублируются	Включено несколько логгеров	Оставьте только один активный плагин

Включите отладку при проблемах:

sm plugins load CS2-Chat-Logger
sm config sm_chatlogger_debug 1

Смотрите вывод в console.log или game/csgo/logs/L[дата].log.

8. Безопасность и обслуживание

• Регулярно ротируйте логи: find logs/chat/ -name "*.log" -mtime +30 -delete
• Не храните логи в публичных директориях веб-сервера без .htaccess / nginx deny
• Обновляйте плагин при выходе новых версий CS2 (Valve часто меняет API чата)
• Делайте бэкап addons/sourcemod/plugins/ и cfg/ перед обновлениями

Полезные команды плагина (пример)

Команда	Описание
sm_chatlogger	Показать статус и настройки
sm_chatreload	Перезагрузить конфиг без рестарта карты
sm_chatclear	Очистить текущий лог-файл (требует прав)
sm_chatsearch <ник>	Поиск по сохранённым логам (если поддерживается)