Описание

Описание mclo.gs

это плагин и мод для быстрой отправки логов Minecraft на сервис mclo.gs прямо из игры или серверной консоли. Он помогает администратору получить короткую ссылку на текущий лог, crash report или сетевой отчёт, а затем открыть его в веб-интерфейсе с подсветкой уровней, распознаванием версий и анализом типовых проблем. По данным Modrinth и GitHub, проект поддерживает широкий набор платформ: Bukkit/Paper-ветку, BungeeCord и Velocity-прокси, а также Fabric, Forge, NeoForge и Quilt. Сервис mclo.gs заявляет удаление чувствительных фрагментов вроде IP-адресов и системных имён пользователей, причём интеграция описывает это как автоматическую обработку на устройстве перед отправкой. Это полезная защита от случайной публикации очевидных данных, но её не стоит воспринимать как обещание полной анонимизации любого лога. Перед тем как отправлять ссылку в публичный чат, администратору всё равно разумно просмотреть результат. > Практический сценарий: вместо копирования длинного latest.log в чат вы запускаете команду, получаете короткую ссылку и отправляете её разработчику, хостингу или участникам поддержки. | Параметр | Значение по источнику | |---|---| | Тип | серверный plugin/mod для mclo.gs | | Лицензия | MIT | | Java | 11 или выше | | Платформы | Spigot/Paper/Folia/Purpur, Fabric, Forge, NeoForge, Quilt, BungeeCord, Velocity, Waterfall |

Что делает ресурс Основная функция mclo.gs

загрузить лог и вернуть короткий URL, который удобно переслать. Команда без аргументов публикует текущий серверный лог, отдельная команда показывает список доступных логов и отчётов, а share позволяет выбрать конкретный файл. Есть и команда удаления для логов, которые были опубликованы с этого сервера. На стороне сервиса лог становится читабельнее: разные уровни сообщений подсвечиваются, версионная информация извлекается в явном виде, а типовые проблемы могут быть обнаружены автоматически. Это особенно полезно, когда человек просит помощи по крашу, конфликту модов или ошибке запуска: ссылка на mclo.gs обычно проще, чем вложение файла или неформатированная вставка на сотни строк. ```text /mclogs

поделиться текущим серверным логом /mclogs list

показать логи, crash reports и protocol error reports /mclogs share

отправить конкретный файл /mclogs delete

удалить лог, опубликованный с этого сервера ``` Для прокси и клиентской установки предусмотрены отдельные варианты команд. Если мод установлен на клиенте, используется `/mclogsc`. На Velocity доступны `/mclogsp` и `/mclogsv`, на BungeeCord

/mclogsp и /mclogsb. Это помогает разделить серверные, прокси- и клиентские логи, не смешивая разные окружения в одной команде.
загрузка текущего лога одной командой;
публикация crash reports и network protocol error reports;
короткая ссылка для передачи в поддержку или разработчику;
подсветка уровней логирования в веб-интерфейсе;
обнаружение распространённых проблем и версионной информации;
удаление логов, опубликованных через этот сервер;
настройка альтернативного API или собственного экземпляра mclo.gs.

Особенности mclo.gs удобен именно как интеграция в серверный рабочий процесс. Администратору не нужно искать файл на диске, архивировать его или объяснять игроку, куда вставить содержимое. Достаточно иметь права на команду, выполнить публикацию и отправить ссылку. На plugin-серверах доступ контролируется permission nodes, а на modded-серверах используется ванильная система уровней прав. | Команда | Назначение | Права | |---|---|---| | `mclogs` | отправить текущий серверный лог | уровень 2 / `mclogs` | | `mclogs list` | показать доступные логи и отчёты | уровень 2 / `mclogs.list` | | `mclogs share <file-name>` | отправить выбранный лог или отчёт | уровень 2 / `mclogs.share` | | `mclogs delete <log-id>` | удалить опубликованный лог | уровень 2 / `mclogs.delete` | Важно, что команды не выдаются игрокам по умолчанию. Для обычного сервера это правильная модель: логи могут содержать технические данные, пути, ники, ошибки авторизации модов и другие детали окружения. Если нужно дать доступ помощнику или модератору, выдавайте минимальный набор прав, например только список и публикацию, а удаление оставляйте администраторам. Конфигурация пригодится тем, кто использует self-hosted-экземпляр mclo.gs или альтернативный фронтенд. В исходнике указаны два пути к файлу настроек: `plugins/mclogs/config.toml` для plugin-серверов и `config/mclogs.toml` для modded-серверов. По умолчанию API направлен на официальный endpoint. ```toml

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

Совместимость и установка Проект опубликован как единая интеграция для разных платформ. На Modrinth перечислены BungeeCord, Fabric, Folia, Forge, NeoForge, Paper, Purpur, Quilt, Spigot, Velocity и Waterfall. В репозитории GitHub структура также разделена по модулям: общая логика, Bukkit, BungeeCord, Velocity, Fabric, Forge и NeoForge. Это объясняет, почему один проект закрывает и плагин-серверы, и модовые окружения. Перед установкой проверьте Java: проект требует Java 11 или выше даже для старых версий Minecraft, которые сами могут запускаться на Java

Это частая причина проблем на старых хостингах: сервер Minecraft вроде бы стартует, но плагин или мод не загружается из-за более старой Java. Рекомендуемый порядок:
Выберите файл под свою платформу: Paper/Spigot/Folia, Velocity/BungeeCord или нужный mod-loader.
Установите его как обычный плагин или мод для этой платформы.
Перезапустите сервер или прокси и проверьте, что команда mclogs появилась.
Выдайте permissions только тем ролям, которым действительно нужно публиковать логи.
Если используете свой mclo.gs endpoint, измените apiBaseUrl в соответствующем TOML-файле. Для разработчиков репозиторий собирается Gradle-проектом. README указывает ./gradlew buildAll для сборки всех модулей, а также отдельные задачи для некоторых платформ. Обычному администратору это не нужно: для продакшен-сервера лучше брать опубликованный релиз под нужную платформу, а не собирать jar вручную без необходимости.

Вопросы и ответы

mclo.gs

это плагин или мод? И то и другое: проект выпускается для plugin-платформ, прокси и mod-loader окружений.

Что делает команда `/mclogs`?

Она публикует текущий серверный лог и возвращает короткую ссылку на mclo.gs.

Можно ли отправить не текущий лог, а конкретный файл?

Да, для этого используется mclogs share <file-name> после просмотра доступных файлов через mclogs list.

Команды доступны игрокам сразу после установки?

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

Удаляет ли mclo.gs личные данные?

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

Нужна ли Java 11?

Да. Проект требует Java 11 или выше даже на версиях Minecraft, которые обычно могут работать с Java 8.

Быстрые ответы для сниппетов

mclo.gs публикует Minecraft-логи на mclo.gs и возвращает короткую ссылку.
Поддерживаются plugin-серверы, прокси и mod-loader платформы.
Команды требуют права: на plugin-серверах через permission nodes, на modded-серверах через ванильные уровни.
Конфиг находится в plugins/mclogs/config.toml или config/mclogs.toml.
Для запуска нужен Java 11 или выше.