---

🔥 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 <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 /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.

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

---