1.21.1 到 26.1 NeoForge 移植指南

• 原始仓库：https://github.com/Leclowndu93150/Porting-Primers
• 原始地址：https://leclowndu93150.github.io/Porting-Primers

本网站索引了上游 NeoForge 移植入门文档，以便您直接跳转到相关章节。

这里涵盖的上游链条是：

1.21.1 -> 1.21.2/3 -> 1.21.4 -> 1.21.5 -> 1.21.6 -> 1.21.7 -> 1.21.8 -> 1.21.9 -> 1.21.10 -> 1.21.11 -> 26.1

上游没有单独的 1.21.3 入门文档。1.21.2 的入门文档涵盖了 1.21.1 -> 1.21.2/3 这一步。

如何使用本网站

如果您知道哪个子系统发生了变化，请使用下面的主题地图。每个链接都直接指向相关章节。

如果同一子系统在多个版本中都发生了变化，请参阅频繁变更的系统了解阅读顺序。

如果您想要原始的入门文档，请参阅详细入门文档，其中包含指向每个章节的锚点链接的完整目录。

如果您遇到编译错误，请使用类和方法的索引来查找它在哪里发生了变化。

主题地图

构建、映射、名称、导入和包移动

• 重命名混乱 (1.21.11)
• ResourceLocation 到 Identifier (1.21.11)
• util 包 (1.21.11)
• critereon 到 criterion (1.21.11)
• 实体和对象子包 (1.21.11)
• Java 25 与反混淆 (26.1)
• JSpecify 注解 (1.21.11)
• 使用注解 (1.21.11)

数据生成、资源包、注册表、标签、编解码器、战利品、验证和配方序列化

• 持有者集过渡 (1.21.2)
• 原料的转变 (1.21.2)
• 配方，现在采用注册表格式 (1.21.2)
• 配方提供者，数据提供者的“并非真正” (1.21.2)
• 乐器，数据包版 (1.21.2)
• 试炼刷怪笼配置，现在采用数据包形式 (1.21.2)
• 条件，通过 HolderGetter 提供 (1.21.2 次要)
• 可编解码的 JSON 重载监听器 (1.21.2 次要)
• 上下文键 (1.21.2 次要)
• SimpleJsonResourceReloadListener (1.21.4 次要)
• MetadataSectionSerializer，被 Codec 取代 (1.21.4 次要)
• 标签与解析 (1.21.5)
• 模型重做 (1.21.5)
• 注册表上下文交换器 (1.21.5 次要)
• 定时器回调，加入编解码器俱乐部！ (1.21.5 次要)
• TagAppender 重写 (1.21.6)
• 通用编码与解码：替换直接 NBT 访问 (1.21.6)
• 战利品类型展开 (26.1)
• 验证大修 (26.1)
• 数据包村民交易 (26.1)
• 序列化器记录与配方信息 (26.1)
• 新标签提供者 (26.1 次要)
• 可种植标签 (26.1 次要)

物品、组件、装备、盔甲、工具、战斗、染料和消耗品

• 装备与物品、模型等等 (1.21.2)
• 盔甲材料、装备和模型（纹理） (1.21.2)
• 消耗品 (1.21.2)
• 交互结果 (1.21.2)
• BlockEntityTypes 私有化了！ (1.21.2)
• 注册表对象 ID，在属性里？ (1.21.2)
• 属性变更 (1.21.2)
• 燃料值 (1.21.2 次要)
• 生物替换当前物品 (1.21.4)
• 武器、工具和盔甲：去除冗余 (1.21.5)
• 数据组件获取器 (1.21.5)
• 组件交互事件 (1.21.5 次要)
• 物品拥有者 (1.21.9 次要)
• 容器使用者 (1.21.9 次要)
• 槽位来源 (1.21.11 次要)
• 新数据组件 (1.21.11)
• 数据组件初始化器 (26.1)
• 物品实例与堆栈模板 (26.1)
• 染料组件 (26.1)
• 数据组件新增 (26.1 次要)

渲染、模型、着色器、粒子、方块模型、物品模型、材质、纹理图集和视觉管线

• GUI 渲染类型 (1.21.2)
• 着色器重写 (1.21.2)
• 实体渲染状态 (1.21.2)
• 雾参数 (1.21.2 次要)
• 发光强度 (1.21.2 次要)
• 地图纹理 (1.21.2 次要)
• 客户端物品 (1.21.4)
• 粒子，通过渲染类型渲染 (1.21.4)
• 渲染管线重做 (1.21.5)
• 模型重做 (1.21.5)
• 纹理图集重做 (1.21.5 次要)
• GUI 变更 (1.21.6)
• Blaze3d 变更 (1.21.6)
• 移除生物效果图集 (1.21.6 次要)
• 动画烘焙 (1.21.6 次要)
• ChunkSectionLayers (1.21.6 次要)
• 小幅迁移 (1.21.7 —— GUI 渲染后续)
• 小幅迁移 (1.21.8 —— GraphicsWorkarounds)
• 功能提交：电影版 (1.21.9)
• 字体字形管线 (1.21.9)
• 客户端资源拆分 (1.21.9 次要)
• 哦，又来了，一次渲染重写 (1.21.11)
• Gizmo 控件 (1.21.11)
• 更多渲染变更 (26.1)
• 实体纹理与成年/幼年模型 (26.1 次要)
• 音频变更 (26.1 次要)

