A PaperMC plugin that automatically keeps ViaVersion up to date by checking the GitHub Releases API and downloading the latest jar into your plugins/ folder.
- Automatic updates – Checks for a new ViaVersion release on server start and on a configurable schedule.
- Manual control – Use
/viaupdater checkor/viaupdater updateto trigger a check or force-download at any time. - Safe download – Downloads to a temp file first, then atomically replaces the target. Follows HTTP redirects.
- Old jar cleanup – Removes the previously installed ViaVersion jar after a successful download.
- Tab-completion for all sub-commands.
| Requirement | Version |
|---|---|
| Java | 17+ |
| Paper | 1.21+ |
- Download the latest
viaversion-auto-update-<version>.jarfrom Releases. - Drop it into your server's
plugins/folder alongside ViaVersion. - Start (or restart) the server.
plugins/ViaVersionAutoUpdate/config.yml:
# Whether the plugin should automatically check and download updates.
auto-update: true
# How often (in minutes) the plugin checks for a new release.
check-interval-minutes: 60| Command | Description | Permission |
|---|---|---|
/viaupdater check |
Check GitHub and download if a newer version exists | viaversionautoupdate.admin |
/viaupdater update |
Force-download the latest ViaVersion | viaversionautoupdate.admin |
/viaupdater help |
Show command help | viaversionautoupdate.admin |
viaversionautoupdate.admin defaults to op.
mvn packageThe compiled jar will be at target/viaversion-auto-update-<version>.jar.
- On enable (and then every
check-interval-minutes), the plugin calls the GitHub API:
GET https://api.github.com/repos/ViaVersion/ViaVersion/releases/latest - It reads the
tag_namefield from the JSON response. - If the installed ViaVersion jar does not already contain that version string in its file name, the new jar is downloaded from GitHub Releases.
- The old jar is deleted. A server restart is required for Minecraft to load the new version.