1.10¶

1.10.0看起来很旧，但它在基岩版资源包里并不总是“过时”。当前Microsoft Learn平台版本指南仍把动画、动画控制器、附着物和渲染控制器等资源包文件的最低版本列为1.10.0。所以本页重点不是要求你删除它，而是教你判断哪些1.10.0可以保留。

常见位置¶

你可能会在这些文件里看到"format_version": "1.10.0"：

文件类型	常见目录	是否常见
客户端实体定义	`RP\entity`	常见
动画	`RP\animations`	常见
动画控制器	`RP\animation_controllers`	常见
渲染控制器	`RP\render_controllers`	常见
附着物	`RP\attachables`	常见

客户端实体定义示例¶

很多实体教程会用1.10.0客户端实体文件把模型、纹理、材质和渲染控制器关联起来：

{
  "format_version": "1.10.0",
  "minecraft:client_entity": {
    "description": {
      "identifier": "sample:robot",
      "materials": {
        "default": "entity"
      },
      "textures": {
        "default": "textures/entity/robot"
      },
      "geometry": {
        "default": "geometry.robot"
      },
      "render_controllers": [
        "controller.render.default"
      ],
      "spawn_egg": {
        "base_color": "#505152",
        "overlay_color": "#3b9dff"
      }
    }
  }
}

如果这个文件在当前游戏中没有内容日志错误，并且只是作为客户端渲染描述使用，通常不需要因为版本号低而立刻改写。

动画和动画控制器¶

动画文件定义骨骼在不同时间的旋转、位置或缩放。动画控制器则像状态机，决定什么时候播放哪个动画。当前官方动画概览仍使用1.10.0客户端实体示例，并说明动画控制器用于根据事件或表达式触发动画。

迁移旧动画时，优先检查这些点：

动画名称是否仍与客户端实体文件中的短名和长名对应。
骨骼名是否与Blockbench导出的几何体一致。
Molang查询是否仍存在。
动画控制器状态是否可能卡在某个状态。

什么时候需要迁移¶

以下情况才需要认真迁移或重写：

内容日志报告字段已弃用、无法解析或语义改变。
文件同时混入更旧的客户端实体结构。
旧教程要求复制已经不存在的原版资源路径。
你要使用当前版本新增的字段，而旧格式无法表达。

如果只是format_version数字低，但官方当前版本表仍认可该文件类型使用1.10.0，不要把迁移工作浪费在“改数字”上。正确做法是保留可工作的版本，并把测试重点放在资源引用、动画播放和内容日志上。