Plugin Updater
Automatically checks for and downloads plugin updates from Modrinth.
!Banner Image Plugin Updater
PluginUpdater
The ultimate automated plugin management solution for modern Minecraft servers.
Developed by Minekarta Studio
Report Bug • Request Feature • Discord
🔥 Overview
PluginUpdater is a next-generation plugin utility designed for PaperMC 1.21+ and Folia servers. It seamlessly integrates with the Modrinth API to keep your plugins up-to-date automatically, featuring a robust backup and restore system to ensure server stability.
[!IMPORTANT] Folia Support: This plugin is fully compatible with Folia's region threading system!
✨ Key Features
| Core | Advanced |
|---|---|
| 🚀 Auto-Update Check Checks for updates on startup instantly. | 📦 Safe Downloads Auto-backup before every update. |
| 🔍 Modrinth Powered Uses the massive Modrinth database. | ↩️ Restore System Rollback if an update breaks things. |
| ⚡ Async Architecture Zero lag. All operations are non-blocking. | 📊 Smart Versioning Semver-compliant update detection. |
| 🌐 Modern Messaging Beautiful gradients and MiniMessage support. | 🔄 Multi-Platform Works on Paper, Folia, Purpur, Spigot. |
📥 Installation
- Download: Grab the latest JAR from Releases.
- Install: Drop
PluginUpdater-1.0.1-SNAPSHOT.jarinto yourplugins/folder. - Restart: Start your server.
- Verify: Look for the startup message:
[PluginUpdater] PluginUpdater v1.0.1-SNAPSHOT enabled! [PluginUpdater] Checking for plugin updates from Modrinth...
📖 User Guide
🛠️ Commands & Usage (Click to Expand)
Main Commands
| Command | Permission | Description |
|---|---|---|
/pluginupdate check [plugin] | pluginupdater.use | Check for updates for all or specific plugins. |
/pluginupdate update <plugin|all> | pluginupdater.download.update | Download updates. Requires restart to apply. |
/pluginupdate backup [plugin] | pluginupdater.download.backup | Manually backup a plugin. |
/pluginupdate restore <plugin> <time> | pluginupdater.download.restore | Restore a plugin from a specific backup. |
/pluginupdate list-backups <plugin> | pluginupdater.download.backup | See available backups for a plugin. |
/pluginupdate help | pluginupdater.use | Show the help menu. |
[!TIP] You can use aliases like
/pu,/uc, or/updatesfor quicker access!
🛡️ Permissions (Click to Expand)
| Node | Default | Description |
|---|---|---|
pluginupdater.use | OP | Basic check commands. |
pluginupdater.download.* | OP | Full access to download/backup features. |
pluginupdater.reload | OP | Reload config files. |
pluginupdater.* | OP | Wildcard for all permissions. |
⚙️ Configuration (Click to Expand)
Customize plugins/PluginUpdater/config.yml to fit your needs.
settings:
minecraft-version: '1.21'
loader: 'paper' # options: paper, purpur, spigot, bukkit
check-on-startup: true
# Prevent annoying spam?
periodic-check:
enabled: false
interval-minutes: 60
# Skip these plugins
ignored-plugins:
- 'MyCustomPrivatePlugin'
download:
require-backup: true # Highly recommended!
max-file-size-mb: 100
timeout-seconds: 60
❓ Troubleshooting
Click to view common issues
❌ Plugin Not Found
- Cause: The plugin isn't on Modrinth or uses a weird name.
- Fix: Check Modrinth for the exact slug or add to
ignored-plugins.
⚠️ No Compatible Version
- Cause: The developer hasn't marked the version as compatible with 1.21 yet.
- Fix: Check your
minecraft-versioninconfig.yml.
🚫 Permission Denied
- Cause: You aren't OP or lack nodes.
- Fix: Check your permission plugin (e.g., LuckPerms).
👨💻 For Developers
Build from source to contribute or modify.
git clone https://github.com/minekarta/PluginUpdater.git
cd PluginUpdater
mvn clean package
Artifact: target/PluginUpdater-1.0.1-SNAPSHOT.jar
Made with ❤️ by Minekarta Studio
Part of the Minekarta Server Indonesia Ecosystem