viGeyserUpdater

Overview
viGeyserUpdater keeps your Geyser companion plugins and extensions up to date automatically or through administrator commands.
It currently includes update presets for:

• GeyserModelEngine
• GeyserModelEngineExtension
• GeyserUtils for Bukkit
• GeyserUtils for Velocity
• GeyserUtils Geyser Extension
• Boar

Every managed artifact can be enabled or disabled independently in the configuration.
Features

• Automatic and manual update modes
• Paper, Spigot, Folia, and Velocity support
• GitHub Releases and Modrinth providers
• Independent enable/disable setting for every artifact
• HTTPS host allowlisting and redirect validation
• Connection timeout and bounded download protection
• Exponential retry for connection failures, HTTP 429, and HTTP 5xx
• SHA-256 verification when supplied by the upstream provider
• JAR structure validation before installation
• Atomic transaction journal and interrupted-update recovery
• Protection against path traversal and ambiguous JAR matching
• Dedicated worker thread without blocking the main server thread
• Folia-safe command response dispatch

Installation

1. Download the Bukkit JAR from this page.
2. Place it inside your server's plugins directory.
3. Start the server once to generate the configuration.
4. Review plugins/viGeyserUpdater/config.yml.
5. Enable or disable the artifacts you want to manage.

[WARNING]A full server restart is required after an update has been installed. Plugin reloaders are not supported.[/WARNING]
Commands
Command alias:
Required permission:
The permission is granted to server operators by default.
Automatic Update Modes
Automatic download and installation:
Check automatically without installing:
Manual mode only:
Important Notes

• Java 21 is required.
• A local Geyser installation is required when managing Geyser extensions.
• The default Geyser directory is plugins/Geyser-Spigot.
• Custom installation paths can be configured.
• If an update host remains unavailable, the installed JAR and state are preserved.
• On Windows, an open JAR may be locked by the filesystem. Stop the server and replace that artifact manually if this occurs.

Open Source
viGeyserUpdater is an original open-source implementation distributed under the MIT License.
Source code:
GitHub Repository
Issues and support:
GitHub Issues