AutoUpdatePlugins

AutoUpdatePlugins v12.1.2

Keep your server’s plugins up-to-date — automatically, safely, and across platforms.

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.

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.
Smart file selection. Use ?get=<regex>, [N] (pick the N-th asset — works for both GitHub and Jenkins artifacts), ?prerelease=true, ?autobuild=true (force source build) to precisely target the artifact you want.
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.

Supported Sources & Platforms

Download Sources

Source	Release/Build Discovery	Notes / Selectors Supported
GitHub	Releases & Actions	`[N]`, `?get=regex`, `?prerelease=true`, `?autobuild=true`
Jenkins	Latest build artifacts	`[N]`, `?get=regex`
SpigotMC (Spiget)	Resource page URL	Auto-resolves latest
dev.bukkit	Project page	Auto-resolves latest
Modrinth	Project/version URL	`?get=regex`
Hangar	Project/releases	`?get=regex`
BusyBiscuit	Project index	Auto-resolves
blob.build	Build artifacts	`?get=regex`
Guizhanss v2	Project index	Auto-resolves
MineBBS	Resource page	Auto-resolves
CurseForge	Project/files	`?get=regex`
Generic	Direct `.jar` link	Exact file URL

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

Server Platforms

Spigot, Paper, Folia
Velocity, BungeeCord

Minecraft & Java

Minecraft: 1.8 → Latest
Java: 8+ (uses advanced features automatically on 11+ and 21+)

Requirements

Java 8 or newer.
- Uses Java 11+ HTTP/2 client when available.
- Uses Java 21+ virtual threads when available.
Network access for source builds (Gradle/Maven wrappers or system gradle/mvn, if used).

Installation

Download the latest .jar from Spigot.
Place it into your server’s plugins/ directory.
Start the server to generate default config files.
Edit plugins/AutoUpdatePlugins/config.yml and plugins/AutoUpdatePlugins/list.yml.
Run /update or /aup update (or restart) to kick off the first check.

Velocity / BungeeCord: Same process — drop the jar in plugins/, configure, then trigger an update run.

Quick Start

Add a few entries to list.yml:

ViaVersion: "https://www.spigotmc.org/resources/viaversion.19254/"
Geyser: "https://download.geysermc.org/v2/projects/geyser/versions/latest/builds/latest/downloads/spigot"
EssentialsXChat: "https://github.com/EssentialsX/Essentials[3]"

Leave updates.interval at the default (every 120 minutes), or set a cron schedule.
Optional: Add a GitHub token in config.yml to avoid rate limits.
Trigger a run:
```
/update
```
New jars are staged atomically in your plugins folder (using temp/update paths under the hood). Restart the server to load the updated jars.

Configuration

`config.yml`

The plugin adds new options automatically without overwriting your comments. Below is the full schema with defaults and notes.

################################################################################
# AutoUpdatePlugins — Main Configuration
################################################################################

updates:
  # How often to run plugin updates (minutes). Default: 120 (every 2 hours)
  interval: 120

  # Delay after server startup (seconds) before the first run. Default: 50
  bootTime: 50

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

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

