Sueta

Plugin Updater

1.0.1-SNAPSHOT

Automatically checks for and downloads plugin updates from Modrinth.

·Plugin

Banner Image Plugin Updater

PluginUpdater

Java CI
Version
License
Platform

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

CoreAdvanced
🚀 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

CommandPermissionDescription
/pluginupdate check [plugin]pluginupdater.useCheck for updates for all or specific plugins.
/pluginupdate update <plugin|all>pluginupdater.download.updateDownload updates. Requires restart to apply.
/pluginupdate backup [plugin]pluginupdater.download.backupManually backup a plugin.
/pluginupdate restore <plugin> <time>pluginupdater.download.restoreRestore a plugin from a specific backup.
/pluginupdate list-backups <plugin>pluginupdater.download.backupSee available backups for a plugin.
/pluginupdate helppluginupdater.useShow the help menu.

[!TIP]
You can use aliases like /pu, /uc, or /updates for quicker access!

🛡️ Permissions (Click to Expand)
NodeDefaultDescription
pluginupdater.useOPBasic check commands.
pluginupdater.download.*OPFull access to download/backup features.
pluginupdater.reloadOPReload config files.
pluginupdater.*OPWildcard 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


Made with ❤️ by Minekarta Studio
Part of the Minekarta Server Indonesia Ecosystem

Similar projects

Plugin →