AutoUpdatePlugins

<div align="center"> # **AutoUpdatePlugins v12.2.0** *Keep your server’s plugins up-to-date - automatically, safely, and across platforms.* !(https://img.shields.io/badge/Platforms-Spigot%20%7C%20Paper%20%7C%20Folia%20%7C%20Velocity%20%7C%20BungeeCord-5A67D8) !(https://img.shields.io/badge/Minecraft-1.8%E2%86%92Latest-2EA043) !(https://img.shields.io/badge/Java-8%2B%20\(11%2B%20HTTP%2F2,%2021%2B%20Virtual%20Threads\)-1F6FEB) !(https://img.shields.io/badge/License-MIT-0E8A16) </div> > **TL;DR** > Drop in the jar ➜ list the plugins you want ➜ it finds, downloads, validates, and stages updates from a ton of > sources - on a schedule, in parallel, without blocking your main thread. --- ## Table of Contents * (#highlights) * (#supported-sources--platforms) * (#requirements) * (#installation) * (#quick-start) * (#configuration) * (#configyml) * (#listyml) * (#scheduling-cheat-sheet) * (#performance-tuning-guide) * (#commands--permissions) * (#how-it-works-under-the-hood) * (#examples-for-every-source) * (#troubleshooting--faq) * (#building-from-source) * (#security-notes) * (#contributing-issues--support) * (#license) --- ## Highlights * **One list, many sources.** Pull updates from GitHub Releases/Actions, Jenkins, SpigotMC (Spiget), dev.bukkit, Modrinth, Hangar, BusyBiscuit, blob.build, Guizhanss v2, MineBBS, CurseForge, or any page with a direct `.jar` link. * **Local sources.** Point at local jar files or run scripts that output a jar path for custom/patched builds. * **Smart file selection.** Use `?get=<regex>`, `` (pick the N-th asset - works for both GitHub and Jenkins artifacts), `?artifact=2` for GitHub Actions bundles, `?prerelease=true`, `?alpha=true`, `?beta=true`, `?latest=true`, `?channel=Alpha`, `?autobuild=true` - mix and match to land on the exact build you need. * **Zero-friction config evolution.** New options are **auto-added** to `config.yml` without clobbering your comments or existing values. * **HTTP flexibility.** Add custom headers, rotate User-Agents, and route through proxies when needed. * **Performance built-in.** * Fully **async** downloads; no main-thread stalls. * **Java 11+ HTTP/2** client for modern, non-blocking transfers. * **Java 21+ virtual threads** for ultra-lightweight concurrency. * **Connection pooling**, **parallel downloads**, and **retry with exponential backoff**. * **Flexible scheduling.** Interval + boot delay *or* cron with timezone support. * **Cross-platform.** Works on **Spigot**, **Paper**, **Folia**, **Velocity**, **BungeeCord**. * **Safe updates.** Download ➜ validate ➜ atomic replace, staged through temp/update paths. * **Integrity + dedupe.** Optional zip integrity checks and MD5 comparison skip corrupted or unchanged downloads. * **Rollback safety net.** Snapshot the previous jar and auto-restore if the new build fails to start. --- ## Supported Sources & Platforms ### Download Sources | Source | Release/Build Discovery | Notes / Selectors Supported | |-----------------------|-------------------------|------------------------------------------------------------------------------------------------------------------------| | **GitHub** | Releases & Actions | ``, `?artifact=2`, `?get=regex`, `?prerelease=true`, `?alpha=true`, `?beta=true`, `?latest=true`, `?autobuild=true` | | **Jenkins** | Latest build artifacts | ``, `?get=regex` | | **SpigotMC (Spiget)** | Resource page URL | Auto-resolves latest | | **dev.bukkit** | Project page | Auto-resolves latest | | **Modrinth** | Project/version URL | `?get=regex`, `?alpha=true`, `?beta=true`, `?latest=true` | | **Hangar** | Project/releases | `?get=regex`, `?alpha=true`, `?beta=true`, `?latest=true`, `?channel=Alpha` | | **BusyBiscuit** | Project index | Auto-resolves | | **blob.build** | Build artifacts | `?get=regex`