Bedrock Wiki
  • QQ
  • 原站
新手入门指南
  • Guide
    • 1. 简介
      指南
    • 2. 附加组件详解
    • 3. 软件与准备工作
    • 4. 项目设置
    • 5. 创建自定义物品
    • 6. 创建自定义实体
    • 7. Blockbench:建模、贴图与动画制作
    • 8. 添加战利品表、生成规则与合成配方
  • Extra
    • a. 理解JSON
    • b. 下载示例包
    • c. 故障排除
      帮助
    • d. 高级清单文件指南
    • e. 格式版本
    • f. Android 项目设置
JSON UI
  • General
    • JSON UI 入门指南
      指南
    • 最佳实践
      指南
  • Tutorials
    • Aseprite 动画
    • 保留标题文本
      中级
    • 修改服务器表单
      中级
    • 字符串与数字转换
      中级
    • 按钮与开关
      新手
    • 添加HUD界面元素
      新手
  • Documentation
    • JSON UI 文档
Meta
  • Style Guide
  • 使用JSON模式(Schemas)
  • 实用链接
  • 版本控制
  • 附加包性能优化
  • Q&A
    • GameTest 问答集 2021/08/06
    • 世界生成问答 2024/11/15
    • 延迟渲染技术预览问答 2024/02/23
    • 方块与物品问答 2024/08/30
    • 脚本与编辑器问答 2023/09/22
NBT
  • General
    • .mcstructure
  • Tutorials
    • 扩展结构限制
      简单
    • 教育版中的实验功能
      简单
  • NBT in Depth
    • NBT 库列表
      专家
    • NBT读取示例
      专家
    • 关于NBT(命名二进制标签)
      专家
世界生成
  • General
    • 世界生成入门
      指南
      实验性
    • 特性类型
      实验性
    • 生物群系
      指南
      实验性
  • Tutorials
    • 特征(Feature)的方块条件
      实验性
    • 生成地表区块
      实验性
    • 生成自定义矿石
      实验性
    • 生成自定义结构
      实验性
    • 高度图噪声地形
      实验性
  • Documentation
    • 生物群系标签
动画控制器
  • 动画控制器入门指南
    指南
  • 实体命令
    中级
  • AFK检测器
  • 将Molang变量转换为计分板数值
  • 死亡指令
  • 重生指令
命令
  • General
    • 命令方块入门指南
    • 函数
    • NBT 命令
    • 坐标系
    • 方块状态
    • 理解目标选择器
    • 记分板操作
  • Commands
    • Execute
      简单
    • Playanimation
    • 伤害
    • 播放音效
  • On Event Systems
    • 玩家首次加入时
    • On Player Join
    • 玩家离开时触发
    • 玩家死亡事件
    • 玩家重生事件系统
    • 首次加载世界时
  • Scoreboard Systems
    • 实体计数器
    • 计分板计时器
    • 比较与获取分数
  • Techniques
    • 执行逻辑门
    • MBE - Max的方块实体
    • FMBE - 创建显示实体的新方法
    • 视线检测
    • 移动状态检测
    • 轨道摄像机
  • Useful Creations
    • 多人位置重排系统
      函数
    • 自定义合成台
      简单
实体
  • General
    • Intro to Entities BP
      指南
      新手
    • 实体资源包入门
      指南
      新手
    • 实体问题排查指南
      帮助
    • NPC对话系统
      中级
    • 实体事件
      新手
    • 实体属性
    • 渲染控制器
      新手
    • 生成规则
  • Tutorials
    • 任意坐标系间的坐标转换(世界、实体、骨骼)
      中级
    • 创建船只
      中级
    • 实体手持物品
      中级
    • 实体攻击机制
      中级
    • 实体睡眠机制
      中级
    • 实体碰撞体
      中级
    • 实体移动
    • 实体计时器
      中级
    • 无敌实体
      新手
    • 村庄机制实现指南
    • 检测其他实体
      中级
    • 生成已驯服的实体
      脚本
      中级
    • 视线检测实体
      中级
    • 禁用队友伤害
      中级
    • 范围效果云入门指南
      中级
    • 虚拟实体
      新手
    • 飞行实体控制
      中级
  • Documentation
    • Vanilla Usage Spawn Rules
    • 原版使用组件
    • 抛射物
    • 虚拟组件
    • 运行时标识符
    • 非生物实体运行时标识符
