### 关于
**SWXResource** 是一个方便的插件，用于管理运行 Paper/Purpur 1.21.1 的 Minecraft 服务器上的资源包。它允许管理员和玩家使用简单的命令轻松创建、上传、删除和管理资源包。该插件支持本地化（俄语和英语）、加入服务器时自动加载资源包以及彩色消息格式化。
#### 主要功能：
- **通过命令管理资源包**: 使用 `/rp_swx` 创建、删除、加载和查看资源包信息。
- **加入时自动加载**: 玩家可以使用 `/rp_swx joinrp` 在加入服务器时启用自动加载资源包。
- **本地化**: 支持俄语和英语，并通过 `/rp_swx lang` 进行语言切换。
- **彩色格式化**: 消息和帮助菜单使用彩色文本以提高清晰度（命令使用紫色，分隔符使用白色，描述使用粉色）。
- **大小限制**: 限制资源包大小（默认：50 MB，可在 `config.json` 中配置）。
- **管理员工具**: 管理员可以使用 `/rp_swx admin_delete` 删除任何资源包。
#### 命令 & 权限：
- `/rp_swx create ` — 创建一个新的资源包（仅限玩家）。
- `/rp_swx list` — 列出可用的资源包。
- `/rp_swx delete ` — 删除你的资源包（仅限创建者）。
- `/rp_swx admin_delete ` — 删除任何资源包（需要 `swx.resourcepack` 权限或 OP）。
- `/rp_swx dw ` — 强制作为服务器包下载资源包（仅限玩家）。
- `/rp_swx info ` — 显示资源包详情。
- `/rp_swx lang ` — 更改插件语言。
- `/rp_swx joinrp ` — 切换加入时自动加载包（仅限玩家）。
- `/rp_swx help` — 显示命令帮助。
**权限**:
- `swx.resourcepack` — 授予访问 `/rp_swx admin_delete` 的权限。
#### 兼容性：
- 服务器：Paper/Purpur 1.21.1。
- 依赖项：Kotlin stdlib, kotlinx-serialization-json, Adventure API。（无需手动安装！）
---
### 安装 & 使用指南
以下是一个详细的指南，适合用户，用于 Modrinth 或 `README.md` 文件。
#### 安装
1. **下载插件**:
- 从 Modrinth 获取最新的 `AlluminiumResource.jar`。
2. **安装插件**:
- 将 `AlluminiumResource.jar` 放入服务器的 `plugins` 文件夹（Paper/Purpur 1.21.1）。
3. **重启服务器**:
- 插件将生成一个 `AlluminiumResource/SWX_Resourcexpack` 文件夹，其中包含配置文件。
4. **配置 (可选)**:
- 编辑 `SWX_Resourcexpack/config.json`:
- `language` — 默认语言 (`eng` 或 `ru`)。
#### 使用
1. **创建资源包**:
- 使用 `/rp_swx create `，其中：
- `` — 直接下载链接到 `.zip` 文件（例如，Google Drive/Dropbox）。
- `` — 资源包名称。
- 示例：`/rp_swx create https://example.com/pack.zip MyPack`
- 包将保存在插件的数据库中。
2. **列出包**:
- 运行 `/rp_swx list` 查看所有可用包。
- 格式：` ()`。
3. **加载包**:
- 使用 `/rp_swx dw ` 强制下载。
- 示例：`/rp_swx dw MyPack`
- 玩家将看到 Minecraft 的服务器包提示。
4. **加入时自动加载**:
- 运行 `/rp_swx joinrp ` 切换自动加载。
- 示例：`/rp_swx joinrp MyPack`
- 重复该命令会禁用自动加载。
5. **删除包**:
- 玩家：`/rp_swx delete ` (仅限你的包)。
- 管理员：`/rp_swx admin_delete ` (任何包)。
6. **查看信息**:
- 使用 `/rp_swx info ` 查看创建者、创建日期和 URL。
7. **更改语言**:
- 运行 `/rp_swx lang `。
- 示例：`/rp_swx lang ru`
8. **帮助菜单**:
- 输入 `/rp_swx help` 以获取命令摘要。
#### 注意
- 确保资源包 URL 指向 `.zip` 文件（没有下载页面）。
- 如果包无法加载，请检查 Minecraft 的 `latest.log` 以获取错误（例如，无效 URL 或大小限制）。
- 管理员：使用权限插件（例如，LuckPerms）来管理 `/rp_swx admin_delete` 访问。
#### 故障排除
- **包无法加载？**
- 验证 URL 是否正确且可访问。
- **语言错误？**
- 使用 `/rp_swx lang` 切换。
- **无法使用 `/rp_swx admin_delete`？**
- 确认您具有 `swx.resourcepack` 权限或 OP 状态。