# HTTP configuration (optional)
http:
  # If blank, a rotating pool of realistic User-Agents will be used.
  userAgent: ""
  # Extra request headers added to every request. Only add if you know you need it.
  headers: []
  # Verify TLS certificates (set to false to trust all; only if you must)
  sslVerify: true
  # Optional pool of User-Agents; the plugin will rotate between them to avoid
  # strict CDNs blocking automation.
  userAgents:
    - { ua: "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/123.0.0.0 Safari/537.36" }
    - { 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" }
    - { ua: "Mozilla/5.0 (X11; Linux x86_64; rv:126.0) Gecko/20100101 Firefox/126.0" }

# Proxy configuration (optional)
proxy:
  type: "NONE" # HTTP | SOCKS | (anything else = disabled)
  host: "proxy.example"
  port: 8080

# Behavior toggles
behavior:
  useUpdateFolder: true
  # Open downloaded .jar/.zip to ensure integrity before install (recommended)
  zipFileCheck: true
  # Skip replacing an existing plugin if the new jar has the same MD5
  ignoreDuplicates: true
  # Allow GitHub pre-releases by default for release queries.
  allowPreRelease: false
  # Enable source-build fallback for GitHub repositories.
  autoCompile:
    enable: false
    # Build when a release has no .jar asset (zip-only)
    whenNoJarAsset: false
    # Build from source if default branch is newer than latest (pre)release by N months
    branchNewerMonths: 6
  # Verbose debug logging. Toggle with /aup debug on|off
  debug: false



# Optional custom paths
paths:
  tempPath: ''
  updatePath: ''
  filePath: ''

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

# Plugins List Configuration
# Edit the generated list.yml in this folder. Format:
#   {FileSaveName}: {link.to.plugin}
#
# Example list.yml template: https://github.com/NewAmazingPVP/AutoUpdatePlugins/blob/main/list.yml
# Examples:
#   ViaVersion: "https://www.spigotmc.org/resources/viaversion.19254/"
#   Geyser: "https://download.geysermc.org/v2/projects/geyser/versions/latest/builds/latest/downloads/spigot"
#   EssentialsXChat: "https://github.com/EssentialsX/Essentials[3]"
#
# Supported sources: GitHub (Releases & Actions), Jenkins, SpigotMC (Spiget), dev.bukkit, Modrinth, Hangar,
# BusyBiscuit, blob.build, Guizhanss v2, MineBBS, CurseForge, plus generic pages with direct .jar links.
#
# Tips:
# - Select assets: append [N] to pick the Nth asset or use ?get=<regex> to match by filename.
# - Pre-releases: set behavior.allowPreRelease: true or append ?prerelease=true on a GitHub link.
# - Force source build from GitHub: append ?autobuild=true to a GitHub repo URL.

Key options explained

updates.schedule.cron + timezone — When set, cron overrides interval/bootTime.
updates.key — GitHub PAT for Releases/Actions access and higher rate limits (especially useful for public repos under heavy use or any private repos).
http.userAgents — Simple rotation to avoid brittle server-side filters.
proxy — Full support for HTTP/SOCKS proxies.
behavior.autoCompile — For GitHub repos: if there’s no release jar (or if the branch is newer than the last release by branchNewerMonths), the repo can be built from source using Gradle/Maven.
behavior.zipFileCheck — Open downloaded jars/zips to ensure they aren't corrupt before install.
behavior.ignoreDuplicates — Skip replacing a plugin if the new jar has the same MD5.
behavior.useUpdateFolder — Stage new jars in the server’s update/ directory for atomic swaps.
behavior.debug — Verbose logging toggle, also controllable via /aup debug.
paths — Customize temp/staging/output locations (falls back to sane defaults).
performance — See Performance Tuning Guide.

`list.yml`

A simple mapping of plugin display name ➜ source URL (+ optional selectors).

# A list of plugins to update.
# Format: <plugin-name>: <download-url>

ViaVersion: "https://www.spigotmc.org/resources/viaversion.19254/"
Geyser: "https://download.geysermc.org/v2/projects/geyser/versions/latest/builds/latest/downloads/spigot"
EssentialsXChat: "https://github.com/EssentialsX/Essentials[3]"

Comment out a line with # to temporarily disable an entry. The /aup enable and /aup disable commands toggle this for you.

Selectors you can use

[N] — Select the N-th jar asset (1-indexed) from a release or Jenkins build page. Example: .../Essentials[3]
?get=<regex> — Choose files whose names match a regex. Example: ?get=.*(paper|spigot).*\.jar
?prerelease=true — Permit pre-releases.
?autobuild=true — Force a source build on GitHub even if a jar asset exists.

Pro tip: Combine selectors, e.g. ...?prerelease=true&get=.*spigot.*\.jar.

Scheduling Cheat Sheet

Common cron expressions (with examples using America/New_York):

Every 2 hours: 0 */2 * * *
Every day at 05:00: 0 5 * * *
Every Monday & Thursday at 03:30: 30 3 * * 1,4
Every 15 minutes: */15 * * * *

If cron is empty, the plugin uses interval (minutes) with an initial bootTime delay (seconds).

Performance Tuning Guide

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

Commands & Permissions

Commands

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

Permissions

autoupdateplugins.update — Allows /update.
autoupdateplugins.manage — Allows /aup ... commands.

Heads-up: Most servers still require a restart to load updated jars. The plugin handles download & staging; you decide when to reboot.

How It Works (Under the Hood)

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

Examples for Every Source

Patterns below are illustrative. Use your project’s actual URLs and apply selectors as needed.

GitHub Releases (pick 2nd asset, spigot-only):

MyPlugin: "https://github.com/Owner/MyPlugin[2]?get=.*spigot.*\\.jar"

GitHub Actions (force build from source if no jar):

MyActionsPlugin: "https://github.com/Owner/MyActionsPlugin?autobuild=true"

Jenkins (match shaded jar; select by index with [N]):

CoolThing: "https://ci.example.com/job/CoolThing/lastSuccessfulBuild/artifact/?get=.*-all\\.jar"
# second artifact
CoolThingAlt: "https://ci.example.com/job/CoolThing/lastSuccessfulBuild/artifact/[2]"

SpigotMC (resource page):

ViaVersion: "https://www.spigotmc.org/resources/viaversion.19254/"

dev.bukkit:

Vault: "https://dev.bukkit.org/projects/vault"

Modrinth (match platform flavor):

Fancy: "https://modrinth.com/plugin/fancy?get=.*(paper|spigot).*\\.jar"

Hangar:

HangarThing: "https://hangar.papermc.io/Owner/Project?get=.*spigot.*\\.jar"

CurseForge (filter file name):

CFThing: "https://www.curseforge.com/minecraft/bukkit-plugins/cfthing/files?get=.*release.*\\.jar"

Generic direct jar:

DirectJar: "https://downloads.example.com/plugins/DirectJar-1.2.3.jar"

Troubleshooting & FAQ

Q: Updates downloaded, but server didn’t change. A: Most platforms load jars only at startup. Restart your server after a run. Avoid hot-reloaders for complex plugins.

Q: GitHub rate-limited / cannot access Actions artifacts. A: Add a GitHub PAT in config.yml → updates.key. For private repos, ensure the token has read access to Releases/Actions artifacts.

Q: Wrong file selected. A: Add a ?get=regex or use [N] to pick an asset index. Confirm the regex escapes dots (e.g., \\.jar).

Q: Timeouts or slow downloads. A: Increase readTimeoutMs; decrease maxParallel; or set perDownloadTimeoutSec and tune maxRetries/backoff.

Q: Need pre-releases. A: Append ?prerelease=true to the URL (and ensure behavior.allowPreRelease: true if you want that globally).

Q: Behind a corporate proxy. A: Configure proxy.type/host/port. If your proxy MITM-s TLS, ensure the Java trust store has the proxy CA.

Q: Build from source didn’t trigger. A: Ensure behavior.autoCompile.enable: true and use ?autobuild=true or let it kick in when no jar asset exists. The server must have outbound network access.

Building from Source

Use Maven:

mvn -DskipTests package

The built .jar will be in target/.

Security Notes

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

Contributing, Issues & Support

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

License

AutoUpdatePlugins is licensed under the MIT License. See LICENSE for details.

Changelog Snapshot (v12.x)

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

AutoUpdatePlugins

Compatibility

Minecraft: Java Edition

Platforms

Links

Creators

Details

AutoUpdatePlugins

AutoUpdatePlugins v12.1.2

Highlights

Supported Sources & Platforms

Download Sources

Server Platforms

Minecraft & Java

Requirements

Installation

Quick Start

Configuration

`config.yml`

`list.yml`

Scheduling Cheat Sheet

Performance Tuning Guide

Commands & Permissions

Commands

Permissions

How It Works (Under the Hood)

Examples for Every Source

Troubleshooting & FAQ

Building from Source

Security Notes

Contributing, Issues & Support

License

Changelog Snapshot (v12.x)