基岩版BDS安装.mcpack完整教程

⚠️重点提醒：原版 BDS 服务端不直接识别.mcpack 文件，mcpack 本质是改名 zip 压缩包，必须先解压，不能直接上传 mcpack！

前置准备（电脑本地操作）

1. 把你的xxx.mcpack重命名为xxx.zip，然后解压

2. 解压结果分两种情况：

   • 行为包 BP（控制生物、机制、模组功能）：文件夹内直接存在manifest.json

   • 资源包 RP（材质、模型、音效）：同样自带manifest.json

很多模组同时有 BP+RP 两个包，两个都要装！
❌禁止双层嵌套：不能出现 文件夹A/文件夹B/manifest.json，必须保证打开文件夹就能看见 manifest.json

第一步：停止服务器

面板进入服务器管理 → 停止实例，不要热加载附加包，大概率崩溃。

第二步：上传解压后的包文件夹

打开【文件管理】，进入服务器根目录：

1. 行为包 BP 文件夹 → 上传到 /behavior_packs/

2. 资源包 RP 文件夹 → 上传到 /resource_packs/

路径示例：

`Plain Text
/behavior_packs/恐龙BP/manifest.json
/resource_packs/恐龙RP/manifest.json

## 第三步：获取 UUID 与版本号（关键）

打开你上传的 BP/RP 文件夹里的 `manifest.json`
找到`header`内两行：

```json
"uuid": "这里一串UUID",
"version": [1, 0, 0]

分别复制 BP、RP 各自的 uuid 和 version 数组。

第四步：在世界文件夹启用附加包

1. 进入 /worlds/【你的世界文件夹名】/

世界文件夹名称看server.properties内 level-name= 的值

2. 创建 / 编辑两个文件（没有就新建）

① world_behavior_packs.json（写入行为包信息）

[
    {
        "pack_id": "粘贴BP的UUID",
        "version": [1, 0, 0]
    }
]

② world_resource_packs.json（写入资源包信息）

[
    {
        "pack_id": "粘贴RP的UUID",
        "version": [1, 0, 0]
    }
]

多个模组就在数组里继续逗号分隔添加 {} 块。

第五步：可选操作（模组需要实验性玩法）

打开 server.properties，找到并开启：

Plain Text experiments-enabled=true

部分脚本附加包还需要开启 Beta API。

第六步：启动服务器，验证

启动服务器，查看控制台日志：

• 出现 Loading behavior pack / Loading resource pack = 加载成功

• 如果报错找不到 pack：检查 UUID、版本号、文件夹嵌套问题

简易备选方案（适合新手，不容易出错）

1. 在本地单人基岩版导入 mcpack，新建世界并启用这个附加包

2. 把启用好模组的整个世界存档上传覆盖服务器 /worlds/世界名/

优点：不需要手动写 json；缺点：后续更新模组需要重新导出上传世界

常见踩坑

1. ❌直接上传 mcpack 压缩包：BDS 不认，必须解压文件夹

2. ❌文件夹双层嵌套：解压后多套一层文件夹，服务端无法读取 manifest

3. ❌只装 BP 不装 RP：模组没有材质，模型透明 / 黑白

4. ❌修改 json 语法错误：逗号多打、少打，服务器启动失败

5. ❌UUID/version 复制错误：严格复制 manifest 内原始内容