mclo.gs - публикация и анализ логов сервера Майнкрафт

Что такое mclo.gs?

Любой админ сервера Майнкрафт знает, как иногда тяжело разбирать логи. Сервер упал, плагин конфликтует, мод выдает кучу ошибок - а копировать лог в чат Дискорда сплошная боль. Он обрезается, теряет форматирование, и найти там реальную проблему становится сложно.

Тут на сцену выходит mclo.gs - мод и плагин для Minecraft, созданный специально для быстрого шерингу и анализа серверных логов. Проект интегрируется с одноименным сервисом и позволяет одной командой запихнуть весь лог на хостинг, получить короткую ссылку и сразу увидеть подсветку ошибок.

Главные фишки

• Загрузка логов в один клик - не надо никуда лезть по FTP, всё делается прямо из консоли или игры.
• Короткие ссылки - делитесь логом в чате или тикетах без риска обрезать текст.
• Безопасность - мод на лету вырезает чувствительные данные. IP-адреса игроков, пути к папкам, имена пользователей - всё это автоматически удаляется перед загрузкой.
• Анализ логов - сервис подсвечивает разные уровни логирования (INFO, WARN, ERROR) и пытается автоматически выявить известные проблемы и информацию о версиях.
• Управление загрузками - можно листать старые логи, краш-репорты и ошибки сетевого протокола, а также удалять их.

Команды плагина и мода

Управление mclo.gs происходит через несколько простых команд.

Команда	Аргументы	Описание	Уровень (Vanilla)	Нода прав (Bukkit/Spigot)
mclogs		Загрузить и расшарить текущий лог сервера	2	mclogs
mclogs list		Показать список логов, краш-репортов и ошибок сети	2	mclogs.list
mclogs share	<имя-файла>	Загрузить конкретный лог или краш-репорт	2	mclogs.share
mclogs delete	<id-лога>	Удалить расшаренный лог с сервера	2	mclogs.delete

Специфические сценарии

В зависимости от того, как вы разворачиваете свой проект, команды могут немного отличаться. Например, если вы поставили мод на клиент, или плагин на прокси.

Сценарий	Команда	Что делает
Мод установлен на клиенте	/mclogsc	Обработка клиентских логов
Плагин на Velocity	/mclogsp и /mclogsv	Обработка логов прокси
Плагин на BungeeCord	/mclogsp и /mclogsb	Обработка логов прокси

Права доступа

По умолчанию обычные игроки не имеют доступа к этим командам. На серверах с плагинами (Bukkit, Spigot, Paper) доступ раздается через ноды прав. Например, чтобы дать модератору доступ ко всем функциям, выдайте ему права mclogs, mclogs.list, mclogs.share и mclogs.delete. Нода mclogs является базовой и требуется для работы остальных команд.

Если у вас мод-сервер (Fabric, Forge, NeoForge), тут работает ванильная система уровней прав. Командам нужен уровень 2 (оператор).

Конфигурация

Если вы параноик и используете собственный хостинг для логов или альтернативный фронтенд, всё настраивается в конфиге. Для серверов с плагинами файл лежит по пути plugins/mclogs/config.toml. Для мод-серверов - config/mclogs.toml.

Базовый конфиг выглядит так:

# Base URL for the API used to upload logs
apiBaseUrl = "https://api.mclo.gs"

Требования и нюансы

Для работы mclo.gs требуется Java 11 или выше. Важный момент - это работает даже на старых сборках Minecraft, которые изначально запускаются на Java 8. Просто удостоверьтесь, что на вашем сервере установлена нужная версия Java.

Если вы арендуете сервер Minecraft на BungeeHost, этот плагин ставится в пару кликов и моментально помогает решать проблемы с крашами и багами, экономя кучу времени саппорту и администрации.