A Paper plugin that checks your installed plugins for updates on
Modrinth and can download them for you. Updates
are reported in the console, to ops when they join, on demand with
/updatecheck, and optionally to a Discord webhook. All checks run off
the main thread. Works on Paper, Purpur, and Folia.
Plugins are identified by the sha512 hash of their jar, so they are matched to their exact Modrinth project and release with no name guessing. Jars Modrinth doesn't know fall back to name matching, and plugins that aren't on Modrinth at all (like ProtocolLib) are looked up on Hangar as a last resort. Alpha and beta builds are ignored unless enabled.
Commands and permissions
| Command | Permission | Default |
|---|---|---|
/updatecheck |
versioneye.check |
op |
/updatecheck -prerelease (include alpha/beta uploads for this check) |
versioneye.check |
op |
/updatecheck download [plugin] (fetch updates, applied on restart) |
versioneye.download |
op |
/updatecheck ignore <plugin> (mute the current update until a newer one) |
versioneye.ignore |
op |
/updatecheck unignore <plugin> |
versioneye.ignore |
op |
/updatecheck reload (re-read config.yml without a restart) |
versioneye.reload |
op |
| Join notifications | versioneye.notify |
op |
Config
| Option | Default | What it does |
|---|---|---|
check-interval-hours |
6 |
How often to re-check (0 = startup only) |
notify-on-join |
true |
Notify permitted players on join |
require-matching-game-version |
false |
Only count releases tagged for your MC version |
include-prereleases |
false |
Also count alpha/beta uploads as updates |
check-hangar |
true |
Fall back to Hangar for plugins not on Modrinth |
auto-download |
false |
Download updates into plugins/update automatically |
discord-webhook |
"" |
Post new updates to a Discord webhook |
ignored-versions |
{} |
Muted updates, managed by /updatecheck ignore |
overrides |
{} |
Pin a plugin to a Modrinth slug or hangar:<slug> |
exclude |
[VersionEye] |
Plugins to skip |
Downloaded updates go to the server's update folder under the installed jar's filename and are verified against the source's published hash; Paper swaps them in on the next restart.
If a plugin shows as not found or matches the wrong project, pin it to a Modrinth slug or a Hangar project slug, or exclude it:
overrides:
Essentials: essentialsx
ProtocolLib: hangar:ProtocolLib
exclude:
- SomeWeirdPlugin
