🚀 AutoProxyUpdater

Keep your Velocity proxy running on the latest security and performance patches without lifting a finger.

AutoProxyUpdater is a lightweight, standalone utility designed specifically for Velocity. It ensures your proxy JAR is always up-to-date by communicating directly with the PaperMC API, handling downloads, and managing safe shutdowns.

🔄 Why AutoProxyUpdater?

Modern proxy environments require high uptime and security. Manually checking for Velocity builds is tedious. This project automates the entire lifecycle—from detecting the latest version to replacing the JAR file safely without corrupting the running process.

✨ Key Features

• Native Velocity Support: Built from the ground up for the Velocity Proxy API.
• PaperMC API v3 Integration: Uses the latest "Fill" API standards for reliable downloads.
• Smart Version Persistence: Stores the current build ID directly in your config.yml. No extra files, no redundant downloads after a restart.
• Hot-Swap Safety Logic: Instead of overwriting the active JAR (which causes NoClassDefFound errors), it renames the current JAR to .old and places the new one. This ensures a clean shutdown.
• Automatic Cleanup: Detects and deletes legacy .old files on the next successful startup to keep your root folder clean.
• Zero-Touch Configuration: On the first run, the plugin automatically detects your Velocity version (e.g., 3.4.0-SNAPSHOT) and sets up everything for you.

🛠 Configuration

The plugin generates a config.yml in its data folder. You can fine-tune the update behavior here:

# AutoProxyUpdater Configuration

# The API URL for updates. 
# LEAVE EMPTY to automatically use the latest Velocity version from PaperMC.
api-url: ""

# Path to the proxy JAR. Leave empty for auto-detection via classpath.
proxy-jar-path: ""

# Identity header for API requests
user-agent: "AutoProxyUpdater/1.3"

# Delay in seconds before shutting down after a successful download.
shutdown-delay: 3

# ------------------------------------------------------------
# DONT TOUCH! Internal state, do not modify manually.
# ------------------------------------------------------------
internal-current-build: 559

⚠️ Disclaimer

[!DANGER] Using auto-updaters in production environments is at your own risk. This plugin replaces your primary proxy JAR. Always ensure you have a robust backup system and a startup script (like a while true loop) to bring the proxy back online after it shuts down for an update.

⚖️ License

This project is licensed under the MIT License.

Developer Note: If you are also running backend servers (Paper/Purpur/Leaf), check out my companion project AutoUpdateServer!