战利品、配方与交易
  • General
    • 交易行为
  • Documentation
    • 战利品表
    • 交易表
    • 合成配方
    • 物品函数
  • Tutorials
    • 随机化结构战利品
      简单
文档
  • Shared Constructs
  • Molang 查询详解
  • Vanilla Materials
    专家
  • 声音定义
  • 文件类型
  • 材质配置文件说明
    专家
  • 菜单分类
  • 资源包文件夹结构
  • 雾效ID
  • 高级Molang指南
方块
  • General
    • 方块入门指南
      指南
      新手
    • 方块组件
    • Block Tags
    • 方块状态
    • Block Traits
    • 方块排列组合
    • 方块事件
      脚本
    • 方块事件迁移指南
      帮助
    • 方块物品化
      中级
    • 方块问题排查指南
      帮助
  • Visuals
    • 方块剔除
      中级
    • 方块模型
      指南
      新手
      简单
    • 方块着色
      简单
    • 方块纹理动画
      中级
    • 方块纹理变体
      中级
  • Tutorials
    • Precise Interaction
      专家
      脚本
    • Precise Rotation
      专家
      脚本
    • 伪方块
      中级
    • 可旋转方块
    • 应用持续效果
      简单
      脚本
    • 矿石战利品表
      简单
      脚本
    • 规避状态值限制
      专家
  • Vanilla Re-Creations
    • 自定义作物
      中级
      脚本
    • 自定义活板门
      中级
      脚本
    • 自定义玻璃
      新手
      简单
      已弃用
    • 自定义釉面陶瓦
      简单
  • Documentation
    • 原版方块模型
      新手
    • 方块形状
    • 方块格式历史
    • 方块音效
服务器
  • Software
    • Bedrock Server Software
  • Protocols
    • Bedrock Protocol
    • NetherNet 协议
    • RakNet 协议
概念
  • contents.json
  • Molang
    中级
  • Rawtext
  • textures_list.json
  • 命名空间
  • 子包
  • 文本与本地化
  • 着色器
  • 纹理图集
    中级
  • 表情符号与特殊字符
  • 覆盖资源
    中级
  • 音效
    中级
物品
  • General
    • 物品入门指南
      指南
      新手
    • 物品组件
    • 物品标签
    • 物品事件
      脚本
    • Item Event Migration
      帮助
    • 物品问题排查指南
      帮助
  • Tutorials
    • Custom Pottery Sherds
    • 可投掷物品
      中级
    • 生成物品
      中级
    • 自定义武器
      简单
    • 自定义盔甲
    • 自定义食物
      简单
      脚本
    • 通过装备物品执行命令
      实验性
      中级
    • 高分辨率物品
  • Documentation
    • 附魔
    • Numerical Item IDs
    • Vanilla Usage Components
    • 原版物品标识符
      已弃用
    • 可附着物
      新手
    • 物品格式历史记录
视觉效果
  • General
    • 实体视觉效果简介
      指南
    • 基岩版建模指南
    • 动画中的特效
    • 基于数学的动画
      中级
    • 材质
      专家
    • 材质创作
      专家
    • 皮肤包制作指南
    • 自定义死亡动画
      中级
  • Tutorials
    • Glowing Entity Texture
    • 受伤动画
      中级
    • 实体纹理动画
      中级
    • 栓绳位置调整
      简单
    • 玩家几何模型
      新手
    • 移除实体阴影
      中级
    • 重绘生成蛋纹理
      新手
  • Ideas
    • 结构展示技巧
粒子效果
  • General
    • 粒子效果入门
      指南
  • Tutorials
    • 禁用粒子效果
      新手
  • Documentation
    • 原版粒子效果
脚本编写
  • General
    • 脚本编程入门
    • 什么是Script API?
    • API 模块
  • Tutorials
    • GameTests
      实验性
    • 简易聊天命令
      实验性
    • 脚本核心功能
    • 脚本表单
      实验性
    • 脚本请求API
      实验性
    • 阻止方块放置
  • Documentation
    • JavaScript 问题排查指南
    • Script Resources
    • Script Watchdog
      实验性
    • TypeScript
    • 引擎环境
虚拟现实
  • General
    • 启用VR模式
      指南
    • 配置资源包
      专家
  • Tutorials
    • 编辑你的第一个模型
      专家

格式版本

格式版本
  • 为什么需要格式版本?
  • 格式版本≠游戏版本
  • 格式版本修正机制
  • 如何选择格式版本
  • 各资源类型的格式版本
    • 资源包
    • 行为包

