Catalog (Каталог)

Плагин для серверов Майнкрафт, который управляет плагинами из Modrinth прямо в игре: ищет их, устанавливает, обновляет и удаляет. Он сверяет файлы в папке plugins по хешу, поэтому распознаёт плагин даже после переименования файла.

Возможности

• Показывает распознанные плагины и доступные обновления в чате.
• Ищет совместимые с сервером плагины в Modrinth и открывает сведения о них по нажатию.
• Устанавливает подходящие сборки с учётом платформы сервера и версии Java.
• Ставит обновления в очередь до следующего перезапуска: работающие плагины не заменяются на ходу.
• Проверяет скачанные файлы перед добавлением в plugins.
• Перемещает удалённые плагины в папку trash, откуда их можно восстановить.
• Ведёт историю установок, обновлений, удалений и восстановлений.
• Для каждого отслеживаемого плагина можно выбрать канал, автоматическое обновление и задержку перед ним.

Плагины, которых нет на Modrinth, и собственные .jar-файлы не затрагиваются.

Команды

Основная команда — /catalog; также работают сокращения /ctlg, /cata, /ctl и /clg.

• /catalog list — список отслеживаемых плагинов и обновлений.
• /catalog info <plugin> — сведения о плагине.
• /catalog search <query> — поиск совместимых плагинов.
• /catalog versions <plugin> — доступные сборки.
• /catalog dependencies <plugin> — зависимости плагина.
• /catalog install <slug> [version] — установка плагина или указанной сборки.
• /catalog update <plugin|all> — подготовка обновления к следующему перезапуску.
• /catalog cancel <plugin> — отмена подготовленного обновления.
• /catalog uninstall <plugin> — перемещение плагина в корзину.
• /catalog trash — список удалённых плагинов.
• /catalog trash restore <plugin> — восстановление плагина.
• /catalog trash delete <plugin|all> — окончательное удаление из корзины.
• /catalog history — журнал действий.
• /catalog settings <plugin> — настройки отслеживания.
• /catalog channel <plugin> <channel> — выбор канала release, beta или alpha.
• /catalog auto <plugin> <on|off> — включение автоматического обновления.
• /catalog soak <plugin> <window> — задержка перед автоматическим обновлением.
• /catalog hold <plugin> и /catalog unhold <plugin> — запрет и повторное разрешение обновлений.
• /catalog reload — перезагрузка конфигурации.

Права

• catalog.admin и catalog.* — полный доступ.
• catalog.command.<name> — доступ к отдельной команде.
• catalog.command.list — список плагинов и журнал.
• catalog.command.info — сведения, версии и зависимости.
• catalog.command.install — установка.
• catalog.command.update — обновление и отмена обновления.
• catalog.command.uninstall — удаление в корзину.
• catalog.command.trash — управление корзиной.
• catalog.command.settings — настройки и автообновления.
• catalog.command.hold — запрет обновлений.

Настройка

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

Параметр allow_incompatible_installs разрешает установку несовместимых сборок. Без него плагин отбирает файлы по платформе сервера, версии Майнкрафт и Java.

Требования

Работает на Paper, Purpur и Folia. Требуется Java 17 или новее; плагины для управления должны быть опубликованы на Modrinth.