?
Host a server
Modrinth App
Sign in
ModsPluginsData PacksShadersResource PacksModpacks
Settings
Plugin Updater

Plugin Updater

Automatically checks for and downloads plugin updates from Modrinth.

34
0

Compatibility

Minecraft: Java Edition

1.21.x

Platforms

Creators

Minekarta Studio
Minekarta Studio Organization

Details

Licensed MIT
Published last week
Updated 3 days ago

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

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

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