VersionEye

!VersionEye

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