Plugin Updater

Minecraft 版本： 1.21 1.21.1 1.21.2 1.21.3 1.21.4 1.21.5 1.21.6 1.21.7 1.21.8 1.21.9 1.21.10 1.21.11

平台： folia paper purpur

标签： management utility

---

? 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

1. Download: Grab the latest JAR from Releases.
2. Install: Drop PluginUpdater-1.0.1-SNAPSHOT.jar into your plugins/ folder.
3. Restart: Start your server.
4. 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 ` | `pluginupdater.download.update` | Download updates. **Requires restart to apply.** | | `/pluginupdate backup [plugin]` | `pluginupdater.download.backup` | Manually backup a plugin. | | `/pluginupdate restore ` | `pluginupdater.download.restore` | Restore a plugin from a specific backup. | | `/pluginupdate list-backups ` | `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 `/updates` for 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. ```yaml 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-version` in `config.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

---