实体、生物、生物 AI、转化、生成和实体数据

• 交互结果 (1.21.2)
• 爆——炸——！ (1.21.2 次要 —— Explosion 现在是一个接口)
• 生物转化 (1.21.2 次要 —— Mob#convertTo 已变更)
• 矿车行为 (1.21.2 次要)
• 末影珍珠加载区块 (1.21.2 次要)
• 实体引用 (1.21.5 次要 —— UUID 被 EntityReference 取代)
• 拴绳 (1.21.6 次要)
• 类型化实体数据 (1.21.9 次要)
• 名称和 ID (1.21.9 次要)
• interactAt 的移除 (26.1 次要 —— Entity#interactAt 已移除)
• 活动与大脑 (26.1 次要 —— AI 大脑系统变更)
• 更多实体声音变种注册表 (26.1 次要)
• 僵尸鹦鹉螺变体 (1.21.11 次要)

GUI、输入、按键绑定、调试屏幕、调试工具、RPC 工具和测试基础设施

• GUI 渲染类型 (1.21.2)
• 游戏测试大修 (1.21.5)
• GUI 变更 (1.21.6)
• 小幅迁移 (1.21.7)
• 调试大修 (1.21.9)
• 调试屏幕 (1.21.9)
• JSON-RPC 管理服务器 (1.21.9)
• 输入处理整合 (1.21.9)
• 光标类型 (1.21.9 次要)
• Gizmo 控件 (1.21.11)
• 文本收集器 (1.21.11 次要)
• OptionEnum 移除 (1.21.11 次要)
• 容器屏幕变更 (26.1 次要)
• 输入消息编辑器支持 (26.1 次要)
• 测试环境状态追踪 (26.1 次要)

世界状态、保存数据、游戏规则、时间线、时钟、玩家、权限、路径点和其他服务端系统

• 正确处理方块实体的移除 (1.21.5)
• 体素形状辅助类 (1.21.5)
• 加权列表重做 (1.21.5)
• 加载票 (1.21.5)
• 保存数据，现在带有类型 (1.21.5)
• 方块效果应用器 (1.21.5 次要)
• 路径点 (1.21.6)
• 服务端玩家变更 (1.21.6)
• 权限来源 (1.21.6 次要)
• Level#isClientSide 现在为 private (1.21.9)
• 加载票标志 (1.21.9 次要)
• 重生数据 (1.21.9 次要)
• 权限大修 (1.21.11)
• 环境属性的时间线 (1.21.11)
• 游戏规则洗牌 (1.21.11)
• Level#random 字段现在为 protected (26.1)
• 世界时钟与时间标记 (26.1)
• 将主关卡数据拆分为保存数据 (26.1)
• 聊天权限 (26.1 次要)
• ChunkPos，现在是一个记录 (26.1 次要)
• 炼药锅交互调度器 (26.1 次要)
• 流体逻辑重组 (26.1 次要)
• 移除随机斑块特征 (26.1 次要)
• 基于规则的方块状态提供者 (26.1 次要)
• 文件修缮工 (26.1 次要)

其余的小幅迁移

• 语言文件的移除与重命名 (1.21.2)
• MacosUtil#IS_MACOS (1.21.2)
• 更智能的帧率限制 (1.21.2)
• 朝向 (1.21.2)
• 移除雕刻生成步骤 (1.21.2)
• 连续执行器 (1.21.2)
• 分析器与 Tracy 客户端 (1.21.2)
• Tick节流器 (1.21.2)
• 音乐，现在带有音量控制 (1.21.4)
• 解作用域玩家参数 (1.21.5)
• 重载实例创建 (1.21.5)
• JOML 后端接口 (1.21.5)
• 状态效果字段重命名 (1.21.5)
• 重载监听器共享状态 (1.21.9)
• “在架子上” 变换 (1.21.9)
• 共享文本区域调试器 (1.21.11)
• 特定逻辑变更 (1.21.11)
• 类型化实例 (26.1)
• 不再有绊线管线 (26.1)
• 环境属性新增 (26.1)
• 特定逻辑变更 (26.1)

每份入门文档的“小幅迁移”章节中还包含“新标签”、“标签变更”、“新增列表”、“变更列表”和“移除列表”子章节。如需查看这些内容，请前往详细入门文档中的完整入门文档页面。

类和方法索引

如果您遇到编译错误或需要查找特定类/方法在哪里发生了变化，请在此表中搜索。

来源与署名

拆分后的入门文档页面复制自 ChampionAsh5357/neoforged-github，分支 update/26.1。详见来源与署名。