PluginUpdater-WB ?
一款高度先进、完全异步的 Paper 服务器插件管理器与更新器。
版本: 26.3-1.0.0 | API 版本: 26.3 | Java: 25+ | 作者: WebBeck
? 功能简介
PluginUpdater-WB 自动保持你的 Paper 服务器插件处于最新状态。它会在多个插件仓库(Modrinth、Hangar、GitHub Releases 和 SpigotMC)中检查新版本,然后异步下载并安装更新,以确保服务器的响应能力。它还支持直接自定义下载 URL,并原生管理 Geyser 生态系统的插件(Geyser、Floodgate、MCXboxBroadcast)。
✨ 特性
- 多源更新检查 — Modrinth、Hangar、GitHub Releases、SpigotMC 以及自定义 URL
- 完全异步 — 所有网络和 I/O 操作均在主线程之外运行
- 按插件配置 — 可为每个插件单独跟踪
release、beta、alpha 或 all 频道
- 自动检测 — 启动时扫描已加载的插件,并自动生成配置文件条目
- Geyser 插件管理 — 对 Geyser、Floodgate 和 MCXboxBroadcast 提供一流支持
- 备份支持 — 在覆盖之前备份插件 jar 文件
- 细粒度权限控制 — 提供
pluginupdater.admin 权限节点,并支持特定玩家的白名单
- 服务器类型感知 — 支持 Paper、Purpur、Folia、Spigot 和 Bukkit 加载器目标
? 要求
- 运行 API 版本 26.3 的 Paper(或兼容分支)
- Java 25 或更高版本
? 安装
- 下载
PluginUpdater-WB-26.3-1.0.0.jar 并将其放入服务器的 plugins/ 文件夹中。
- 启动(或重启)服务器。插件将生成
config.yml 并为当前加载的每个插件自动填充条目。
- 编辑
config.yml 以启用或调整对每个插件的跟踪(参见下方的 配置)。
- 运行
/upd reload 而无需重启即可应用更改。
⚙️ 配置
config.yml 将在首次运行时生成。关键选项如下:
# 用于 Modrinth 查询的 Minecraft 版本。留空以自动检测。
minecraft-version: '26.3'
# 允许在不拥有 OP 或权限节点的情况下运行命令的玩家。
allowed-players:
- 'YourUsernameHere'
# 发送给 Modrinth 的加载器类型。"auto" 会在运行时检测 Paper/Spigot 等。
# 有效值:"auto", "paper", "purpur", "folia", "spigot", "bukkit"
server-type-override: 'paper'
# 所有插件的全局发布频道。
# 有效值:"release", "beta", "alpha", "all"
tracking-type: 'all'
# Geyser 插件管理(Geyser, Floodgate, MCXboxBroadcast)
geyser-addons:
enabled: false
Geyser: true
Floodgate: true
MCXboxBroadcast: true
插件条目
plugins: 键下的每个插件支持以下五种来源类型之一:
plugins:
# Modrinth
MyPlugin:
enabled: true
type: MODRINTH
project-id: osLrA9oB
allowed-release-types:
- release
current-version: 1.0.0
# GitHub Releases
AnotherPlugin:
enabled: true
type: GITHUB
github-repo: owner/repository
allowed-release-types:
- release
current-version: 2.0.0
# Hangar (PaperMC)
HangarPlugin:
enabled: true
type: HANGAR
project-id: ViaVersion
allowed-release-types:
- release
current-version: 5.0.0
# SpigotMC(来自 URL 的数字资源 ID)
SpigotPlugin:
enabled: true
type: SPIGOT
project-id: '19254'
allowed-release-types:
- release
current-version: 1.0.0
# 自定义 URL(始终下载;跳过版本检查逻辑)
CustomPlugin:
enabled: true
type: CUSTOM
custom-url: 'https://example.com/downloads/CustomPlugin-latest.jar'
current-version: 1.0.0
jar 包内包含一个名为 common-plugins.yml 的常见插件模板参考文件。
? 命令
主命令为 /updater(别名:/upd)。需要 pluginupdater.admin 权限或 OP(可配置)。
| 命令 |
描述 |
/upd help |
显示所有命令(点击其中一个即可使用) |
/upd check |
检查所有插件是否有更新 |
/upd update [plugin] |
安装待处理的更新(全部,或仅某个插件) |
/upd list [all|enabled|disabled] |
显示待处理的更新,或按状态列出插件 |
/upd info <plugin> |
查看插件的版本、来源和跟踪信息 |
/upd add <url> |
从 Modrinth/Hangar/Spigot/GitHub 链接添加并下载插件 |
/upd enable <plugin> / /upd disable <plugin> |
开始或停止检查插件的更新 |
/upd track <plugin|all> <release|beta|alpha|all> |
选择要关注的发布频道 |
/upd server <plugin|all> <auto|paper|spigot|folia|purpur> |
选择要下载的服务器构建版本 |
/upd source <plugin> [Modrinth|Hangar|Spigot|GitHub|Custom] [id/url] |
查找或设置插件的下载来源 |
/upd redownload <plugin> |
强制重新下载插件 |
/upd rollback <plugin> |
从备份恢复插件 |
/upd geyser [enable|disable|download|update] [addon|all] |
管理 Geyser、Floodgate 和 MCXboxBroadcast |
/upd reload |
无需重启服务器即可重载 config.yml |
/upd version |
显示插件版本 |
旧版命令如 /upd run、/upd -v 和 /upd plugin <command> ... 仍然可用。
? 权限
| 节点 |
描述 |
默认值 |
pluginupdater.admin |
对所有更新器命令的完全访问权限 |
OP |
非 OP 玩家也可以通过在 config.yml 中将他们的用户名添加到 allowed-players 来获得访问权限。
? 支持
? 贡献
欢迎提交 Pull Request。请在进行任何重大更改之前先提交 Issue 进行讨论。确保新功能包含适当的配置默认值,并且所有命令继续异步工作。
? 维护者
WebBeck
有关许可条款,请参阅 LICENSE 文件。
PluginUpdater-WB ?
Highly advanced, fully asynchronous plugin manager and updater for Paper servers.
Version: 26.3-1.0.0 | API Version: 26.3 | Java: 25+ | Author: WebBeck
? What It Does
PluginUpdater-WB automates keeping your Paper server's plugins up to date. It checks for new versions across multiple plugin repositories—Modrinth, Hangar, GitHub Releases, and SpigotMC—then downloads and installs updates asynchronously so your server stays responsive. It also supports direct custom download URLs and manages Geyser-ecosystem addons (Geyser, Floodgate, MCXboxBroadcast) natively.
✨ Features
- Multi-source update checking — Modrinth, Hangar, GitHub Releases, SpigotMC, and custom URLs
- Fully asynchronous — all network and I/O operations run off the main thread
- Per-plugin configuration — track
release, beta, alpha, or all channels per plugin
- Auto-detection — scans loaded plugins on startup and populates config automatically
- Geyser addon management — first-class support for Geyser, Floodgate, and MCXboxBroadcast
- Backup support — backs up plugin jars before overwriting
- Fine-grained permissions —
pluginupdater.admin permission node plus an allowlist for specific players
- Server-type awareness — supports Paper, Purpur, Folia, Spigot, and Bukkit loader targets
? Requirements
- Paper (or compatible fork) running API version 26.3
- Java 25 or newer
? Installation
- Download
PluginUpdater-WB-26.3-1.0.0.jar and drop it into your server's plugins/ folder.
- Start (or restart) your server. The plugin will generate
config.yml and auto-populate it with entries for every plugin currently loaded.
- Edit
config.yml to enable or tune tracking for each plugin (see Configuration below).
- Run
/upd reload to apply changes without restarting.
⚙️ Configuration
config.yml is generated on first run. Key options:
# Minecraft version used for Modrinth queries. Leave blank to auto-detect.
minecraft-version: '26.3'
# Players allowed to run commands without OP or the permission node.
allowed-players:
- 'YourUsernameHere'
# Loader type sent to Modrinth. "auto" detects Paper/Spigot/etc at runtime.
# Valid: "auto", "paper", "purpur", "folia", "spigot", "bukkit"
server-type-override: 'paper'
# Global release channel for all plugins.
# Valid: "release", "beta", "alpha", "all"
tracking-type: 'all'
# Geyser addon management (Geyser, Floodgate, MCXboxBroadcast)
geyser-addons:
enabled: false
Geyser: true
Floodgate: true
MCXboxBroadcast: true
Plugin Entries
Each plugin under the plugins: key supports one of five source types:
plugins:
# Modrinth
MyPlugin:
enabled: true
type: MODRINTH
project-id: osLrA9oB
allowed-release-types:
- release
current-version: 1.0.0
# GitHub Releases
AnotherPlugin:
enabled: true
type: GITHUB
github-repo: owner/repository
allowed-release-types:
- release
current-version: 2.0.0
# Hangar (PaperMC)
HangarPlugin:
enabled: true
type: HANGAR
project-id: ViaVersion
allowed-release-types:
- release
current-version: 5.0.0
# SpigotMC (numeric resource ID from the URL)
SpigotPlugin:
enabled: true
type: SPIGOT
project-id: '19254'
allowed-release-types:
- release
current-version: 1.0.0
# Custom URL (always downloads; skips version-check logic)
CustomPlugin:
enabled: true
type: CUSTOM
custom-url: 'https://example.com/downloads/CustomPlugin-latest.jar'
current-version: 1.0.0
A reference file of common plugin templates is included as common-plugins.yml inside the jar.
? Commands
The main command is /updater (alias: /upd). Requires the pluginupdater.admin permission or OP (configurable).
| Command |
Description |
/upd help |
Show all commands (click one to use it) |
/upd check |
Check all plugins for updates |
/upd update [plugin] |
Install pending updates (all, or just one plugin) |
/upd list [all|enabled|disabled] |
Show pending updates, or plugins by status |
/upd info <plugin> |
Versions, source and tracking for a plugin |
/upd add <url> |
Add and download a plugin from a Modrinth/Hangar/Spigot/GitHub link |
/upd enable <plugin> / /upd disable <plugin> |
Start or stop checking a plugin for updates |
/upd track <plugin|all> <release|beta|alpha|all> |
Choose which release channel to follow |
/upd server <plugin|all> <auto|paper|spigot|folia|purpur> |
Choose which server build to download |
/upd source <plugin> [Modrinth|Hangar|Spigot|GitHub|Custom] [id/url] |
Find or set where a plugin downloads from |
/upd redownload <plugin> |
Force a fresh download of a plugin |
/upd rollback <plugin> |
Restore a plugin from a backup |
/upd geyser [enable|disable|download|update] [addon|all] |
Manage Geyser, Floodgate and MCXboxBroadcast |
/upd reload |
Reload config.yml without restarting the server |
/upd version |
Show the plugin version |
Old forms like /upd run, /upd -v and /upd plugin <command> ... still work.
? Permissions
| Node |
Description |
Default |
pluginupdater.admin |
Full access to all updater commands |
OP |
Non-OP players can also be granted access by adding their username to allowed-players in config.yml.
? Support
- Issues & bug reports: Open an issue on the project repository
- GitHub page: PluginUpdater-WB
? Contributing
Pull requests are welcome. Please open an issue first to discuss any significant changes. Make sure new features include appropriate config defaults and that all commands continue to work asynchronously.
? Maintainer
WebBeck
See the LICENSE file for license terms.
评论 0
登录后参与评分
还没有评论,来抢沙发吧