转载 开源 工具 viGeyserUpdater 1.0.0

[MD]
## 简介

适用平台： Paper · Spigot · Folia · Velocity

# viGeyserUpdater

适用平台：**Paper · Spigot · Folia · Velocity**

一款面向 Geyser 伴生插件与扩展的崩溃安全更新管理器。

---

## 概述

viGeyserUpdater 可自动或通过管理员命令保持你的 Geyser 伴生插件与扩展处于最新版本。

当前内置更新预设的插件/扩展：

- GeyserModelEngine
- GeyserModelEngineExtension
- GeyserUtils for Bukkit
- GeyserUtils for Velocity
- GeyserUtils Geyser Extension
- Boar

每个托管组件均可在配置文件中单独启用或禁用。

---

## 功能特性

- 自动与手动两种更新模式
- 支持 Paper、Spigot、Folia 和 Velocity
- 支持 GitHub Releases 和 Modrinth 两种来源
- 每个组件均有独立的启用/禁用开关
- HTTPS 主机白名单与重定向合法性校验
- 连接超时与下载大小上限保护
- 针对连接失败、HTTP 429 和 HTTP 5xx 的指数退避重试
- 上游提供校验值时进行 SHA-256 完整性验证
- 安装前对 JAR 结构进行合法性验证
- 原子事务日志与中断更新恢复机制
- 防路径穿越攻击与 JAR 匹配歧义保护
- 使用独立工作线程，不阻塞服务器主线程
- 兼容 Folia 的命令响应分发机制

---

## 安装

1. 从本页面下载 Bukkit JAR 文件。
2. 将其放入服务器的 `plugins` 目录。
3. 启动服务器一次以生成配置文件。
4. 查阅 `plugins/viGeyserUpdater/config.yml`。
5. 按需启用或禁用你希望管理的组件。

> **注意：** 安装更新后必须完整重启服务器，不支持通过插件重载器（Plugin Reloader）应用更新。/WARNING]

---

## 命令

```
/geyserupdates status
/geyserupdates check [artifact|all]
/geyserupdates update [artifact|all]
/geyserupdates reload
```

命令别名：

```
/gupdates
```

所需权限：

```
vigeyserupdater.admin
```

该权限默认授予服务器 OP。

---

## 自动更新模式

自动检查并安装更新：

```yaml
automatic:
enabled: true
apply: true
```

仅自动检查，不自动安装：

```yaml
automatic:
enabled: true
apply: false
```

仅手动模式：

```yaml
automatic:
enabled: false
```

---

## 注意事项

- 需要 Java 21 或更高版本。
- 管理 Geyser 扩展时，服务器上必须已安装 Geyser 本体。
- Geyser 的默认目录为 `plugins/Geyser-Spigot`，可在配置文件中指定自定义路径。
- 若更新源暂时不可用，已安装的 JAR 文件和当前状态会被完整保留。
- 在 Windows 系统上，正在运行中的 JAR 可能被文件系统锁定。若出现此情况，请停止服务器后手动替换对应组件。

---

## 开源信息

viGeyserUpdater 是一个基于 MIT 许可证分发的原创开源项目。

源代码：[GitHub Repository](https://github.com/vishsiri/viGeyserUpdater)

问题反馈与支持：[GitHub Issues](https://github.com/vishsiri/viGeyserUpdater/issues)
[/MD]