# SeniorResourcePacks
SeniorResourcePacks 是一个 Bukkit/Spigot 插件，旨在以零麻烦的方式在本地托管 Minecraft 资源包。只需将您的 .zip 文件放入插件的文件夹中，它将自动提供一个 Minecraft 可以使用的直接下载链接。
无需使用第三方托管 – 该插件运行其自身的轻量级 HTTP 服务器，允许您的服务器直接将资源包分发给玩家。支持高达 1 GB 的包，加载速度快，并自动检测客户端兼容性的正确 SHA-1 哈希值。
---
## 要求
* **Minecraft 服务器**: Spigot 或 Bukkit 1.21+
* **Java 版本**: Java 19 或更高版本
* **RAM**: 至少 1GB 可用
* **网络**: 打开 HTTP 端口（默认：8080）
---
## 安装
### 步骤 1：下载
1. 从 releases 下载 `senior-resource-packs-1.0.0.jar`
2. 将 JAR 文件放入服务器的 `plugins/` 文件夹中
### 步骤 2：启动
1. 启动或重启您的 Minecraft 服务器
2. 插件将自动：
* 创建 `plugins/senior-resource-packs/` 文件夹
* 生成默认 `config.yml`
* 创建 `pack/` 文件夹用于资源包
* 启动 HTTP 服务器
### 步骤 3：验证
检查服务器控制台中的消息，例如：
```
[INFO]: [senior-resource-packs] Detected external IP: [您的 IP]
[INFO]: [senior-resource-packs] Simple HTTP server started on 0.0.0.0:8080
[INFO]: [senior-resource-packs] Senior Resource Packs plugin has been enabled!
[INFO]: [senior-resource-packs] HTTP server running on: http://[您的 IP]:[端口]/
```
---
## 配置
### 默认 config.yml
```yaml
server_ip: ""
http_port: 8080
force_pack: false
auto_apply_all_worlds: true
resource_packs:
pack1: ""
pack2: ""
pack3: ""
messages:
resource_pack_applied: "§aResource pack applied successfully!"
resource_pack_failed: "§cFailed to apply resource pack!"
reload_success: "§aConfiguration reloaded successfully!"
no_permission: "§cYou don't have permission to use this command!"
```
### 选项
| 设置 | 描述 | 默认 | 值 |
| ----------------------- | ---------------------------------- | ------- | ----------- |
| `server_ip` | 服务器 IP (如果为空则自动检测) | `""` | IP 或为空 |
| `http_port` | HTTP 服务器端口 | `8080` | 1–65535 |
| `force_pack` | 强制接受包 | `false` | true/false |
| `auto_apply_all_worlds` | 自动将包应用于所有世界 | `true` | true/false |
| `resource_packs` | 包插槽 | - | 包名称 |
---
## 命令
| 命令 | 描述 |
| -------------------- | -------------------------- |
| `/rp reload` | 重新加载配置 |
| `/rp applyall` | 将包应用于所有玩家 |
| `/rp info` | 显示插件信息 |
| `/rp apply ` | 将包应用于一名玩家 |
| `/rp list` | 显示 Web 界面 URL |
---
## Web 界面
### 访问
* 打开浏览器 → `http://[服务器 IP]:[端口]/`
* 默认：`http://[服务器 IP]:8080/`
### 特性
* **仪表板**: 服务器状态、端口、IP、加载的包
* **包管理器**: 列表、状态、下载、大小信息
* **配置面板**: 更改端口、强制应用包、自动应用、重新加载插件
* **响应式**: 在移动设备、平板电脑、桌面电脑上工作
---
## 资源包
### 添加包
**文件上传**
* 将 `.zip` 包放入 `plugins/senior-resource-packs/pack/`
* 重启或 `/rp reload`
**Web 界面**
* 使用上传或文件管理器
* 重新加载插件
### 要求
* 格式：仅 `.zip`
* 位置：`pack/` 文件夹
* 名称：描述性 (避免空格)
* 大小：没有严格限制 (考虑玩家带宽)
### 加载过程
* 在启动时扫描包
* `.zip` 文件获得 URL：`http://[IP]:[端口]/pack.zip`
* 玩家在加入时如果启用了自动应用，将收到包
---
## 故障排除
### 下载问题
* 下载失败 → 检查 IP、HTTP 服务器、防火墙、手动 URL 测试
### 错误的 IP
* 检测到内部 IP → 在 config 中手动设置 `server_ip`
### HTTP 错误
* 服务器无法启动 → 检查端口冲突、权限、其他插件
### 包问题
* 未加载 → 确认 `.zip`、权限、使用 `/rp reload`
### 控制台日志
* 始终检查启动和错误日志以获取信息
---
## 高级
* **手动 IP**: `server_ip: "123.456.789.012"`
* **自定义端口**: `http_port: 9080`
* **强制应用包**: `force_pack: true`
* **性能**: 使用线程池，自动清理，MIME 服务
---
## 支持
* 检查控制台日志
* 使用 Web 界面
* 直接测试包 URL
* 验证权限
**插件信息**
* 版本：1.0.0
* 作者：YourSenior
* 由：CloudNord.net 提供支持
* MC 版本：1.21+
* Java：19+
---
## 许可与鸣谢
由 CloudNord.net 提供支持 – 专业的 Minecraft 托管服务。
*Made with ❤️ by CloudNord.net*