跳到主要内容

📦 基岩版整合包格式文档

🗂️ 目录结构​

🎮 整合包根目录/
│
├── 📁 version/              # 🏷️ 版本源目录
│   └── (存放游戏核心文件及版本特定资源)
│
├── 📁 d_mods/              # ⏳ 延迟注入Mods目录
│   └── (存放需要延迟加载的Mod文件)
│
├── 📁 mods/                # ⚡ 普通Mods目录
│   └── (存放常规Mod文件)
│
├── 📁 res_packs/           # 🎨 资源包与行为包目录
│   ├── 📁 resource_packs/  # 🖼️ 资源包
│   └── 📁 behavior_packs/  # 🤖 行为包
│
├── 📁 worlds/              # 💾 存档目录
│   └── (存放游戏世界存档)
│
└── 📄 pack.json            # 📋 整合包信息文件

📋 详细说明​

🏷️ version/ - 版本源目录​

  • 用途: 存放游戏核心文件及版本特定资源
  • 示例内容:
    • version.json - BedrockBoot 启动器识别版本实例的文件

⏳ d_mods/ - 延迟注入Mods目录​

  • 用途: 存放需要延迟加载的Mod文件
  • 特点: 这些Mod将在游戏核心加载完成后注入
  • 文件格式: .dll

⚡ mods/ - 普通Mods目录​

  • 用途: 存放常规Mod文件
  • 特点: 这些Mod随游戏启动时一同加载
  • 文件格式: .dll

🎨 res_packs/ - 资源包与行为包目录​

  • 用途: 存放资源包和行为包
  • 特点: 每个子目录代表一个独立的资源包/行为包
  • 子目录:
    • resource_packs/ - 🖼️ 存放资源包(纹理、声音、语言等)
    • behavior_packs/ - 🤖 存放行为包(实体行为、游戏逻辑等)

💾 worlds/ - 存档目录​

  • 用途: 存放游戏世界存档
  • 特点: 每个子目录代表一个独立的世界存档
  • 示例结构: 
    worlds/
    └── ⚔️ My World

📋 pack.json - 整合包信息文件​

  • 用途: 描述整合包元数据和配置信息

  • 必需字段:

    {
      "name": "✨ 示例整合包",
      "version": "1.0.0",
      "author": "Round-Studio",
      "description": "这是简介"
    }

  • 可选字段:

    • url - 整合包官方网站

🚀 使用示例​

基础整合包结构​

My_Pack/
├── version/
│   └── 各种版本文件，直接存放，不需要压缩
├── d_mods/
│   └── xxx.dll
├── mods/
│   └── xxx.dll
├── res_packs/
│   ├── resource_packs/
│   │   └── xxx
│   └── behavior_packs/
│       └── xxx
├── worlds/
│   └── My_Adventure_World
└── pack.json

📋 pack.json 示例​

{
  "name": "✨ 示例整合包",
  "version": "1.0.0",
  "author": "Round-Studio",
  "description": "这是简介",
  "url": "https://roundstudio.top"
}

💡 最佳实践​

  1. ✅ 保持目录结构清晰
  2. ✅ 为每个Mod和资源包使用描述性名称
  3. ✅ 在pack.json中提供详细描述和依赖信息
  4. ✅ 测试所有Mod的兼容性
  5. ✅ 提供清晰的安装和使用说明

📝 本文档最后更新于: 2025年8月31日
🎨 By Round-Studio