![PackFailover —— 资源包下载失败时自动切换， [Paper 26.2]](/data/resource_icons/18/18646.jpg?1792407244){kind=icon}
- 版权类型
- 原创
- 插件中文名称
- 资源包下载故障自动切换
- 插件英文名称
- PackFailover
- 原帖地址
- #
- 支持的核心（服务端）
- Paper
- 语言支持
- 中文（简体）
- 前置组件
- PacketEvents 2.14.0
- 适配版本（Java）
- 26.x
PackFailover - 资源包下载失败自动切换
PackFailover 是一款适用于 Paper 服务器的资源包下载故障恢复插件。PackFailover 允许服务器优先使用第三方资源包托管服务。当玩家因网络问题无法下载资源包时，插件会自动切换到服务器自托管的备用下载地址，从而节省服务器流量。
整个过程由服务器自动完成。
功能特性
- 自动故障切换：检测资源包下载失败状态，自动尝试备用地址
- 本地缓存：缓存资源包文件，供备用 HTTP 服务下载
- SHA-1 校验：确保备用资源包与原始资源包一致
- 管理指令：支持手动索引、缓存查看、状态检查和调试
运行环境
| 项目 | 要求 |
|---|---|
| 服务端 | Paper 26.2 |
| Java | 25 |
| 必需前置 | PacketEvents 2.14.0 |
| 适用平台 | Minecraft Java 版 |
| 插件版本 | 0.1.0 |
安装教程
- 将 PackFailover JAR 放入服务器的
plugins目录。 - 启动服务器，生成
plugins/PackFailover/config.yml。 - 在配置中填写原始资源包域名、资源包目录和备用下载地址。
- 重启服务器，执行
/pf index和/pf status检查运行状态。
配置示例
以下为部分配置（以使用 RPEngine 时的资源配置为例）：
代码：
tracking:
primary-host-allowlist:
- "packs.resourcepack.ai"
providers:
directories:
- id: rpengine
enabled: true
path: "plugins/RPEngine/output"
glob: "**/*.zip"
max-depth: 3
http:
enabled: true
port: 8181
public-url: "http://packs.example.com:8181"http.public-url 必须能够从玩家客户端访问，默认 HTTP 服务端口为 8181/TCP。指令列表
| 指令 | 功能 |
|---|---|
/pf status | 查看插件运行状态 |
/pf index | 重新索引资源包 |
/pf cache | 查看已缓存的资源包 |
/pf debug <玩家名> | 查看玩家资源包下载记录 |
/pf artifact <ZIP路径> | 校验并缓存指定资源包 |
/pf reload | 重新加载配置 |
packfailover.admin，默认授予 OP。开源与反馈
- 项目源码：GitHub
- 安装文档：Installation
- 问题反馈：GitHub Issues
