{"id":23938,"date":"2026-06-01T11:04:12","date_gmt":"2026-06-01T08:04:12","guid":{"rendered":"https:\/\/vpesports.com\/minecraft\/mods\/autoupdateplugin\/"},"modified":"2026-06-01T11:04:12","modified_gmt":"2026-06-01T08:04:12","slug":"autoupdateplugin","status":"publish","type":"mod","link":"https:\/\/vpesports.com\/minecraft\/mods\/autoupdateplugin\/","title":{"rendered":"AutoUpdatePlugins"},"content":{"rendered":"
\n

# **AutoUpdatePlugins v12.2.0**<\/p>\n

*Keep your server\u2019s plugins up-to-date – automatically, safely, and across platforms.*<\/p>\n

![Platforms](https:\/\/img.shields.io\/badge\/Platforms-Spigot%20%7C%20Paper%20%7C%20Folia%20%7C%20Velocity%20%7C%20BungeeCord-5A67D8)
\n![MC](https:\/\/img.shields.io\/badge\/Minecraft-1.8%E2%86%92Latest-2EA043)
\n![Java](https:\/\/img.shields.io\/badge\/Java-8%2B%20(11%2B%20HTTP%2F2,%2021%2B%20Virtual%20Threads)-1F6FEB)
\n![License](https:\/\/img.shields.io\/badge\/License-MIT-0E8A16)<\/p>\n<\/div>\n

> **TL;DR**
\n> Drop in the jar \u279c list the plugins you want \u279c it finds, downloads, validates, and stages updates from a ton of
\n> sources – on a schedule, in parallel, without blocking your main thread.<\/p>\n

—<\/p>\n

## Table of Contents<\/p>\n

* [Highlights](#highlights)
\n* [Supported Sources & Platforms](#supported-sources–platforms)
\n* [Requirements](#requirements)
\n* [Installation](#installation)
\n* [Quick Start](#quick-start)
\n* [Configuration](#configuration)<\/p>\n

* [`config.yml`](#configyml)
\n * [`list.yml`](#listyml)
\n * [Scheduling Cheat Sheet](#scheduling-cheat-sheet)
\n * [Performance Tuning Guide](#performance-tuning-guide)
\n* [Commands & Permissions](#commands–permissions)
\n* [How It Works (Under the Hood)](#how-it-works-under-the-hood)
\n* [Examples for Every Source](#examples-for-every-source)
\n* [Troubleshooting & FAQ](#troubleshooting–faq)
\n* [Building from Source](#building-from-source)
\n* [Security Notes](#security-notes)
\n* [Contributing, Issues & Support](#contributing-issues–support)
\n* [License](#license)<\/p>\n

—<\/p>\n

## Highlights<\/p>\n

* **One list, many sources.** Pull updates from GitHub Releases\/Actions, Jenkins, SpigotMC (Spiget), dev.bukkit,
\n Modrinth, Hangar, BusyBiscuit, blob.build, Guizhanss v2, MineBBS, CurseForge, or any page with a direct `.jar` link.
\n* **Local sources.** Point at local jar files or run scripts that output a jar path for custom\/patched builds.
\n* **Smart file selection.** Use `?get=`, `[N]` (pick the N-th asset – works for both GitHub and Jenkins
\n artifacts), `?artifact=2` for GitHub Actions bundles, `?prerelease=true`, `?alpha=true`, `?beta=true`, `?latest=true`,
\n `?channel=Alpha`, `?autobuild=true` – mix and match to land on the exact build you need.
\n* **Zero-friction config evolution.** New options are **auto-added** to `config.yml` without clobbering your comments or
\n existing values.
\n* **HTTP flexibility.** Add custom headers, rotate User-Agents, and route through proxies when needed.
\n* **Performance built-in.**<\/p>\n

* Fully **async** downloads; no main-thread stalls.
\n * **Java 11+ HTTP\/2** client for modern, non-blocking transfers.
\n * **Java 21+ virtual threads** for ultra-lightweight concurrency.
\n * **Connection pooling**, **parallel downloads**, and **retry with exponential backoff**.
\n* **Flexible scheduling.** Interval + boot delay *or* cron with timezone support.
\n* **Cross-platform.** Works on **Spigot**, **Paper**, **Folia**, **Velocity**, **BungeeCord**.
\n* **Safe updates.** Download \u279c validate \u279c atomic replace, staged through temp\/update paths.
\n* **Integrity + dedupe.** Optional zip integrity checks and MD5 comparison skip corrupted or unchanged downloads.
\n* **Rollback safety net.** Snapshot the previous jar and auto-restore if the new build fails to start.<\/p>\n

—<\/p>\n

## Supported Sources & Platforms<\/p>\n

### Download Sources<\/p>\n

| Source | Release\/Build Discovery | Notes \/ Selectors Supported |
\n|———————–|————————-|————————————————————————————————————————|
\n| **GitHub** | Releases & Actions | `[N]`, `?artifact=2`, `?get=regex`, `?prerelease=true`, `?alpha=true`, `?beta=true`, `?latest=true`, `?autobuild=true` |
\n| **Jenkins** | Latest build artifacts | `[N]`, `?get=regex` |
\n| **SpigotMC (Spiget)** | Resource page URL | Auto-resolves latest |
\n| **dev.bukkit** | Project page | Auto-resolves latest |
\n| **Modrinth** | Project\/version URL | `?get=regex`, `?alpha=true`, `?beta=true`, `?latest=true` |
\n| **Hangar** | Project\/releases | `?get=regex`, `?alpha=true`, `?beta=true`, `?latest=true`, `?channel=Alpha` |
\n| **BusyBiscuit** | Project index | Auto-resolves |
\n| **blob.build** | Build artifacts | `?get=regex` |
\n| **Guizhanss v2** | Project index | Auto-resolves |
\n| **MineBBS** | Resource page | Auto-resolves |
\n| **CurseForge** | Project\/files | `?get=regex` |
\n| **Generic** | Direct `.jar` link | Exact file URL |
\n| **Local file** | Local path | `file:`, `local:`, `path:`, or absolute\/relative path |
\n| **Local script** | Script stdout path | `script:` or `exec:` (script prints jar path to stdout) |<\/p>\n

> **Note:** GitHub and Jenkins links both accept `[N]` to pick the **N-th** artifact on their release\/build pages (
\n> 1-indexed).
\n> **Tip:** You can pass just the **project root URL** for most sources (e.g., a GitHub repo or Spigot resource page) and
\n> let AutoUpdatePlugins choose the latest artifact. Add selectors for precision.<\/p>\n

### Server Platforms<\/p>\n

* **Spigot**, **Paper**, **Folia**
\n* **Velocity**, **BungeeCord**<\/p>\n

### Minecraft & Java<\/p>\n

* **Minecraft:** 1.8 \u2192 Latest
\n* **Java:** 8+ (uses advanced features automatically on 11+ and 21+)<\/p>\n

—<\/p>\n

## Requirements<\/p>\n

* **Java 8 or newer.**<\/p>\n

* Uses Java 11+ HTTP\/2 client when available.
\n * Uses Java 21+ virtual threads when available.
\n* **Network access** for source builds (Gradle\/Maven wrappers or system `gradle`\/`mvn`, if used).<\/p>\n

—<\/p>\n

## Installation<\/p>\n

1. Download the latest `.jar` from **Spigot**.
\n2. Place it into your server\u2019s **`plugins\/`** directory.
\n3. Start the server to generate default config files.
\n4. Edit **`plugins\/AutoUpdatePlugins\/config.yml`** and **`plugins\/AutoUpdatePlugins\/list.yml`**.
\n5. Run **`\/update`** or **`\/aup update`** (or restart) to kick off the first check.<\/p>\n

> **Velocity \/ BungeeCord:** Same process – drop the jar in `plugins\/`, configure, then trigger an update run.<\/p>\n

—<\/p>\n

## Quick Start<\/p>\n

1. Add a few entries to `list.yml`:<\/p>\n

“`yaml
\n ViaVersion: “https:\/\/www.spigotmc.org\/resources\/viaversion.19254\/”
\n Geyser: “https:\/\/download.geysermc.org\/v2\/projects\/geyser\/versions\/latest\/builds\/latest\/downloads\/spigot”
\n EssentialsXChat: “https:\/\/github.com\/EssentialsX\/Essentials[3]”
\n “`
\n2. Leave `updates.interval` at the default (every 120 minutes), or set a cron schedule.
\n3. Optional: Add a GitHub token in `config.yml` to avoid rate limits.
\n4. Trigger a run:<\/p>\n

“`
\n \/update
\n “`
\n5. New jars are staged atomically in your plugins folder (using temp\/update paths under the hood). **Restart** the
\n server to load the updated jars.<\/p>\n

—<\/p>\n

## Configuration<\/p>\n

### `config.yml`<\/p>\n

> The plugin **adds new options automatically** without overwriting your comments. Below is the full schema with
\n> defaults and notes.<\/p>\n

“`yaml
\n################################################################################
\n# AutoUpdatePlugins – Main Configuration
\n################################################################################<\/p>\n

updates:
\n # How often to run plugin updates (minutes). Default: 120 (every 2 hours)
\n interval: 120<\/p>\n

# Delay after server startup (seconds) before the first run. Default: 50
\n bootTime: 50<\/p>\n

# Schedule (experimental): Use a cron expression to control exactly when
\n # updates run. When set, this overrides both interval and bootTime.
\n # Examples:
\n # Every day at 03:30: “30 3 * * *”
\n # Every 15 minutes: “*\/15 * * * *”
\n # At 5 past every hour on weekdays: “5 * * * 1-5”
\n schedule:
\n cron: “” # Cron expression (UNIX 5-field). Leave blank to disable.
\n timezone: “UTC” # Timezone for the cron schedule, e.g. “America\/New_York”<\/p>\n

# Optional GitHub personal access token (PAT). Strongly recommended if you use
\n # many GitHub links to avoid API rate-limits when listing releases\/artifacts.
\n # Scope: public_repo is enough for public repos.
\n # Generate a token: https:\/\/github.com\/settings\/tokens
\n key:<\/p>\n

# HTTP configuration (optional)
\nhttp:
\n # If blank, a rotating pool of realistic User-Agents will be used.
\n userAgent: “”
\n # Extra request headers added to every request. Only add if you know you need it.
\n headers: [ ]
\n # Verify TLS certificates (set to false to trust all; only if you must)
\n sslVerify: true
\n # Optional pool of User-Agents; the plugin will rotate between them to avoid
\n # strict CDNs blocking automation.
\n userAgents:
\n – { ua: “Mozilla\/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit\/537.36 (KHTML, like Gecko) Chrome\/123.0.0.0 Safari\/537.36” }
\n – { ua: “Mozilla\/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit\/605.1.15 (KHTML, like Gecko) Version\/17.0 Safari\/605.1.15” }
\n – { ua: “Mozilla\/5.0 (X11; Linux x86_64; rv:126.0) Gecko\/20100101 Firefox\/126.0” }<\/p>\n

# Proxy configuration (optional)
\nproxy:
\n type: “NONE” # HTTP | SOCKS | (anything else = disabled)
\n host: “proxy.example”
\n port: 8080<\/p>\n

# Behavior toggles
\nbehavior:
\n useUpdateFolder: true
\n # Open downloaded .jar\/.zip to ensure integrity before install (recommended)
\n zipFileCheck: true
\n # Skip replacing an existing plugin if the new jar has the same MD5
\n ignoreDuplicates: true
\n # Allow GitHub\/Modrinth\/Hangar pre-releases by default for release queries.
\n allowPreRelease: false
\n # Enable source-build fallback for GitHub repositories.
\n autoCompile:
\n enable: false
\n # Build when a release has no .jar asset (zip-only)
\n whenNoJarAsset: true
\n # Build from source if default branch is newer than latest (pre)release by N months
\n branchNewerMonths: 6
\n # Verbose debug logging. Toggle with \/aup debug on|off
\n debug: false
\n # Restart the server\/proxy automatically after updates.
\n restartAfterUpdate: false
\n # Delay in seconds before restarting after updates.
\n restartDelaySec: 5
\n # Broadcast message before restarting (supports {delay}).
\n restartMessage: “Server restarting to apply updates.”<\/p>\n

# Optional custom paths
\npaths:
\n tempPath: ”
\n updatePath: ”
\n filePath: ”
\n rollbackPath: ”<\/p>\n

# Performance and reliability options
\nperformance:
\n # Maximum parallel downloads. Higher is faster but uses more IO\/CPU.
\n # If set above CPU cores, it is clamped internally.
\n maxParallel: 4
\n # HTTP connect timeout in milliseconds per request.
\n connectTimeoutMs: 10000
\n # HTTP read timeout in milliseconds per request.
\n readTimeoutMs: 30000
\n # Optional per-download hard timeout in seconds. 0 disables the cap.
\n perDownloadTimeoutSec: 0
\n # Retry behavior for transient HTTP errors (403\/429\/5xx)
\n maxRetries: 3
\n # Exponential backoff base and max delay in milliseconds between retries
\n backoffBaseMs: 500
\n backoffMaxMs: 5000
\n # Limit concurrent downloads per host to avoid 429s and improve stability
\n maxPerHost: 3<\/p>\n

rollback:
\n # Keep a backup of the previous version when updating a plugin and automatically revert back on plugin load failure (experimental!)
\n enabled: false
\n # Maximum number of old versions to keep per plugin (0 = unlimited)
\n maxBackups: 3
\n # Case-insensitive regex patterns that trigger rollback when matched in logs.
\n filters:
\n – “Unsupported API version”
\n – “Could not load plugin”
\n – “Error occurred while enabling”
\n – “Unsupported MC version”
\n – “You are running an unsupported server version”<\/p>\n

# Plugins List Configuration
\n# Edit the generated list.yml in this folder. Format:
\n# {FileSaveName}: {link.to.plugin}
\n#
\n# Example list.yml template: https:\/\/github.com\/NewAmazingPVP\/AutoUpdatePlugins\/blob\/main\/list.yml
\n# Examples:
\n# ViaVersion: “https:\/\/www.spigotmc.org\/resources\/viaversion.19254\/”
\n# Geyser: “https:\/\/download.geysermc.org\/v2\/projects\/geyser\/versions\/latest\/builds\/latest\/downloads\/spigot”
\n# EssentialsXChat: “https:\/\/github.com\/EssentialsX\/Essentials[3]”
\n#
\n# Supported sources: GitHub (Releases & Actions), Jenkins, SpigotMC (Spiget), dev.bukkit, Modrinth, Hangar,
\n# BusyBiscuit, blob.build, Guizhanss v2, MineBBS, CurseForge, local file paths, local scripts, plus generic pages with direct .jar links.
\n#
\n# Tips:
\n# – Select assets: append [N] to pick the Nth asset or use ?get= to match by filename.
\n# – GitHub Actions ZIPs: use ?artifact=2 (or ?index=\/ ?zip=) to pick a specific build, default is the first.
\n# – Pre-releases: set behavior.allowPreRelease: true or append ?prerelease=true on a GitHub link.
\n# – Channel flags: ?beta=true, ?alpha=true, ?latest=true, or ?channel=Alpha\/Beta for Hangar.
\n# – Modrinth\/Hangar obey the same flags (?alpha, ?beta, ?latest) to pick non-release builds when desired.
\n# – Force source build from GitHub: append ?autobuild=true to a GitHub repo URL.<\/p>\n

“`<\/p>\n

#### Safety & Recovery<\/p>\n

– `behavior.zipFileCheck`: validates `.jar` downloads extracted from archives before they ever reach the plugins
\n directory.
\n– `behavior.ignoreDuplicates`: skips deployment if the incoming jar matches the installed checksum, avoiding pointless
\n restarts.
\n– `rollback.*`: snapshots the previous jar, keeps a rotating history, and restores automatically when console output
\n matches the configured failure patterns.<\/p>\n

#### Advanced Selectors Cheat Sheet<\/p>\n

| Flag \/ Selector | Effect | Providers |
\n|——————————|————————————————————————————–|——————————–|
\n| `?get=` | Picks assets whose filename matches a regex | GitHub, Jenkins, Modrinth, etc |
\n| `[N]` | Chooses the N\u2011th asset (1-indexed) | GitHub Releases, Jenkins |
\n| `?artifact=2` \/ `?index=` | Chooses the N\u2011th GitHub Actions artifact (defaults to 1) | GitHub Actions |
\n| `?prerelease=true` | Install the newest build regardless of stability tier | GitHub, Modrinth, Hangar |
\n| `?alpha=true` \/ `?beta=true` | Prefer that channel while falling back to newer releases if no matching build exists | GitHub, Modrinth, Hangar |
\n| `?latest=true` | Same as `?prerelease=true`, but intended for explicit “always newest” behaviour | GitHub, Modrinth, Hangar |
\n| `?channel=Alpha` \/ `Beta` | Stick to a specific Hangar channel | Hangar |
\n| `?autobuild=true` | Trigger Gradle\/Maven source builds when binaries are missing | GitHub |<\/p>\n

**Key options explained**<\/p>\n

* **`updates.schedule.cron` + `timezone`** – When set, cron **overrides** `interval`\/`bootTime`.
\n* **`updates.key`** – GitHub PAT for Releases\/Actions access and higher rate limits (especially useful for public repos
\n under heavy use or any private repos).
\n* **`http.userAgents`** – Simple rotation to avoid brittle server-side filters.
\n* **`proxy`** – Full support for HTTP\/SOCKS proxies.
\n* **`behavior.autoCompile`** – For GitHub repos: if there\u2019s no release jar (or if the branch is newer than the last
\n release by `branchNewerMonths`), the repo can be **built from source** using Gradle\/Maven.
\n* **`behavior.zipFileCheck`** – Open downloaded jars\/zips to ensure they aren’t corrupt before install.
\n* **`behavior.ignoreDuplicates`** – Skip replacing a plugin if the new jar has the same MD5.
\n* **`behavior.useUpdateFolder`** – Stage new jars in the server\u2019s `update\/` directory for atomic swaps.
\n* **`behavior.restartAfterUpdate`** – Automatically restart after updates (delay via `behavior.restartDelaySec`, message
\n via `behavior.restartMessage`).
\n* **`behavior.debug`** – Verbose logging toggle, also controllable via `\/aup debug`.
\n* **`rollback`** – Configure automatic snapshots, retention, and log-match triggers for self-healing updates.
\n* **`paths`** – Customize temp\/staging\/output locations (falls back to sane defaults).
\n* **`performance`** – See [Performance Tuning Guide](#performance-tuning-guide).<\/p>\n

—<\/p>\n

### `list.yml`<\/p>\n

A simple mapping of **plugin display name \u279c source URL (+ optional selectors)**.<\/p>\n

“`yaml
\n# A list of plugins to update.
\n# Format: : <\/p>\n

ViaVersion: “https:\/\/www.spigotmc.org\/resources\/viaversion.19254\/”
\nGeyser: “https:\/\/download.geysermc.org\/v2\/projects\/geyser\/versions\/latest\/builds\/latest\/downloads\/spigot”
\nEssentialsXChat: “https:\/\/github.com\/EssentialsX\/Essentials[3]”
\n“`<\/p>\n

> Comment out a line with `#` to temporarily disable an entry. The `\/aup enable` and `\/aup disable` commands toggle this
\n> for you.<\/p>\n

**Selectors you can use**<\/p>\n

* **`[N]`** – Select the **N-th** jar asset (1-indexed) from a release or Jenkins build page. Example:
\n `…\/Essentials[3]`
\n* **`?get=`** – Choose files whose names match a regex. Example: `?get=.*(paper|spigot).*.jar`
\n* **`?artifact=2`** – Pick a specific GitHub Actions artifact (defaults to the first).
\n* **`?prerelease=true`** – Permit pre-releases.
\n* **`?autobuild=true`** – Force a source build on GitHub even if a jar asset exists.<\/p>\n

> **Pro tip:** Combine selectors, e.g. `…?prerelease=true&get=.*spigot.*.jar`.<\/p>\n

—<\/p>\n

### Scheduling Cheat Sheet<\/p>\n

Common cron expressions (with examples using `America\/New_York`):<\/p>\n

* **Every 2 hours:** `0 *\/2 * * *`
\n* **Every day at 05:00:** `0 5 * * *`
\n* **Every Monday & Thursday at 03:30:** `30 3 * * 1,4`
\n* **Every 15 minutes:** `*\/15 * * * *`<\/p>\n

If cron is empty, the plugin uses **`interval`** (minutes) with an initial **`bootTime`** delay (seconds).<\/p>\n

—<\/p>\n

### Performance Tuning Guide<\/p>\n

* **Java 21+ (virtual threads):** Keep `performance.maxParallel` higher (e.g., 8\u201316) for many small artifacts.
\n* **Java 11+ (HTTP\/2):** Great default throughput. Tune `maxPerHost` if a single origin hosts most of your jars.
\n* **Java 8:** Increase `readTimeoutMs` if you see timeouts on large downloads; lower `maxParallel` if network is
\n saturated.
\n* **Retries:** The plugin retries **`maxRetries`** times with exponential backoff (`backoffBaseMs` \u2192 `backoffMaxMs`).
\n* **Per-download timeout:** Set `perDownloadTimeoutSec` to protect against stuck transfers; keep `0` to disable.
\n* **I\/O Paths:** Put `tempPath`\/`updatePath` on fast local storage if possible.<\/p>\n

—<\/p>\n

## Commands & Permissions<\/p>\n

### Commands<\/p>\n

* **`\/update`** – Trigger an update run.
\n* **`\/aup download [names…]`** – Update all, or only the named plugins.
\n* **`\/aup update [names…]`** – Alias of `download`.
\n* **`\/aup stop`** – Request to stop the current updating process.
\n* **`\/aup reload`** – Reload the plugin configuration.
\n* **`\/aup add `** – Add a new entry to `list.yml`.
\n* **`\/aup remove `** – Remove an entry from `list.yml`.
\n* **`\/aup list [page]`** – View the configured plugin list.
\n* **`\/aup debug `** – Toggle verbose logging and persist the setting.
\n* **`\/aup enable|disable `** – Toggle an entry (comment\/uncomment in `list.yml`).<\/p>\n

### Permissions<\/p>\n

* `autoupdateplugins.update` – Allows `\/update`.
\n* `autoupdateplugins.manage` – Allows `\/aup …` commands.<\/p>\n

> **Heads-up:** Most servers still require a **restart** to load updated jars. The plugin handles download & staging;
\n> you decide when to reboot (auto-restart available via `behavior.restartAfterUpdate`).<\/p>\n

—<\/p>\n

## How It Works (Under the Hood)<\/p>\n

1. **Discovery.** For each entry in `list.yml`, the plugin detects the provider (GitHub, Jenkins, SpigotMC, etc.) and
\n computes the **latest matching artifact** using your selectors.
\n2. **Download (async).** Files are fetched with pooled connections; on Java 11+ it uses the HTTP\/2 client; on Java 21+
\n it schedules downloads on virtual threads when available.
\n3. **Validation.** Optional **zip integrity** checks and duplicate detection (`name + size`) avoid unnecessary writes.
\n4. **Staging & Atomic Replace.** Files are written to a **temp** directory, then moved atomically into the *
\n *update\/plugins** target so the server is never left in a partial state.
\n5. **Repeat.** According to your **interval** or **cron** schedule, with retries\/backoff on transient failures.<\/p>\n

—<\/p>\n

## Examples for Every Source<\/p>\n

> **Patterns below are illustrative.** Use your project\u2019s actual URLs and apply selectors as needed.<\/p>\n

* **GitHub Releases (pick 2nd asset, spigot-only):**<\/p>\n

“`
\n MyPlugin: “https:\/\/github.com\/Owner\/MyPlugin[2]?get=.*spigot.*\\.jar”
\n “`
\n* **GitHub Actions (latest alpha artifact, fallback to source build):**<\/p>\n

“`
\n MyActionsPlugin: “https:\/\/github.com\/Owner\/MyActionsPlugin\/actions?alpha=true&artifact=1”
\n MyActionsPluginSource: “https:\/\/github.com\/Owner\/MyActionsPlugin?autobuild=true”
\n “`
\n* **Jenkins (match shaded jar; select by index with `[N]`):**<\/p>\n

“`
\n CoolThing: “https:\/\/ci.example.com\/job\/CoolThing\/lastSuccessfulBuild\/artifact\/?get=.*-all\\.jar”
\n # second artifact
\n CoolThingAlt: “https:\/\/ci.example.com\/job\/CoolThing\/lastSuccessfulBuild\/artifact\/[2]”
\n “`
\n* **SpigotMC (resource page):**<\/p>\n

“`
\n ViaVersion: “https:\/\/www.spigotmc.org\/resources\/viaversion.19254\/”
\n “`
\n* **dev.bukkit:**<\/p>\n

“`
\n Vault: “https:\/\/dev.bukkit.org\/projects\/vault”
\n “`
\n* **Modrinth (match platform flavor, latest alpha build):**<\/p>\n

“`
\n Fancy: “https:\/\/modrinth.com\/plugin\/fancy?alpha=true&get=.*(paper|spigot).*\\.jar”
\n “`
\n* **Hangar (snapshot channel):**<\/p>\n

“`
\n HangarThing: “https:\/\/hangar.papermc.io\/Owner\/Project?channel=Alpha&get=.*spigot.*\\.jar”
\n “`
\n* **CurseForge (filter file name):**<\/p>\n

“`
\n CFThing: “https:\/\/www.curseforge.com\/minecraft\/bukkit-plugins\/cfthing\/files?get=.*release.*\\.jar”
\n “`
\n* **Generic direct jar:**<\/p>\n

“`
\n DirectJar: “https:\/\/downloads.example.com\/plugins\/DirectJar-1.2.3.jar”
\n “`
\n* **Local file (patched jar on disk):**<\/p>\n

“`
\n PatchedPlugin: “file:\/home\/me\/builds\/PatchedPlugin.jar”
\n “`
\n* **Local script (builds jar and prints path):**<\/p>\n

“`
\n PatchedPlugin: “script:.\/scripts\/build-plugin.sh”
\n “`<\/p>\n

—<\/p>\n

## Troubleshooting & FAQ<\/p>\n

**Q: Updates downloaded, but server didn\u2019t change.**
\nA: Most platforms load jars only at startup. **Restart** your server after a run. Avoid hot-reloaders for complex
\nplugins.<\/p>\n

**Q: GitHub rate-limited \/ cannot access Actions artifacts.**
\nA: Add a **GitHub PAT** in `config.yml` \u2192 `updates.key`. For private repos, ensure the token has read access to
\nReleases\/Actions artifacts.<\/p>\n

**Q: Wrong file selected.**
\nA: Add a **`?get=regex`** or use **`[N]`** to pick an asset index. Confirm the regex escapes dots (e.g., `\\.jar`).<\/p>\n

**Q: Timeouts or slow downloads.**
\nA: Increase `readTimeoutMs`; decrease `maxParallel`; or set `perDownloadTimeoutSec` and tune `maxRetries`\/backoff.<\/p>\n

**Q: Need pre-releases.**
\nA: Use per-link flags like `?prerelease=true`, `?beta=true`, `?alpha=true`, or `?latest=true` (works on GitHub,
\nModrinth, and Hangar). Hangar also respects `?channel=Alpha`\/`Beta`. Set `behavior.allowPreRelease: true` if you want
\nthis to be the default.<\/p>\n

**Q: Behind a corporate proxy.**
\nA: Configure `proxy.type\/host\/port`. If your proxy MITM-s TLS, ensure the Java trust store has the proxy CA.<\/p>\n

**Q: Build from source didn\u2019t trigger.**
\nA: Ensure `behavior.autoCompile.enable: true` and use `?autobuild=true` or let it kick in when no jar asset exists. The
\nserver must have outbound network access.<\/p>\n

—<\/p>\n

## Building from Source<\/p>\n

Use **Maven**:<\/p>\n

“`bash
\nmvn -DskipTests package
\n“`<\/p>\n

The built `.jar` will be in `target\/`.<\/p>\n

—<\/p>\n

## Security Notes<\/p>\n

* Prefer **least-privileged tokens**. For GitHub, use a PAT limited to the repos you need with read permissions
\n sufficient for Releases\/Actions artifacts.
\n* Treat third-party download links as untrusted: keep `zipFileCheck: true`.
\n* Consider pinning sources with `?get=regex` to avoid accidentally switching to platform-incompatible jars.<\/p>\n

—<\/p>\n

## Contributing, Issues & Support<\/p>\n

* **Bugs \/ Feature requests:** Open an issue:
\n https:\/\/github.com\/NewAmazingPVP\/AutoUpdatePlugins\/issues
\n* PRs welcome! Please keep code style consistent and include a brief test plan in your PR description.<\/p>\n

—<\/p>\n

## Acknowledgements<\/p>\n

**This is the original AutoUpdatePlugins project.** There are several forks of this plugin in the community; many of
\ntheir good ideas and improvements have been incorporated here over time as well. Thanks especially to contributors and
\nprojects like ApliNi\/AutoUpdatePlugins and others for inspiration and features.<\/p>\n

—<\/p>\n

## License<\/p>\n

AutoUpdatePlugins is licensed under the **MIT License**. See **`LICENSE`** for details.<\/p>\n

—<\/p>\n

### Changelog Snapshot (v12.x)<\/p>\n

* Expanded provider coverage and smarter selection (`[N]`, `?get=regex`, `?prerelease`, `?autobuild`).
\n* HTTP stack upgrades (HTTP\/2 on Java 11+, virtual threads on Java 21+).
\n* Better parallelism, retry\/backoff, and connection pooling defaults.
\n* Comment-preserving config regeneration and richer scheduling controls.<\/p>\n

—<\/p>\n","protected":false},"excerpt":{"rendered":"

(Original AutoUpdatePlugins)
\nAutomatically update any plugin you wish!<\/p>\n","protected":false},"featured_media":23939,"template":"","meta":{"_minecraft_slug":"autoupdateplugin","_minecraft_project_id":"PLCVxvPs","_minecraft_author":"NewAmazingPVP","_minecraft_license":"MIT","_minecraft_downloads":7874,"_minecraft_follows":6,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"autoupdateplugin.zip","_minecraft_size_bytes":8214640,"_minecraft_version_count":2,"_minecraft_updated_at":"2026-05-16T02:25:52.472382Z","_minecraft_date_created":"2025-08-25T22:10:48.195937Z","_minecraft_date_modified":"2026-01-22T03:30:33.556114Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/autoupdateplugin","_minecraft_icon_attachment_id":23939,"_minecraft_imported_at":"2026-06-01T08:04:13+00:00","_minecraft_import_hash":"1a179ed9537421b172a8d7b9eeb834bf","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,894,125,126,127,128,129,123,92,985,992],"mod_loader":[130,895,131,132,133,134,986,993],"minecraft_version":[339,340,341,357,359,360,379,382,385,438,446,449,110,111,112,113,114,115,116,117,118,119,120,46,47,48,49,50,51,52,53,54,55,56,57,58,59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82,22,23,24,25,26,27,28,29,30,31,860,861,862,863,864],"class_list":["post-23938","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-bungeecord","mod_category-folia","mod_category-management","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_category-technology","mod_category-utility","mod_category-velocity","mod_category-waterfall","mod_loader-bukkit","mod_loader-bungeecord","mod_loader-folia","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","mod_loader-velocity","mod_loader-waterfall","minecraft_version-1-10","minecraft_version-1-10-1","minecraft_version-1-10-2","minecraft_version-1-11","minecraft_version-1-11-1","minecraft_version-1-11-2","minecraft_version-1-12","minecraft_version-1-12-1","minecraft_version-1-12-2","minecraft_version-1-13","minecraft_version-1-13-1","minecraft_version-1-13-2","minecraft_version-1-14","minecraft_version-1-14-1","minecraft_version-1-14-2","minecraft_version-1-14-3","minecraft_version-1-14-4","minecraft_version-1-15","minecraft_version-1-15-1","minecraft_version-1-15-2","minecraft_version-1-16","minecraft_version-1-16-1","minecraft_version-1-16-2","minecraft_version-1-16-3","minecraft_version-1-16-4","minecraft_version-1-16-5","minecraft_version-1-17","minecraft_version-1-17-1","minecraft_version-1-18","minecraft_version-1-18-1","minecraft_version-1-18-2","minecraft_version-1-19","minecraft_version-1-19-1","minecraft_version-1-19-2","minecraft_version-1-19-3","minecraft_version-1-19-4","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9","minecraft_version-1-8","minecraft_version-1-8-1","minecraft_version-1-8-2","minecraft_version-1-8-3","minecraft_version-1-8-4","minecraft_version-1-8-5","minecraft_version-1-8-6","minecraft_version-1-8-7","minecraft_version-1-8-8","minecraft_version-1-8-9","minecraft_version-1-9","minecraft_version-1-9-1","minecraft_version-1-9-2","minecraft_version-1-9-3","minecraft_version-1-9-4"],"yoast_head":"\nAutoUpdatePlugins - Minecraft<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/vpesports.com\/minecraft\/mods\/autoupdateplugin\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"AutoUpdatePlugins - Minecraft\" \/>\n<meta property=\"og:description\" content=\"(Original AutoUpdatePlugins) Automatically update any plugin you wish!\" \/>\n<meta property=\"og:url\" content=\"https:\/\/vpesports.com\/minecraft\/mods\/autoupdateplugin\/\" \/>\n<meta property=\"og:site_name\" content=\"Minecraft\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"15 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/autoupdateplugin\\\/\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/autoupdateplugin\\\/\",\"name\":\"AutoUpdatePlugins - Minecraft\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/autoupdateplugin\\\/#primaryimage\"},\"image\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/autoupdateplugin\\\/#primaryimage\"},\"thumbnailUrl\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/autoupdateplugin-icon-e00d21e6359fddb9f43c235cd8db18819344be6d_96.webp\",\"datePublished\":\"2026-06-01T08:04:12+00:00\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/autoupdateplugin\\\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/autoupdateplugin\\\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/autoupdateplugin\\\/#primaryimage\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/autoupdateplugin-icon-e00d21e6359fddb9f43c235cd8db18819344be6d_96.webp\",\"contentUrl\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/autoupdateplugin-icon-e00d21e6359fddb9f43c235cd8db18819344be6d_96.webp\",\"width\":96,\"height\":96},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/autoupdateplugin\\\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Mods\",\"item\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"AutoUpdatePlugins\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/#website\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/\",\"name\":\"Minecraft\",\"description\":\"\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"AutoUpdatePlugins - Minecraft","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/vpesports.com\/minecraft\/mods\/autoupdateplugin\/","og_locale":"en_US","og_type":"article","og_title":"AutoUpdatePlugins - Minecraft","og_description":"(Original AutoUpdatePlugins) Automatically update any plugin you wish!","og_url":"https:\/\/vpesports.com\/minecraft\/mods\/autoupdateplugin\/","og_site_name":"Minecraft","twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"15 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/vpesports.com\/minecraft\/mods\/autoupdateplugin\/","url":"https:\/\/vpesports.com\/minecraft\/mods\/autoupdateplugin\/","name":"AutoUpdatePlugins - Minecraft","isPartOf":{"@id":"https:\/\/vpesports.com\/minecraft\/#website"},"primaryImageOfPage":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/autoupdateplugin\/#primaryimage"},"image":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/autoupdateplugin\/#primaryimage"},"thumbnailUrl":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/autoupdateplugin-icon-e00d21e6359fddb9f43c235cd8db18819344be6d_96.webp","datePublished":"2026-06-01T08:04:12+00:00","breadcrumb":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/autoupdateplugin\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/vpesports.com\/minecraft\/mods\/autoupdateplugin\/"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/vpesports.com\/minecraft\/mods\/autoupdateplugin\/#primaryimage","url":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/autoupdateplugin-icon-e00d21e6359fddb9f43c235cd8db18819344be6d_96.webp","contentUrl":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/autoupdateplugin-icon-e00d21e6359fddb9f43c235cd8db18819344be6d_96.webp","width":96,"height":96},{"@type":"BreadcrumbList","@id":"https:\/\/vpesports.com\/minecraft\/mods\/autoupdateplugin\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/vpesports.com\/minecraft\/"},{"@type":"ListItem","position":2,"name":"Mods","item":"https:\/\/vpesports.com\/minecraft\/mods\/"},{"@type":"ListItem","position":3,"name":"AutoUpdatePlugins"}]},{"@type":"WebSite","@id":"https:\/\/vpesports.com\/minecraft\/#website","url":"https:\/\/vpesports.com\/minecraft\/","name":"Minecraft","description":"","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/vpesports.com\/minecraft\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"}]}},"_links":{"self":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod\/23938","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod"}],"about":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/types\/mod"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/media\/23939"}],"wp:attachment":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/media?parent=23938"}],"wp:term":[{"taxonomy":"mod_category","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod_category?post=23938"},{"taxonomy":"mod_loader","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod_loader?post=23938"},{"taxonomy":"minecraft_version","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/minecraft_version?post=23938"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}