旧版Bedrock Wiki资料辨析¶

旧版Bedrock Wiki记录了大量1.8至1.16时代的附加包资料。它的价值主要在于解释旧包为何仍能加载、旧教程为何使用较低的format_version，以及某些兼容格式在今天应如何判断；它不应作为新项目的默认教程来源。

不要把旧资料当作最新版推荐做法

维护旧包时可以参考旧版Bedrock Wiki的历史语境；创建新包时，应优先使用当前Microsoft Learn、游戏导出的文档、基岩版元数据和新版Bedrock Wiki。若旧资料与这些资料冲突，应以官方或新版资料为准。

适合保留的历史信息¶

旧版最有保留价值的内容通常具有以下特征：

解释某个低格式版本为何仍会在当前资源包中出现。
描述旧项目常见的文件分工，例如早期物品资源侧文件与行为侧文件的差异。
说明旧版实验性功能的历史入口，便于迁移时识别它们。
给出排查旧包的思路，例如从内容日志、资源映射和文件路径开始检查。

这些信息在写入主线教程时必须重新核对当前资料；若无法核对，则只能作为过时资料保留。

常见兼容场景¶

旧资料主题	兼容价值	处理方式
`1.10.0`客户端实体、动画、动画控制器和渲染控制器	许多资源包文件至今仍可能使用这些格式版本。	只要当前官方资料仍认可且内容日志无错误，不要仅因版本号低而改写。
`1.16.100`物品格式	用于理解早期新版物品格式，以及旧教程中“物品从资源包侧迁入行为包侧”的迁移语境。	新项目应回到当前物品组件资料；旧项目迁移时先确认图标、分类和组件是否仍被当前游戏接受。
旧实验性方块、地形生成和生物群系格式	可帮助读懂旧包中的假方块、自定义生物群系、地物和地物规则。	不直接照搬，应与当前数据驱动方块、地物和生物群系资料逐项核对。
早期GameTest与脚本资料	记录了`GameTest`、`Minecraft`命名空间和`javascript`模块时期的写法。	当前脚本API使用`@minecraft/*`模块和`script`模块，旧写法仅用于识别历史项目。
JSON UI、材质和旧着色器技巧	可解释大量社区资源包为何依赖硬编码控件、材质名或渲染技巧。	这些内容易受客户端版本影响，应放在专门话题或过时教程中说明限制，不应写成稳定API。
原版使用统计表	能帮助理解旧版本原版包如何使用组件、标签和生成规则。	当前参考应以官方导出文档、基岩版元数据和新版资料为准；旧表只作为历史对照。

旧物品格式¶

旧版资料经常把物品分为1.10格式和1.16.100格式。前者常见于资源包items目录，图标引用通常直接写作字符串；后者把物品定义放在行为包items目录，并在组件中使用minecraft:icon对象引用item_texture.json中的短名称。

1.16.100时期的旧示例

{
  "format_version": "1.16.100",
  "minecraft:item": {
    "description": {
      "identifier": "example:gem",
      "category": "items"
    },
    "components": {
      "minecraft:icon": {
        "texture": "gem"
      }
    }
  }
}

该示例适合用于识别旧教程，不代表当前物品教程的完整写法。当前游戏的物品组件、菜单分类和实验性要求已经多次变化；迁移时应以当前官方物品资料为准，并通过内容日志确认每个组件是否仍被接受。

早期GameTest脚本¶

旧版Bedrock Wiki中的GameTest教程来自1.16.210附近的实验性阶段。当时的清单文件使用type为javascript的模块，并通过UUID声明Minecraft和GameTest原生模块依赖；脚本中也会出现如下导入：

早期GameTest写法

import * as GameTest from "GameTest";
import { BlockLocation } from "Minecraft";

当前脚本API已经改为使用@minecraft/server、@minecraft/server-gametest等模块，并在清单文件中声明type为script的模块。看到旧导入时，应把它视为迁移信号，而不是继续新增旧式代码。

资源列表与硬编码资源¶

旧版资料强调过textures_list.json、私用区表情符号、JSON UI控件表和材质名列表。这些内容的共同特点是依赖客户端资源实现或原版资源快照，具有明显的版本敏感性。

textures_list.json可用于理解旧资源包为何显式列出纹理路径；若当前内容日志没有要求，不应仅凭旧教程强制新增。
私用区表情符号属于客户端硬编码资源，旧表可能随平台和版本变化而失效。
JSON UI控件、绑定和材质名应以当前原版资源包与实际客户端测试为准。

迁移检查顺序¶

备份旧包，并在当前游戏中原样加载。
打开内容日志，记录所有错误和弃用警告。
按文件类型核对当前官方资料，不要只修改format_version数字。
对资源包文件优先检查路径、短名称、模型骨骼名、材质名和渲染控制器引用。
对行为包文件优先检查组件名、事件、过滤器、实验性开关和清单文件模块。
每迁移一类文件后重新进游戏测试，避免一次性改动过多导致无法定位问题。