配置说明

备注

在**独立模式**下，使用 CLI 参数（参见使用指南）。在 **MCDR 模式**下，配置从 MCDR 的配置文件 config/resource_pack_server/config.json 加载。

配置文件

配置文件在首次加载时自动生成。默认路径（MCDR 模式）：config/resource_pack_server/config.json。

默认配置：

{
    "enabled": true,
    "debug": false,
    "server": {
        "host": "0.0.0.0",
        "port": 8080,
        "pack_dir": "./resource_packs",
        "public_url": ""
    },
    "command": {
        "enabled": true,
        "prefix": "!!rps",
        "permission_level": 1
    },
    "merge": {
        "enabled": true,
        "pack_priority": []
    }
}

顶级字段

字段	类型	默认值	描述
`enabled`	`bool`	`true`	设置为 `false` 完全禁用插件
`debug`	`bool`	`false`	启用调试日志

服务器配置

server 部分：

字段	类型	默认值	描述
`host`	`str`	`0.0.0.0`	HTTP 服务器绑定地址
`port`	`int`	`8080`	HTTP 服务器端口
`pack_dir`	`str`	`./resource_packs`	包含 `.zip` 资源包文件的目录
`public_url`	`str`	(empty)	面向公网的 URL（服务器位于反向代理后时使用）

命令配置

command 部分（仅 MCDR 模式）：

字段	类型	默认值	描述
`enabled`	`bool`	`true`	是否注册 MCDR 命令
`prefix`	`str`	`!!rps`	命令前缀
`permission_level`	`int`	`1`	命令的最低 MCDR 权限等级

合并配置

merge 部分：

字段	类型	默认值	描述
`enabled`	`bool`	`true`	启用 `/merged.zip` 端点
`pack_priority`	`list[str]`	`[]`	按优先级排序的资源包文件名列表（最高优先级在前）。未列出的包按字母顺序追加。

示例：优先级排序

{
    "merge": {
        "enabled": true,
        "pack_priority": [
            "vanilla_tweaks.zip",
            "custom_sounds.zip",
            "default_xray.zip"
        ]
    }
}

使用此配置，vanilla_tweaks.zip 具有最高优先级——其资源会覆盖低优先级包中的冲突资源。