转载 工具 多版本资源包 1.3.1

[MD]
# 多版本资源包管理插件

> 分类：资源 / Java 版多人游戏 / 服务端插件

一款用于管理多版本资源包的简易插件。插件可根据玩家使用的 Minecraft 协议版本，为其发送对应的资源包。

## 配置与使用

```yaml
# 指定协议版本时，可使用 >=、<=、>、< 和 ==。
# 建议仅使用 >=、> 和 ==，因为协议版本按从低到高排序。
# 当 >、<、>= 或 <= 匹配到资源包时，插件会继续为后续协议版本查找可用资源包。
# 当 == 匹配到资源包时，插件会停止查找，并向玩家发送该资源包。
# 也可以指定版本字符串，详见：
# https://github.com/ViaVersion/ViaVe...api/protocol/version/ProtocolVersion.java#L45
# 请使用 register 方法中的名称，而不是字段名称。
packs:
'>=1_16_4-1_16_5':
file-hash: 8c96d8084fa706661d0a7cf9b084bef4161d520b
file-url: https://mediafilez.forgecdn.net/files/5505/931/Faithful %2032x%20-%201.16.5.zip
required: false

<753:
file-name: myPack.zip
required: false

<=1_12_2:
file-hash: 8c96d8084fa706661d0a7cf9b084bef4161d520b
file-url: https://mediafilez.forgecdn.net/files/5505/931/Faithful %2032x%20-%201.16.5.zip
required: true

port: 3000
bind-ip: 0.0.0.0

# 此处需要填写资源包主机的外部 IP 地址。
# 插件无法自动获知服务器主机的 IP；同时，直接向玩家暴露真实 IP 也可能存在风险。
# 可通过 Nginx、Cloudflare 等服务进行代理。
public-link: http://localhost:3000/

declined-message: You must accept resource pack in order to play on this server!
failed-message: Unable to download resource pack. Try again!

# HTTP 处理器使用的线程数量。
http-handler-threads: 2
```

## 配置说明

### 资源包匹配规则

`packs` 下的每个条目对应一组协议版本匹配条件：

- `>=`、`>`、`<=`、`<`：匹配后仍会继续检查后续规则，以便为不同版本选择合适的资源包。
- `==`：精确匹配。找到资源包后立即停止继续查找，并将该资源包发送给玩家。
- 也可直接使用版本字符串作为匹配条件。
- 建议优先使用 `>=`、`>` 与 `==`，以避免因协议版本排序造成不符合预期的匹配结果。

### 资源包字段

| 字段 | 说明 |
|---|---|
| `file-hash` | 资源包文件的哈希值。 |
| `file-url` | 资源包下载地址。 |
| `file-name` | 资源包文件名。 |
| `required` | 是否强制玩家接受资源包。`true` 表示必须接受，`false` 表示可拒绝。 |

### 网络设置

| 字段 | 说明 |
|---|---|
| `port` | 插件 HTTP 服务监听端口。 |
| `bind-ip` | HTTP 服务绑定的 IP 地址。 |
| `public-link` | 对玩家公开的资源包访问地址。建议通过 Nginx、Cloudflare 等反向代理或 CDN 提供访问，避免直接暴露服务器真实 IP。 |
| `http-handler-threads` | HTTP 请求处理线程数。 |

### 提示消息

| 字段 | 说明 |
|---|---|
| `declined-message` | 玩家拒绝资源包时显示的提示。 |
| `failed-message` | 资源包下载失败时显示的提示。 |
[/MD]