Catalog

Catalog анализирует папку с плагинами при запуске сервера и связывает каждый .jar файл с соответствующим проектом на Modrinth. Плагин позволяет искать, устанавливать и обновлять дополнения одной кнопкой в игровом интерфейсе.

Catalog автоматически сканирует папку с плагинами при запуске сервера, определяя принадлежность каждого .jar файла к проекту на Modrinth. Идентификация происходит по хешу файла, поэтому переименование архива не мешает его распознаванию — ручное сопоставление не требуется.

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

Вы можете искать плагины на Modrinth, не покидая игру. Команда поиска возвращает только те дополнения, которые совместимы с вашей версией сервера.

• При клике на результат поиска открывается страница с описанием, автором, количеством загрузок и зависимостями.
• Установка происходит в один клик: файл попадает в папку плагинов и активируется после следующей перезагрузки.
• При установке плагина с зависимостями Catalog сообщит об их отсутствии и предложит скачать их вместе.
• Система учитывает платформу сервера: если плагин имеет разные сборки для Paper и Purpur, будет выбрана подходящая для вашего типа сервера.

Catalog проверяет наличие обновлений при запуске сервера и каждые три часа в процессе работы. Обновления никогда не применяются «на горячую» во избежание утечек памяти или блокировки файлов.

• Новые сборки скачиваются и готовятся к установке перед следующим запуском сервера.
• Автоматические обновления можно настроить для доверенных плагинов с индивидуальной задержкой.
• Функция задержки (soak) позволяет подождать несколько часов после выхода обновления, чтобы успеть проверить его на наличие ошибок.
• Если обновление вносит новые зависимости, автоматическая установка будет заблокирована до их ручного добавления.

Плагин предоставляет подробную историю действий и инструменты для контроля состояния сервера.

• Команда /catalog history фиксирует все установки, обновления, удаления и ошибки (например, если автоматическое обновление было заблокировано).
• После перезагрузки Catalog проверяет работоспособность всех недавно установленных плагинов. Если плагин не загрузился, в сводке при входе администратора появится кнопка отката обновления.
• При удалении плагина он перемещается в специальную папку «trash». Это позволяет восстановить его через команду /catalog trash restore.
• Удаленные файлы хранятся в корзине 30 дней, прежде чем будут окончательно стерты.

Конфигурационный файл plugins/Catalog/config.yml содержит краткие комментарии и позволяет настраивать поведение для новых плагинов по умолчанию.

• Настройка каналов (release, beta, alpha), параметров автообновления и времени ожидания (soak).
• Частота проверки обновлений и срок хранения удаленных плагинов в корзине.
• Опциональный Modrinth токен для повышения лимитов запросов и доступа к приватным проектам.
• Валидация файлов: перед добавлением в папку плагинов Catalog проверяет правильность файла, его размер и соответствие версии Java сервера.
• Безопасность: файлы без хеша или с небезопасными именами на Modrinth автоматически отклоняются.
• Анонимная статистика сервера отправляется через bStats (можно отключить в конфиге).