AutoUpdatePlugins (Автоапдейтплагинс)

Плагин для серверов Майнкрафт, который автоматически скачивает и подготавливает обновления других плагинов. Он проверяет указанные источники по расписанию, загружает подходящие .jar-файлы в фоне и применяет их после перезапуска сервера или прокси.

Возможности

• Обновляет плагины из GitHub, Jenkins, SpigotMC, dev.bukkit, Modrinth, Hangar, CurseForge и других поддерживаемых площадок, а также по прямым ссылкам на .jar.
• Может брать файл с локального пути (file:, local:, path:) или запускать локальный скрипт, который выводит путь к собранному .jar.
• Загружает несколько файлов параллельно, повторяет временно неудачные запросы и не блокирует основной поток сервера.
• Проверяет целостность архивов, пропускает файлы с совпадающей MD5-суммой и может сохранять резервные копии прежних .jar для автоматического отката при ошибке запуска.
• Поддерживает Spigot, Paper, Folia, Velocity и BungeeCord.

Команды

• /update — запустить проверку и обновление.
• /aup download [names...] или /aup update [names...] — обновить все плагины либо только перечисленные.
• /aup stop — остановить текущую проверку.
• /aup reload — перечитать конфигурацию.
• /aup add <name> <link> — добавить запись в list.yml.
• /aup remove <name> — удалить запись.
• /aup list [page] — показать список отслеживаемых плагинов.
• /aup enable <name> и /aup disable <name> — включить или отключить запись в списке.
• /aup debug <on|off|toggle|status> — управлять подробным журналом.

Права

• autoupdateplugins.update — доступ к /update.
• autoupdateplugins.manage — доступ к командам /aup.

Настройка

В plugins/AutoUpdatePlugins/list.yml укажите имя сохраняемого файла и источник обновления:

ViaVersion: "ссылка-на-плагин"

Для выбора нужного файла в источнике используются параметры:

• [N] — выбрать файл с указанным номером на странице сборки;
• ?get=<regex> — выбрать файл по регулярному выражению имени;
• ?artifact=N — выбрать артефакт GitHub Actions;
• ?prerelease=true, ?alpha=true, ?beta=true — разрешить соответствующие предварительные сборки;
• ?channel=Alpha или ?channel=Beta — выбрать канал Hangar;
• ?autobuild=true — собрать проект GitHub из исходников, если это разрешено настройками.

Основные параметры находятся в plugins/AutoUpdatePlugins/config.yml:

• updates.interval и updates.bootTime задают интервал проверки и задержку после запуска;
• updates.schedule.cron вместе с updates.schedule.timezone позволяют использовать расписание cron и заменяют интервал;
• behavior.useUpdateFolder помещает обновления в папку update для безопасной подмены;
• behavior.zipFileCheck проверяет скачанные архивы;
• behavior.ignoreDuplicates не заменяет одинаковые файлы;
• behavior.restartAfterUpdate, behavior.restartDelaySec и behavior.restartMessage настраивают автоматический перезапуск;
• performance.maxParallel, connectTimeoutMs, readTimeoutMs, maxRetries и параметры задержек управляют параллельной загрузкой и повторными попытками;
• proxy.type, proxy.host, proxy.port задают HTTP- или SOCKS-прокси.

Обычно сервер требуется перезапустить, чтобы он загрузил обновлённые .jar-файлы.

Требования

Нужна Java 8 или новее. Для автоматического получения файлов необходим доступ сервера к источникам загрузки; для сборки из исходников могут потребоваться Gradle или Maven.