
PluginUpdater
专为现代 Minecraft 服务器打造的终极自动化插件管理方案。
由 Minekarta Studio 开发
报告 Bug • 请求功能 • Discord
? 概览
PluginUpdater 是一款面向 PaperMC 1.21+ 和 Folia 服务器的下一代插件实用工具。它无缝集成 Modrinth API,自动保持您的插件更新,并具备强大的备份与恢复系统,以确保服务器稳定性。
[!IMPORTANT]
Folia 支持: 本插件完全兼容 Folia 的区域线程系统!
✨ 主要特性
| 核心 |
高级 |
? 自动检查更新 启动时立即检查更新。 |
? 安全下载 每次更新前自动备份。 |
? Modrinth 驱动 利用庞大的 Modrinth 数据库。 |
↩️ 恢复系统 若更新导致问题可回滚。 |
⚡ 异步架构 零延迟。所有操作均为非阻塞。 |
? 智能版本控制 符合语义化版本规范的更新检测。 |
? 现代化消息传递 精美的渐变效果并支持 MiniMessage。 |
? 多平台兼容 适用于 Paper、Folia、Purpur、Spigot。 |
? 安装
- 下载:从 Releases 获取最新的 JAR 文件。
- 安装:将
PluginUpdater-1.0.1-SNAPSHOT.jar 放入您的 plugins/ 文件夹中。
- 重启:启动服务器。
- 验证:查看启动日志中的以下信息:
[PluginUpdater] PluginUpdater v1.0.1-SNAPSHOT enabled!
[PluginUpdater] Checking for plugin updates from Modrinth...
? 用户指南
?️ 命令与用法 (点击展开)
主要命令
| 命令 |
权限节点 |
描述 |
/pluginupdate check [plugin] |
pluginupdater.use |
检查所有或特定插件的更新。 |
/pluginupdate update <plugin|all> |
pluginupdater.download.update |
下载更新。需要重启才能生效。 |
/pluginupdate backup [plugin] |
pluginupdater.download.backup |
手动备份插件。 |
/pluginupdate restore <plugin> <time> |
pluginupdater.download.restore |
从特定备份时间恢复插件。 |
/pluginupdate list-backups <plugin> |
pluginupdater.download.backup |
查看某插件可用的备份列表。 |
/pluginupdate help |
pluginupdater.use |
显示帮助菜单。 |
[!TIP]
您可以使用别名如 /pu、/uc 或 /updates 以更快访问!
?️ 权限 (点击展开)
| 节点 |
默认值 |
描述 |
pluginupdater.use |
OP |
基本检查命令。 |
pluginupdater.download.* |
OP |
完整访问下载/备份功能。 |
pluginupdater.reload |
OP |
重载配置文件。 |
pluginupdater.* |
OP |
所有权限的通配符。 |
⚙️ 配置 (点击展开)
自定义 plugins/PluginUpdater/config.yml 以满足您的需求。
settings:
minecraft-version: '1.21'
loader: 'paper' # 选项: paper, purpur, spigot, bukkit
check-on-startup: true
# 防止烦人的刷屏?
periodic-check:
enabled: false
interval-minutes: 60
# 跳过这些插件
ignored-plugins:
- 'MyCustomPrivatePlugin'
download:
require-backup: true # 强烈推荐!
max-file-size-mb: 100
timeout-seconds: 60
❓ 故障排除
点击查看常见问题
❌ 未找到插件
- 原因:该插件不在 Modrinth 上,或者使用了奇怪的名称。
- 解决:在 Modrinth 上检查确切的 slug,或将其添加到
ignored-plugins 中。
⚠️ 无兼容版本
- 原因:开发者尚未将该版本标记为兼容 1.21。
- 解决:检查
config.yml 中的 minecraft-version。
? 权限被拒绝
- 原因:您不是 OP(管理员)或缺少相应权限节点。
- 解决:检查您的权限插件(例如 LuckPerms)。
?? 面向开发者
从源代码构建以便贡献或修改。
git clone https://github.com/minekarta/PluginUpdater.git
cd PluginUpdater
mvn clean package
构建产物: target/PluginUpdater-1.0.1-SNAPSHOT.jar
由 Minekarta Studio 用 ❤️ 制作
Minekarta Server Indonesia 生态系统的一部分

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.jar into your plugins/ 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 /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
评论 0
登录后参与评分
还没有评论,来抢沙发吧