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
- Edition: Minecraft Java
- File type: .jar
- Minecraft versions listed: 26.1, 26.1.1, 26.1.2
- How to install: Install the matching mod loader (Forge, Fabric or NeoForge) for your Minecraft version. → Download the .jar. → Put it in the .minecraft/mods folder and launch that loader profile.
- Where to get it: Opens on Modrinth — not every file is mirrored on our own servers.
Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.
- Ships as VersionEye-1.4.0.jar — drop this file into the mods folder
- Download size: 46 KB
- Download link checked 15 Sept 2026 — working
These come from our own check of the pack file, not from the source page.