格式版本是《我的世界:基岩版》附加包系统的重要组成部分。它们通常出现在文件顶部,格式如下:"format_version": "1.21.0"。你可以将其视为文件的"版本号",而你在此选择的数字非常重要!所选格式版本将决定该文件中可用的语法和功能。

TIP

选择错误的格式版本是常见错误来源。在排查问题时,人们可能会问你"你的物品使用什么格式版本"之类的问题。请确保你知道如何回答这个问题。

为什么需要格式版本? ​

格式版本的存在是为了对附加包系统进行_版本控制_,使《我的世界》能够在引入新功能的同时不破坏旧版附加包。例如,1.8.0格式版本的RP实体文件与1.10.0格式版本的RP实体文件在语法上有很大不同。通过在json中使用'format_version'键,_你_可以决定要使用的版本。

通过在_每个文件_中使用格式版本,《我的世界》让你能够充分控制游戏如何解读你的附加包。在附加包中混合使用不同格式版本是完全可行且被预期的。

格式版本≠游戏版本 ​

必须明确理解:格式版本是_按子系统_划分的,通常不等于基础游戏版本。这意味着每种文件类型(物品、RP实体、BP实体、配方等)都会使用不同的版本系统。

例如:RP实体文件中的"format_version": "1.8.0"表示"使用_物品系统_的1.8.0版本",而_不是_"使用_附加包系统_的1.8.0版本"。

因此,某些文件类型的格式版本可能看起来非常"老旧"。不要试图将其替换为最新游戏版本(如1.17.0)。

格式版本修正机制 ​

《我的世界》有一个系统会在你写错格式版本时进行"修正"。这个机制尚未被充分理解,并非所有系统都启用,也不应依赖它。但需要注意的是,错误的格式版本通常会"回退"到最近的可用版本。例如1.11.0版本的RP实体文件会被当作1.10.0处理且不会报错。

这个机制很有用,意味着你因选错格式版本而创建损坏文件的可能性降低了。

如何选择格式版本 ​

一般来说,有个实用技巧可以帮助你为任何文件类型选择正确的格式版本。

以创建配方文件为例:

  1. 安装原版资源包
  2. 查看一些配方文件,判断最常用或最新的格式版本
  3. 在你的文件中使用这个版本

这个简单技巧能帮助你为文件选择有效的格式版本。

各资源类型的格式版本 ​

本节将列出原版游戏中使用的格式版本及其出现频率。

  • '⭐'标记推荐使用的_稳定_版本
  • '🚀'标记可选的_实验性_版本(如适用)

最后更新于1.21.50版本

资源包 ​

格式版本出现次数
动画控制器1.10.0 ⭐65
动画1.10.0 ⭐6
动画1.8.0130
可附着物1.10.0 ⭐30
可附着物1.101
可附着物1.8.025
方块目录1.20.40 ⭐1
客户端实体1.10.0 ⭐88
客户端实体1.8.084
雾效果设置1.16.100 ⭐73
几何模型1.16.06
几何模型1.12.030
几何模型1.10.05
几何模型1.8.091
粒子效果1.10.0 ⭐176
渲染控制器1.10.0 ⭐24
渲染控制器1.8.098
音效定义1.20.20 ⭐1

行为包 ​

格式版本出现次数
实体1.21.50 ⭐9
实体1.21.6017
实体1.21.301
实体1.21.202
实体1.21.109
实体1.21.028
实体1.19.801
实体1.19.601
实体1.19.501
实体1.19.301
实体1.18.201
实体1.18.103
实体1.17.101
实体1.16.2101
实体1.16.019
实体1.14.06
实体1.13.02
实体1.12.014
实体1.10.01
实体1.8.02
物品1.21.30 ⭐17
物品1.20.505
物品1.16.01
物品1.161
物品1.141
物品1.1045
配方1.21.50 ⭐13
配方1.21.604
配方1.21.302
配方1.20.603
配方1.20.3019
配方1.20.101315
配方1.16139
配方1.1267
生成规则1.17.0 ⭐1
生成规则1.11.01
生成规则1.8.051
交易表1.18.101

贡献者

编辑 格式版本

Bedrock Wiki by Bedrock OSS ,Translate by 8aka-Team

"Minecraft"是Mojang AB的注册商标。

Bedrock OSS、Bedrock Wiki以及 bedrock.dev 与Microsoft及Mojang AB不存在任何隶属关系。

  • 隐私政策
  • 加入QQ社区
  • 参与贡献指南
  • 访问代码仓库