Add zh-CN translation and update deployment

Add Chinese (zh-CN) localization and adjust deployment metadata and workflow. Translated README and extensive src content to Chinese, updated book.toml (language, title, description, authors, git-repository-url, and edit-url-template pointing to translate/zh-cn), and switched the GitHub Pages deploy workflow to trigger on translate/**. Prepares the repo to host and deploy the zh-CN translation and route edit links to the translation branch.
2026-04-14 17:03:08 +08:00 · 2026-04-14 17:03:08 +08:00 · bd6f1d5ffe
commit bd6f1d5ffe
parent 7bf7ee6fe6
18 changed files with 11402 additions and 12048 deletions
--- a/.github/workflows/deploy-pages.yml
+++ b/.github/workflows/deploy-pages.yml
@ -3,7 +3,7 @@ name: Deploy Pages
 on:
  push:
    branches:
-      - main
+      - translate/**
  workflow_dispatch:

 permissions:
--- a/README.md
+++ b/README.md
@ -1,11 +1,10 @@
-# Porting Primers
+# 移植指南

-This repository publishes an `mdBook` site for NeoForge porting primers covering the path from `1.21.1` to `26.1`.
+本仓库发布了一个`mdBook`站点，收录NeoForge从`1.21.1`到`26.1`版本的移植指南文档。

-The content includes:
+内容包含：
+- 按主题分类的导航页，可快速跳转至对应章节
+- 拆分后的上游指南页面
+- 整合版直接移植概览文档

- a topic-indexed landing page for jumping to the relevant primer sections
- the split upstream primer pages
- a compiled direct-port overview
-
-The site is deployed automatically to GitHub Pages from the `main` branch through the workflow in `.github/workflows/deploy-pages.yml`.
+站点通过`.github/workflows/deploy-pages.yml`工作流自动部署至GitHub Pages，源文件来自`main`分支。
--- a/book.toml
+++ b/book.toml
@ -1,16 +1,16 @@
 [book]
-authors = ["Leclowndu93150", "OpenAI Codex"]
-language = "en"
+authors = ["Leclowndu93150", "OpenAI Codex", "Gugle", "Deepseek"]
+language = "zh-CN"
 src = "src"
-title = "1.21.1 to 26.1 Porting Primers"
-description = "A topic-indexed NeoForge porting guide and upstream primer archive for migrating from 1.21.1 to 26.1."
+title = "1.21.1至26.1迁移指南"
+description = "针对从1.21.1迁移至26.1版本的主题索引式NeoForge迁移指南与上游基础教程存档。"

 [output.html]
 default-theme = "navy"
 preferred-dark-theme = "navy"
-git-repository-url = "https://github.com/Leclowndu93150/Porting-Primers"
+git-repository-url = "https://github.com/Gu-ZT/Porting-Primers"
 site-url = "/Porting-Primers/"
-edit-url-template = "https://github.com/Leclowndu93150/Porting-Primers/edit/main/{path}"
+edit-url-template = "https://github.com/Gu-ZT/Porting-Primers/edit/translate/zh-cn/{path}"
 no-section-label = true
 additional-css = ["theme/gitbook.css"]

--- a/src/README.md
+++ b/src/README.md
@ -1,271 +1,274 @@
-# 1.21.1 to 26.1 NeoForge Porting Guide
+# 1.21.1 到 26.1 NeoForge 移植指南

-This site indexes the upstream NeoForge porting primers so you can jump straight to the section that matters.
+> 原始仓库：https://github.com/Leclowndu93150/Porting-Primers
+> 原始地址：https://leclowndu93150.github.io/Porting-Primers

-The upstream chain covered here is:
+本网站索引了上游 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`

-There is no separate `1.21.3` primer upstream. The `1.21.2` primer covers the `1.21.1 -> 1.21.2/3` step.
+上游没有单独的 `1.21.3` 入门文档。`1.21.2` 的入门文档涵盖了 `1.21.1 -> 1.21.2/3` 这一步。

-## How to use this site
+## 如何使用本网站

-**If you know what subsystem changed**, use the [Topic Map](#topic-map) below. Every link goes directly to the relevant section.
+**如果您知道哪个子系统发生了变化**，请使用下面的[主题地图](#主题地图)。每个链接都直接指向相关章节。

-**If the same subsystem changed across multiple versions**, see [Repeatedly Changing Systems](repeatedly-changing-systems.md) for the reading order.
+**如果同一子系统在多个版本中都发生了变化**，请参阅[频繁变更的系统](repeatedly-changing-systems.md)了解阅读顺序。

-**If you want the raw primers**, see [Detailed Primers](detailed-primers/README.md) for a full table of contents with anchor links to every section.
+**如果您想要原始的入门文档**，请参阅[详细入门文档](detailed-primers/README.md)，其中包含指向每个章节的锚点链接的完整目录。

-**If you have a compile error**, use the [Class and Method Index](#class-and-method-index) to find where it changed.
+**如果您遇到编译错误**，请使用[类和方法的索引](#类和方法索引)来查找它在哪里发生了变化。

 ---

-## Topic Map
+## 主题地图

-**Build, mappings, names, imports, and package moves**
+**构建、映射、名称、导入和包移动**

- [The Rename Shuffle](detailed-primers/1.21.11-from-1.21.10.md#the-rename-shuffle) (1.21.11)
- [ResourceLocation to Identifier](detailed-primers/1.21.11-from-1.21.10.md#resourcelocation-to-identifier) (1.21.11)
- [The util Package](detailed-primers/1.21.11-from-1.21.10.md#the-util-package) (1.21.11)
- [critereon to criterion](detailed-primers/1.21.11-from-1.21.10.md#critereon-to-criterion) (1.21.11)
- [Entity and Object Subpackages](detailed-primers/1.21.11-from-1.21.10.md#entity-and-object-subpackages) (1.21.11)
- [Java 25 and Deobfuscation](detailed-primers/26.1-from-1.21.11.md#java-25-and-deobfuscation) (26.1)
- [JSpecify Annotations](detailed-primers/1.21.11-from-1.21.10.md#jspecify-annotations) (1.21.11)
- [Usage Annotations](detailed-primers/1.21.11-from-1.21.10.md#usage-annotations) (1.21.11)
+- [重命名混乱](detailed-primers/1.21.11-from-1.21.10.md#重命名混乱) (1.21.11)
+- [ResourceLocation 到 Identifier](detailed-primers/1.21.11-from-1.21.10.md#resourcelocation-到-identifier) (1.21.11)
+- [util 包](detailed-primers/1.21.11-from-1.21.10.md#util-包) (1.21.11)
+- [critereon 到 criterion](detailed-primers/1.21.11-from-1.21.10.md#critereon-到-criterion) (1.21.11)
+- [实体和对象子包](detailed-primers/1.21.11-from-1.21.10.md#实体和对象子包) (1.21.11)
+- [Java 25 与反混淆](detailed-primers/26.1-from-1.21.11.md#java-25-与反混淆) (26.1)
+- [JSpecify 注解](detailed-primers/1.21.11-from-1.21.10.md#jspecify-注解) (1.21.11)
+- [使用注解](detailed-primers/1.21.11-from-1.21.10.md#使用注解) (1.21.11)

-**Datagen, packs, registries, tags, codecs, loot, validation, and recipe serialization**
+**数据生成、资源包、注册表、标签、编解码器、战利品、验证和配方序列化**

- [The Holder Set Transition](detailed-primers/1.21.2-from-1.21.1.md#the-holder-set-transition) (1.21.2)
- [The Ingredient Shift](detailed-primers/1.21.2-from-1.21.1.md#the-ingredient-shift) (1.21.2)
- [Recipes, now in Registry format](detailed-primers/1.21.2-from-1.21.1.md#recipes-now-in-registry-format) (1.21.2)
- [Recipe Providers, the 'not actually' of Data Providers](detailed-primers/1.21.2-from-1.21.1.md#recipe-providers-the-not-actually-of-data-providers) (1.21.2)
- [Instruments, the Datapack Edition](detailed-primers/1.21.2-from-1.21.1.md#instruments-the-datapack-edition) (1.21.2)
- [Trial Spawner Configurations, now in Datapack Form](detailed-primers/1.21.2-from-1.21.1.md#trial-spawner-configurations-now-in-datapack-form) (1.21.2)
- [Critereons, Supplied with HolderGetters](detailed-primers/1.21.2-from-1.21.1.md#critereons-supplied-with-holdergetters) (1.21.2 minor)
- [Codecable Json Reload Listener](detailed-primers/1.21.2-from-1.21.1.md#codecable-json-reload-listener) (1.21.2 minor)
- [Context Keys](detailed-primers/1.21.2-from-1.21.1.md#context-keys) (1.21.2 minor)
- [SimpleJsonResourceReloadListener](detailed-primers/1.21.4-from-1.21.2-3.md#simplejsonresourcereloadlistener) (1.21.4 minor)
- [MetadataSectionSerializer, replaced by Codecs](detailed-primers/1.21.4-from-1.21.2-3.md#metadatasectionserializer-replaced-by-codecs) (1.21.4 minor)
- [Tags and Parsing](detailed-primers/1.21.5-from-1.21.4.md#tags-and-parsing) (1.21.5)
- [Model Rework](detailed-primers/1.21.5-from-1.21.4.md#model-rework) (1.21.5)
- [Registry Context Swapper](detailed-primers/1.21.5-from-1.21.4.md#registry-context-swapper) (1.21.5 minor)
- [Timer Callbacks, joining the codec club!](detailed-primers/1.21.5-from-1.21.4.md#timer-callbacks-joining-the-codec-club) (1.21.5 minor)
- [Tag Providers: Appender Rewrite](detailed-primers/1.21.6-from-1.21.5.md#tag-providers-appender-rewrite) (1.21.6)
- [Generic Encoding and Decoding: Replacing Direct NBT Access](detailed-primers/1.21.6-from-1.21.5.md#generic-encoding-and-decoding-replacing-direct-nbt-access) (1.21.6)
- [Loot Type Unrolling](detailed-primers/26.1-from-1.21.11.md#loot-type-unrolling) (26.1)
- [Validation Overhaul](detailed-primers/26.1-from-1.21.11.md#validation-overhaul) (26.1)
- [Datapack Villager Trades](detailed-primers/26.1-from-1.21.11.md#datapack-villager-trades) (26.1)
- [Serializer Records and Recipe Info](detailed-primers/26.1-from-1.21.11.md#serializer-records-and-recipe-info) (26.1)
- [New Tag Providers](detailed-primers/26.1-from-1.21.11.md#new-tag-providers) (26.1 minor)
- [Plantable Tags](detailed-primers/26.1-from-1.21.11.md#plantable-tags) (26.1 minor)
+- [持有者集过渡](detailed-primers/1.21.2-from-1.21.1.md#持有者集-过渡) (1.21.2)
+- [原料的转变](detailed-primers/1.21.2-from-1.21.1.md#原料的转变) (1.21.2)
+- [配方，现在采用注册表格式](detailed-primers/1.21.2-from-1.21.1.md#配方现在采用注册表格式) (1.21.2)
+- [配方提供者，数据提供者的“并非真正”](detailed-primers/1.21.2-from-1.21.1.md#配方提供者数据提供者的并非真正) (1.21.2)
+- [乐器，数据包版](detailed-primers/1.21.2-from-1.21.1.md#乐器-数据包版) (1.21.2)
+- [试炼刷怪笼配置，现在采用数据包形式](detailed-primers/1.21.2-from-1.21.1.md#试炼刷怪笼配置现在采用数据包形式) (1.21.2)
+- [条件，通过 HolderGetter 提供](detailed-primers/1.21.2-from-1.21.1.md#条件通过-holdergetter-提供) (1.21.2 次要)
+- [可编解码的 JSON 重载监听器](detailed-primers/1.21.2-from-1.21.1.md#可编解码的-json-重载监听器) (1.21.2 次要)
+- [上下文键](detailed-primers/1.21.2-from-1.21.1.md#上下文键) (1.21.2 次要)
+- [SimpleJsonResourceReloadListener](detailed-primers/1.21.4-from-1.21.2-3.md#simplejsonresourcereloadlistener) (1.21.4 次要)
+- [MetadataSectionSerializer，被 Codec 取代](detailed-primers/1.21.4-from-1.21.2-3.md#metadatasectionserializer被-codec-取代) (1.21.4 次要)
+- [标签与解析](detailed-primers/1.21.5-from-1.21.4.md#标签与解析) (1.21.5)
+- [模型重做](detailed-primers/1.21.5-from-1.21.4.md#模型重做) (1.21.5)
+- [注册表上下文交换器](detailed-primers/1.21.5-from-1.21.4.md#注册表上下文交换器) (1.21.5 次要)
+- [定时器回调，加入编解码器俱乐部！](detailed-primers/1.21.5-from-1.21.4.md#定时器回调加入编解码器俱乐部) (1.21.5 次要)
+- [TagAppender 重写](detailed-primers/1.21.6-from-1.21.5.md#TagAppender-重写) (1.21.6)
+- [通用编码与解码：替换直接 NBT 访问](detailed-primers/1.21.6-from-1.21.5.md#通用编码与解码替换直接-nbt-访问) (1.21.6)
+- [战利品类型展开](detailed-primers/26.1-from-1.21.11.md#战利品类型展开) (26.1)
+- [验证大修](detailed-primers/26.1-from-1.21.11.md#验证大修) (26.1)
+- [数据包村民交易](detailed-primers/26.1-from-1.21.11.md#数据包村民交易) (26.1)
+- [序列化器记录与配方信息](detailed-primers/26.1-from-1.21.11.md#序列化器记录与配方信息) (26.1)
+- [新标签提供者](detailed-primers/26.1-from-1.21.11.md#新标签提供者) (26.1 次要)
+- [可种植标签](detailed-primers/26.1-from-1.21.11.md#可种植标签) (26.1 次要)

-**Items, components, equipment, armor, tools, combat, dyes, and consumables**
+**物品、组件、装备、盔甲、工具、战斗、染料和消耗品**

- [Equipments and Items, Models and All](detailed-primers/1.21.2-from-1.21.1.md#equipments-and-items-models-and-all) (1.21.2)
- [Armor Materials, Equipment, and Model (Textures)](detailed-primers/1.21.2-from-1.21.1.md#armor-materials-equipment-and-model-textures) (1.21.2)
- [Consumables](detailed-primers/1.21.2-from-1.21.1.md#consumables) (1.21.2)
- [Interaction Results](detailed-primers/1.21.2-from-1.21.1.md#interaction-results) (1.21.2)
- [BlockEntityTypes Privatized!](detailed-primers/1.21.2-from-1.21.1.md#blockentitytypes-privatized) (1.21.2)
- [Registry Objcet Id, in the Properties?](detailed-primers/1.21.2-from-1.21.1.md#registry-objcet-id-in-the-properties) (1.21.2)
- [Properties Changes](detailed-primers/1.21.2-from-1.21.1.md#properties-changes) (1.21.2)
- [Fuel Values](detailed-primers/1.21.2-from-1.21.1.md#fuel-values) (1.21.2 minor)
- [Mob Replacing Current Items](detailed-primers/1.21.4-from-1.21.2-3.md#mob-replacing-current-items) (1.21.4)
- [Weapons, Tools, and Armor: Removing the Redundancies](detailed-primers/1.21.5-from-1.21.4.md#weapons-tools-and-armor-removing-the-redundancies) (1.21.5)
- [Data Component Getters](detailed-primers/1.21.5-from-1.21.4.md#data-component-getters) (1.21.5)
- [Component Interaction Events](detailed-primers/1.21.5-from-1.21.4.md#component-interaction-events) (1.21.5 minor)
- [Item Owner](detailed-primers/1.21.9-from-1.21.8.md#item-owner) (1.21.9 minor)
- [Container User](detailed-primers/1.21.9-from-1.21.8.md#container-user) (1.21.9 minor)
- [Slot Sources](detailed-primers/1.21.11-from-1.21.10.md#slot-sources) (1.21.11 minor)
- [New Data Components](detailed-primers/1.21.11-from-1.21.10.md#new-data-components) (1.21.11)
- [Data Component Initializers](detailed-primers/26.1-from-1.21.11.md#data-component-initializers) (26.1)
- [Item Instances and Stack Templates](detailed-primers/26.1-from-1.21.11.md#item-instances-and-stack-templates) (26.1)
- [Dye Component](detailed-primers/26.1-from-1.21.11.md#dye-component) (26.1)
- [Data Component Additions](detailed-primers/26.1-from-1.21.11.md#data-component-additions) (26.1 minor)
+- [装备与物品、模型等等](detailed-primers/1.21.2-from-1.21.1.md#装备与物品模型等等) (1.21.2)
+- [盔甲材料、装备和模型（纹理）](detailed-primers/1.21.2-from-1.21.1.md#盔甲材料装备和模型纹理) (1.21.2)
+- [消耗品](detailed-primers/1.21.2-from-1.21.1.md#消耗品) (1.21.2)
+- [交互结果](detailed-primers/1.21.2-from-1.21.1.md#交互结果) (1.21.2)
+- [BlockEntityTypes 私有化了！](detailed-primers/1.21.2-from-1.21.1.md#blockentitytypes-私有化了) (1.21.2)
+- [注册表对象 ID，在属性里？](detailed-primers/1.21.2-from-1.21.1.md#注册表对象-id在属性里) (1.21.2)
+- [属性变更](detailed-primers/1.21.2-from-1.21.1.md#属性变更) (1.21.2)
+- [燃料值](detailed-primers/1.21.2-from-1.21.1.md#燃料值) (1.21.2 次要)
+- [生物替换当前物品](detailed-primers/1.21.4-from-1.21.2-3.md#生物-替换当前物品) (1.21.4)
+- [武器、工具和盔甲：去除冗余](detailed-primers/1.21.5-from-1.21.4.md#武器工具和盔甲去除冗余) (1.21.5)
+- [数据组件获取器](detailed-primers/1.21.5-from-1.21.4.md#数据组件获取器) (1.21.5)
+- [组件交互事件](detailed-primers/1.21.5-from-1.21.4.md#组件交互事件) (1.21.5 次要)
+- [物品拥有者](detailed-primers/1.21.9-from-1.21.8.md#物品拥有者) (1.21.9 次要)
+- [容器使用者](detailed-primers/1.21.9-from-1.21.8.md#容器使用者) (1.21.9 次要)
+- [槽位来源](detailed-primers/1.21.11-from-1.21.10.md#槽位来源) (1.21.11 次要)
+- [新数据组件](detailed-primers/1.21.11-from-1.21.10.md#新数据组件) (1.21.11)
+- [数据组件初始化器](detailed-primers/26.1-from-1.21.11.md#数据组件初始化器) (26.1)
+- [物品实例与堆栈模板](detailed-primers/26.1-from-1.21.11.md#物品实例与堆栈模板) (26.1)
+- [染料组件](detailed-primers/26.1-from-1.21.11.md#染料组件) (26.1)
+- [数据组件新增](detailed-primers/26.1-from-1.21.11.md#数据组件新增) (26.1 次要)

-**Rendering, models, shaders, particles, block models, item models, materials, atlases, and visual pipelines**
+**渲染、模型、着色器、粒子、方块模型、物品模型、材质、纹理图集和视觉管线**

- [Gui Render Types](detailed-primers/1.21.2-from-1.21.1.md#gui-render-types) (1.21.2)
- [Shader Rewrites](detailed-primers/1.21.2-from-1.21.1.md#shader-rewrites) (1.21.2)
- [Entity Render States](detailed-primers/1.21.2-from-1.21.1.md#entity-render-states) (1.21.2)
- [Fog Parameters](detailed-primers/1.21.2-from-1.21.1.md#fog-parameters) (1.21.2 minor)
- [Light Emissions](detailed-primers/1.21.2-from-1.21.1.md#light-emissions) (1.21.2 minor)
- [Map Textures](detailed-primers/1.21.2-from-1.21.1.md#map-textures) (1.21.2 minor)
- [Client Items](detailed-primers/1.21.4-from-1.21.2-3.md#client-items) (1.21.4)
- [Particles, rendered through Render Types](detailed-primers/1.21.4-from-1.21.2-3.md#particles-rendered-through-render-types) (1.21.4)
- [Render Pipeline Rework](detailed-primers/1.21.5-from-1.21.4.md#render-pipeline-rework) (1.21.5)
- [Model Rework](detailed-primers/1.21.5-from-1.21.4.md#model-rework) (1.21.5)
- [Texture Atlas Reworks](detailed-primers/1.21.5-from-1.21.4.md#texture-atlas-reworks) (1.21.5 minor)
- [GUI Changes](detailed-primers/1.21.6-from-1.21.5.md#gui-changes) (1.21.6)
- [Blaze3d Changes](detailed-primers/1.21.6-from-1.21.5.md#blaze3d-changes) (1.21.6)
- [Removal of Mob Effects Atlas](detailed-primers/1.21.6-from-1.21.5.md#removal-of-mob-effects-atlas) (1.21.6 minor)
- [Animation Baking](detailed-primers/1.21.6-from-1.21.5.md#animation-baking) (1.21.6 minor)
- [ChunkSectionLayers](detailed-primers/1.21.6-from-1.21.5.md#chunksectionlayers) (1.21.6 minor)
- [Minor Migrations](detailed-primers/1.21.7-from-1.21.6.md#minor-migrations) (1.21.7 -- GUI render follow-ups)
- [Minor Migrations](detailed-primers/1.21.8-from-1.21.7.md#minor-migrations) (1.21.8 -- GraphicsWorkarounds)
- [Feature Submissions: The Movie](detailed-primers/1.21.9-from-1.21.8.md#feature-submissions-the-movie) (1.21.9)
- [The Font Glyph Pipeline](detailed-primers/1.21.9-from-1.21.8.md#the-font-glyph-pipeline) (1.21.9)
- [Client Asset Split](detailed-primers/1.21.9-from-1.21.8.md#client-asset-split) (1.21.9 minor)
- [Oh Hey, Another Rendering Rewrite](detailed-primers/1.21.11-from-1.21.10.md#oh-hey-another-rendering-rewrite) (1.21.11)
- [Gizmos](detailed-primers/1.21.11-from-1.21.10.md#gizmos) (1.21.11)
- [Even More Rendering Changes](detailed-primers/26.1-from-1.21.11.md#even-more-rendering-changes) (26.1)
- [Entity Textures and Adult/Baby Models](detailed-primers/26.1-from-1.21.11.md#entity-textures-and-adultbaby-models) (26.1 minor)
- [Audio Changes](detailed-primers/26.1-from-1.21.11.md#audio-changes) (26.1 minor)
+- [GUI 渲染类型](detailed-primers/1.21.2-from-1.21.1.md#gui-渲染类型) (1.21.2)
+- [着色器重写](detailed-primers/1.21.2-from-1.21.1.md#着色器重写) (1.21.2)
+- [实体渲染状态](detailed-primers/1.21.2-from-1.21.1.md#实体渲染状态) (1.21.2)
+- [雾参数](detailed-primers/1.21.2-from-1.21.1.md#雾参数) (1.21.2 次要)
+- [发光强度](detailed-primers/1.21.2-from-1.21.1.md#发光强度) (1.21.2 次要)
+- [地图纹理](detailed-primers/1.21.2-from-1.21.1.md#地图纹理) (1.21.2 次要)
+- [客户端物品](detailed-primers/1.21.4-from-1.21.2-3.md#客户端物品) (1.21.4)
+- [粒子，通过渲染类型渲染](detailed-primers/1.21.4-from-1.21.2-3.md#粒子通过渲染类型渲染) (1.21.4)
+- [渲染管线重做](detailed-primers/1.21.5-from-1.21.4.md#渲染管线重做) (1.21.5)
+- [模型重做](detailed-primers/1.21.5-from-1.21.4.md#模型重做) (1.21.5)
+- [纹理图集重做](detailed-primers/1.21.5-from-1.21.4.md#纹理图集重做) (1.21.5 次要)
+- [GUI 变更](detailed-primers/1.21.6-from-1.21.5.md#gui-变更) (1.21.6)
+- [Blaze3d 变更](detailed-primers/1.21.6-from-1.21.5.md#blaze3d-变更) (1.21.6)
+- [移除生物效果图集](detailed-primers/1.21.6-from-1.21.5.md#移除生物效果图集) (1.21.6 次要)
+- [动画烘焙](detailed-primers/1.21.6-from-1.21.5.md#动画烘焙) (1.21.6 次要)
+- [ChunkSectionLayers](detailed-primers/1.21.6-from-1.21.5.md#chunksectionlayers) (1.21.6 次要)
+- [小幅迁移](detailed-primers/1.21.7-from-1.21.6.md#小幅迁移) (1.21.7 —— GUI 渲染后续)
+- [小幅迁移](detailed-primers/1.21.8-from-1.21.7.md#小幅迁移) (1.21.8 —— GraphicsWorkarounds)
+- [功能提交：电影版](detailed-primers/1.21.9-from-1.21.8.md#功能提交电影版) (1.21.9)
+- [字体字形管线](detailed-primers/1.21.9-from-1.21.8.md#字体-字形-管线) (1.21.9)
+- [客户端资源拆分](detailed-primers/1.21.9-from-1.21.8.md#客户端资源拆分) (1.21.9 次要)
+- [哦，又来了，一次渲染重写](detailed-primers/1.21.11-from-1.21.10.md#哦又来了一次渲染重写) (1.21.11)
+- [Gizmo 控件](detailed-primers/1.21.11-from-1.21.10.md#gizmo-控件) (1.21.11)
+- [更多渲染变更](detailed-primers/26.1-from-1.21.11.md#更多渲染变更) (26.1)
+- [实体纹理与成年/幼年模型](detailed-primers/26.1-from-1.21.11.md#实体纹理与成年幼年模型) (26.1 次要)
+- [音频变更](detailed-primers/26.1-from-1.21.11.md#音频变更) (26.1 次要)

-**Entities, mobs, mob AI, conversions, spawning, and entity data**
+**实体、生物、生物 AI、转化、生成和实体数据**

- [Interaction Results](detailed-primers/1.21.2-from-1.21.1.md#interaction-results) (1.21.2)
- [EXPLOOOOSSSION!](detailed-primers/1.21.2-from-1.21.1.md#exploooosssion) (1.21.2 minor -- `Explosion` is now an interface)
- [Mob Conversions](detailed-primers/1.21.2-from-1.21.1.md#mob-conversions) (1.21.2 minor -- `Mob#convertTo` changed)
- [Minecart Behavior](detailed-primers/1.21.2-from-1.21.1.md#minecart-behavior) (1.21.2 minor)
- [Ender Pearl Chunk Loading](detailed-primers/1.21.2-from-1.21.1.md#ender-pearl-chunk-loading) (1.21.2 minor)
- [Entity References](detailed-primers/1.21.5-from-1.21.4.md#entity-references) (1.21.5 minor -- UUID replaced by `EntityReference`)
- [Leashes](detailed-primers/1.21.6-from-1.21.5.md#leashes) (1.21.6 minor)
- [Typed Entity Data](detailed-primers/1.21.9-from-1.21.8.md#typed-entity-data) (1.21.9 minor)
- [Name And Id](detailed-primers/1.21.9-from-1.21.8.md#name-and-id) (1.21.9 minor)
- [The Removal of interactAt](detailed-primers/26.1-from-1.21.11.md#the-removal-of-interactat) (26.1 minor -- `Entity#interactAt` removed)
- [Activities and Brains](detailed-primers/26.1-from-1.21.11.md#activities-and-brains) (26.1 minor -- AI brain system changes)
- [More Entity Sound Variant Registries](detailed-primers/26.1-from-1.21.11.md#more-entity-sound-variant-registries) (26.1 minor)
- [Zombie Nautilus Variant](detailed-primers/1.21.11-from-1.21.10.md#zombie-nautilus-variant) (1.21.11 minor)
+- [交互结果](detailed-primers/1.21.2-from-1.21.1.md#交互结果) (1.21.2)
+- [爆——炸——！](detailed-primers/1.21.2-from-1.21.1.md#爆炸) (1.21.2 次要 —— `Explosion` 现在是一个接口)
+- [生物转化](detailed-primers/1.21.2-from-1.21.1.md#生物转化) (1.21.2 次要 —— `Mob#convertTo` 已变更)
+- [矿车行为](detailed-primers/1.21.2-from-1.21.1.md#矿车行为) (1.21.2 次要)
+- [末影珍珠加载区块](detailed-primers/1.21.2-from-1.21.1.md#末影珍珠加载区块) (1.21.2 次要)
+- [实体引用](detailed-primers/1.21.5-from-1.21.4.md#实体引用) (1.21.5 次要 —— UUID 被 `EntityReference` 取代)
+- [拴绳](detailed-primers/1.21.6-from-1.21.5.md#拴绳) (1.21.6 次要)
+- [类型化实体数据](detailed-primers/1.21.9-from-1.21.8.md#类型化实体数据) (1.21.9 次要)
+- [名称和 ID](detailed-primers/1.21.9-from-1.21.8.md#名称和-id) (1.21.9 次要)
+- [interactAt 的移除](detailed-primers/26.1-from-1.21.11.md#interactat-的移除) (26.1 次要 —— `Entity#interactAt` 已移除)
+- [活动与大脑](detailed-primers/26.1-from-1.21.11.md#活动与大脑) (26.1 次要 —— AI 大脑系统变更)
+- [更多实体声音变种注册表](detailed-primers/26.1-from-1.21.11.md#更多实体声音变种注册表) (26.1 次要)
+- [僵尸鹦鹉螺变体](detailed-primers/1.21.11-from-1.21.10.md#僵尸鹦鹉螺变体) (1.21.11 次要)

-**GUI, input, keybinds, debug screens, debug tooling, RPC tooling, and test infrastructure**
+**GUI、输入、按键绑定、调试屏幕、调试工具、RPC 工具和测试基础设施**

- [Gui Render Types](detailed-primers/1.21.2-from-1.21.1.md#gui-render-types) (1.21.2)
- [The Game Test Overhaul](detailed-primers/1.21.5-from-1.21.4.md#the-game-test-overhaul) (1.21.5)
- [GUI Changes](detailed-primers/1.21.6-from-1.21.5.md#gui-changes) (1.21.6)
- [Minor Migrations](detailed-primers/1.21.7-from-1.21.6.md#minor-migrations) (1.21.7)
- [The Debugging Overhaul](detailed-primers/1.21.9-from-1.21.8.md#the-debugging-overhaul) (1.21.9)
- [Debug Screens](detailed-primers/1.21.9-from-1.21.8.md#debug-screens) (1.21.9)
- [The JSON-RPC Management Servers](detailed-primers/1.21.9-from-1.21.8.md#the-json-rpc-management-servers) (1.21.9)
- [Input Handling Consolidation](detailed-primers/1.21.9-from-1.21.8.md#input-handling-consolidation) (1.21.9)
- [Cursor Types](detailed-primers/1.21.9-from-1.21.8.md#cursor-types) (1.21.9 minor)
- [Gizmos](detailed-primers/1.21.11-from-1.21.10.md#gizmos) (1.21.11)
- [Text Collectors](detailed-primers/1.21.11-from-1.21.10.md#text-collectors) (1.21.11 minor)
- [OptionEnum Removal](detailed-primers/1.21.11-from-1.21.10.md#optionenum-removal) (1.21.11 minor)
- [Container Screen Changes](detailed-primers/26.1-from-1.21.11.md#container-screen-changes) (26.1 minor)
- [Input Message Editor Support](detailed-primers/26.1-from-1.21.11.md#input-message-editor-support) (26.1 minor)
- [Test Environment State Tracking](detailed-primers/26.1-from-1.21.11.md#test-environment-state-tracking) (26.1 minor)
+- [GUI 渲染类型](detailed-primers/1.21.2-from-1.21.1.md#gui-渲染类型) (1.21.2)
+- [游戏测试大修](detailed-primers/1.21.5-from-1.21.4.md#游戏测试大修) (1.21.5)
+- [GUI 变更](detailed-primers/1.21.6-from-1.21.5.md#gui-变更) (1.21.6)
+- [小幅迁移](detailed-primers/1.21.7-from-1.21.6.md#小幅迁移) (1.21.7)
+- [调试大修](detailed-primers/1.21.9-from-1.21.8.md#调试大修) (1.21.9)
+- [调试屏幕](detailed-primers/1.21.9-from-1.21.8.md#调试屏幕) (1.21.9)
+- [JSON-RPC 管理服务器](detailed-primers/1.21.9-from-1.21.8.md#json-rpc-管理服务器) (1.21.9)
+- [输入处理整合](detailed-primers/1.21.9-from-1.21.8.md#输入处理整合) (1.21.9)
+- [光标类型](detailed-primers/1.21.9-from-1.21.8.md#光标类型) (1.21.9 次要)
+- [Gizmo 控件](detailed-primers/1.21.11-from-1.21.10.md#gizmo-控件) (1.21.11)
+- [文本收集器](detailed-primers/1.21.11-from-1.21.10.md#文本收集器) (1.21.11 次要)
+- [OptionEnum 移除](detailed-primers/1.21.11-from-1.21.10.md#optionenum-移除) (1.21.11 次要)
+- [容器屏幕变更](detailed-primers/26.1-from-1.21.11.md#容器屏幕变更) (26.1 次要)
+- [输入消息编辑器支持](detailed-primers/26.1-from-1.21.11.md#输入消息编辑器支持) (26.1 次要)
+- [测试环境状态追踪](detailed-primers/26.1-from-1.21.11.md#测试环境状态追踪) (26.1 次要)

-**World state, saved data, game rules, timelines, clocks, players, permissions, waypoints, and other server-side systems**
+**世界状态、保存数据、游戏规则、时间线、时钟、玩家、权限、路径点和其他服务端系统**

- [Handling the Removal of Block Entities Properly](detailed-primers/1.21.5-from-1.21.4.md#handling-the-removal-of-block-entities-properly) (1.21.5)
- [Voxel Shape Helpers](detailed-primers/1.21.5-from-1.21.4.md#voxel-shape-helpers) (1.21.5)
- [Weighted List Rework](detailed-primers/1.21.5-from-1.21.4.md#weighted-list-rework) (1.21.5)
- [Tickets](detailed-primers/1.21.5-from-1.21.4.md#tickets) (1.21.5)
- [Saved Data, now with Types](detailed-primers/1.21.5-from-1.21.4.md#saved-data-now-with-types) (1.21.5)
- [Block Effect Appliers](detailed-primers/1.21.5-from-1.21.4.md#block-effect-appliers) (1.21.5 minor)
- [Waypoints](detailed-primers/1.21.6-from-1.21.5.md#waypoints) (1.21.6)
- [Server Player Changes](detailed-primers/1.21.6-from-1.21.5.md#server-player-changes) (1.21.6)
- [Permission Sources](detailed-primers/1.21.6-from-1.21.5.md#permission-sources) (1.21.6 minor)
- [Level#isClientSide now private](detailed-primers/1.21.9-from-1.21.8.md#levelisclientside-now-private) (1.21.9)
- [Ticket Flags](detailed-primers/1.21.9-from-1.21.8.md#ticket-flags) (1.21.9 minor)
- [Respawn Data](detailed-primers/1.21.9-from-1.21.8.md#respawn-data) (1.21.9 minor)
- [Permission Overhaul](detailed-primers/1.21.11-from-1.21.10.md#permission-overhaul) (1.21.11)
- [The Timeline of Environment Attributes](detailed-primers/1.21.11-from-1.21.10.md#the-timeline-of-environment-attributes) (1.21.11)
- [The Game Rule Shuffle](detailed-primers/1.21.11-from-1.21.10.md#the-game-rule-shuffle) (1.21.11)
- [Level#random field now protected](detailed-primers/26.1-from-1.21.11.md#levelrandom-field-now-protected) (26.1)
- [World Clocks and Time Markers](detailed-primers/26.1-from-1.21.11.md#world-clocks-and-time-markers) (26.1)
- [Splitting the Primary Level Data into Saved Data](detailed-primers/26.1-from-1.21.11.md#splitting-the-primary-level-data-into-saved-data) (26.1)
- [Chat Permissions](detailed-primers/26.1-from-1.21.11.md#chat-permissions) (26.1 minor)
- [ChunkPos, now a record](detailed-primers/26.1-from-1.21.11.md#chunkpos-now-a-record) (26.1 minor)
- [Cauldron Interaction Dispatchers](detailed-primers/26.1-from-1.21.11.md#cauldron-interaction-dispatchers) (26.1 minor)
- [Fluid Logic Reorganization](detailed-primers/26.1-from-1.21.11.md#fluid-logic-reorganization) (26.1 minor)
- [Removal of Random Patch Feature](detailed-primers/26.1-from-1.21.11.md#removal-of-random-patch-feature) (26.1 minor)
- [Rule-Based Block State Providers](detailed-primers/26.1-from-1.21.11.md#rule-based-block-state-providers) (26.1 minor)
- [File Fixer Upper](detailed-primers/26.1-from-1.21.11.md#file-fixer-upper) (26.1 minor)
+- [正确处理方块实体的移除](detailed-primers/1.21.5-from-1.21.4.md#正确处理方块实体的移除) (1.21.5)
+- [体素形状辅助类](detailed-primers/1.21.5-from-1.21.4.md#体素形状辅助类) (1.21.5)
+- [加权列表重做](detailed-primers/1.21.5-from-1.21.4.md#加权列表重做) (1.21.5)
+- [加载票](detailed-primers/1.21.5-from-1.21.4.md#加载票) (1.21.5)
+- [保存数据，现在带有类型](detailed-primers/1.21.5-from-1.21.4.md#保存数据现在带有类型) (1.21.5)
+- [方块效果应用器](detailed-primers/1.21.5-from-1.21.4.md#方块效果应用器) (1.21.5 次要)
+- [路径点](detailed-primers/1.21.6-from-1.21.5.md#路径点) (1.21.6)
+- [服务端玩家变更](detailed-primers/1.21.6-from-1.21.5.md#服务端玩家变更) (1.21.6)
+- [权限来源](detailed-primers/1.21.6-from-1.21.5.md#权限来源) (1.21.6 次要)
+- [Level#isClientSide 现在为 private](detailed-primers/1.21.9-from-1.21.8.md#levelisclientside-现在为-private) (1.21.9)
+- [加载票标志](detailed-primers/1.21.9-from-1.21.8.md#加载票标志) (1.21.9 次要)
+- [重生数据](detailed-primers/1.21.9-from-1.21.8.md#重生数据) (1.21.9 次要)
+- [权限大修](detailed-primers/1.21.11-from-1.21.10.md#权限大修) (1.21.11)
+- [环境属性的时间线](detailed-primers/1.21.11-from-1.21.10.md#环境属性的时间线) (1.21.11)
+- [游戏规则洗牌](detailed-primers/1.21.11-from-1.21.10.md#游戏规则洗牌) (1.21.11)
+- [Level#random 字段现在为 protected](detailed-primers/26.1-from-1.21.11.md#levelrandom-字段现在为-protected) (26.1)
+- [世界时钟与时间标记](detailed-primers/26.1-from-1.21.11.md#世界时钟与时间标记) (26.1)
+- [将主关卡数据拆分为保存数据](detailed-primers/26.1-from-1.21.11.md#将主关卡数据拆分为保存数据) (26.1)
+- [聊天权限](detailed-primers/26.1-from-1.21.11.md#聊天权限) (26.1 次要)
+- [ChunkPos，现在是一个记录](detailed-primers/26.1-from-1.21.11.md#chunkpos现在是一个记录) (26.1 次要)
+- [炼药锅交互调度器](detailed-primers/26.1-from-1.21.11.md#炼药锅交互调度器) (26.1 次要)
+- [流体逻辑重组](detailed-primers/26.1-from-1.21.11.md#流体逻辑重组) (26.1 次要)
+- [移除随机斑块特征](detailed-primers/26.1-from-1.21.11.md#移除随机斑块特征) (26.1 次要)
+- [基于规则的方块状态提供者](detailed-primers/26.1-from-1.21.11.md#基于规则的方块状态提供者) (26.1 次要)
+- [文件修缮工](detailed-primers/26.1-from-1.21.11.md#文件修复器) (26.1 次要)

-**Remaining minor migrations**
+**其余的小幅迁移**

- [Language File Removals and Renames](detailed-primers/1.21.2-from-1.21.1.md#language-file-removals-and-renames) (1.21.2)
+- [语言文件的移除与重命名](detailed-primers/1.21.2-from-1.21.1.md#语言文件的移除与重命名) (1.21.2)
 - [MacosUtil#IS_MACOS](detailed-primers/1.21.2-from-1.21.1.md#macosutilis_macos) (1.21.2)
- [Smarter Framerate Limiting](detailed-primers/1.21.2-from-1.21.1.md#smarter-framerate-limiting) (1.21.2)
- [Orientations](detailed-primers/1.21.2-from-1.21.1.md#orientations) (1.21.2)
- [The Removal of the Carving Generation Step](detailed-primers/1.21.2-from-1.21.1.md#the-removal-of-the-carving-generation-step) (1.21.2)
- [Consecutive Executors](detailed-primers/1.21.2-from-1.21.1.md#consecutive-executors) (1.21.2)
- [Profilers and the Tracy Client](detailed-primers/1.21.2-from-1.21.1.md#profilers-and-the-tracy-client) (1.21.2)
- [Tick Throttler](detailed-primers/1.21.2-from-1.21.1.md#tick-throttler) (1.21.2)
- [Music, now with Volume Controls](detailed-primers/1.21.4-from-1.21.2-3.md#music-now-with-volume-controls) (1.21.4)
- [Descoping Player Arguments](detailed-primers/1.21.5-from-1.21.4.md#descoping-player-arguments) (1.21.5)
- [Reload Instance Creation](detailed-primers/1.21.5-from-1.21.4.md#reload-instance-creation) (1.21.5)
- [The JOML Backing Interfaces](detailed-primers/1.21.5-from-1.21.4.md#the-joml-backing-interfaces) (1.21.5)
- [Mob Effects Field Renames](detailed-primers/1.21.5-from-1.21.4.md#mob-effects-field-renames) (1.21.5)
- [Reload Listener Shared State](detailed-primers/1.21.9-from-1.21.8.md#reload-listener-shared-state) (1.21.9)
- [The 'On Shelf' Transform](detailed-primers/1.21.9-from-1.21.8.md#the-on-shelf-transform) (1.21.9)
- [Shared Text Areas Debugger](detailed-primers/1.21.11-from-1.21.10.md#shared-text-areas-debugger) (1.21.11)
- [Specific Logic Changes](detailed-primers/1.21.11-from-1.21.10.md#specific-logic-changes) (1.21.11)
- [Typed Instance](detailed-primers/26.1-from-1.21.11.md#typed-instance) (26.1)
- [No More Tripwire Pipelines](detailed-primers/26.1-from-1.21.11.md#no-more-tripwire-pipelines) (26.1)
- [Environment Attribute Additions](detailed-primers/26.1-from-1.21.11.md#environment-attribute-additions) (26.1)
- [Specific Logic Changes](detailed-primers/26.1-from-1.21.11.md#specific-logic-changes) (26.1)
+- [更智能的帧率限制](detailed-primers/1.21.2-from-1.21.1.md#更智能的帧率限制) (1.21.2)
+- [朝向](detailed-primers/1.21.2-from-1.21.1.md#朝向) (1.21.2)
+- [移除雕刻生成步骤](detailed-primers/1.21.2-from-1.21.1.md#移除雕刻生成步骤) (1.21.2)
+- [连续执行器](detailed-primers/1.21.2-from-1.21.1.md#连续执行器) (1.21.2)
+- [分析器与 Tracy 客户端](detailed-primers/1.21.2-from-1.21.1.md#分析器与-tracy-客户端) (1.21.2)
+- [Tick节流器](detailed-primers/1.21.2-from-1.21.1.md#Tick节流器) (1.21.2)
+- [音乐，现在带有音量控制](detailed-primers/1.21.4-from-1.21.2-3.md#音乐现在带有音量控制) (1.21.4)
+- [解作用域玩家参数](detailed-primers/1.21.5-from-1.21.4.md#解作用域玩家参数) (1.21.5)
+- [重载实例创建](detailed-primers/1.21.5-from-1.21.4.md#重载实例创建) (1.21.5)
+- [JOML 后端接口](detailed-primers/1.21.5-from-1.21.4.md#joml-后端接口) (1.21.5)
+- [状态效果字段重命名](detailed-primers/1.21.5-from-1.21.4.md#状态效果字段重命名) (1.21.5)
+- [重载监听器共享状态](detailed-primers/1.21.9-from-1.21.8.md#重载监听器共享状态) (1.21.9)
+- ["在架子上" 变换](detailed-primers/1.21.9-from-1.21.8.md#在架子上变换) (1.21.9)
+- [共享文本区域调试器](detailed-primers/1.21.11-from-1.21.10.md#共享文本区域调试器) (1.21.11)
+- [特定逻辑变更](detailed-primers/1.21.11-from-1.21.10.md#特定逻辑变更) (1.21.11)
+- [类型化实例](detailed-primers/26.1-from-1.21.11.md#类型化实例) (26.1)
+- [不再有绊线管线](detailed-primers/26.1-from-1.21.11.md#不再有绊线管线) (26.1)
+- [环境属性新增](detailed-primers/26.1-from-1.21.11.md#环境属性新增) (26.1)
+- [特定逻辑变更](detailed-primers/26.1-from-1.21.11.md#特定逻辑变更) (26.1)

-Every primer also contains `New Tags`, `Tag Changes`, `List of Additions`, `List of Changes`, and `List of Removals` subsections within their Minor Migrations. For those, go to the full primer pages in [Detailed Primers](detailed-primers/README.md).
+每份入门文档的“小幅迁移”章节中还包含“新标签”、“标签变更”、“新增列表”、“变更列表”和“移除列表”子章节。如需查看这些内容，请前往[详细入门文档](detailed-primers/README.md)中的完整入门文档页面。

 ---

-## Class and Method Index
+## 类和方法索引

-If you have a compile error or need to find where a specific class/method changed, search this table.
+如果您遇到编译错误或需要查找特定类/方法在哪里发生了变化，请在此表中搜索。

-| Class / Method | Version | Section |
-|---|---|---|
-| `AbstractFurnaceBlockEntity` fuel | 1.21.2 | [Fuel Values](detailed-primers/1.21.2-from-1.21.1.md#fuel-values) |
-| `AbstractMinecart` | 1.21.2 | [Minecart Behavior](detailed-primers/1.21.2-from-1.21.1.md#minecart-behavior) |
-| `Activities` / `Brain` | 26.1 | [Activities and Brains](detailed-primers/26.1-from-1.21.11.md#activities-and-brains) |
-| `AnimationDefinition#bake` | 1.21.6 | [Animation Baking](detailed-primers/1.21.6-from-1.21.5.md#animation-baking) |
-| `ArmorItem` / `ArmorMaterial` | 1.21.2 | [Armor Materials, Equipment, and Model (Textures)](detailed-primers/1.21.2-from-1.21.1.md#armor-materials-equipment-and-model-textures) |
-| `BakedModel` / `BakedQuad` | 1.21.5 | [Model Rework](detailed-primers/1.21.5-from-1.21.4.md#model-rework) |
-| `BlockBehaviour#neighborChanged` | 1.21.2 | [Orientations](detailed-primers/1.21.2-from-1.21.1.md#orientations) |
-| `BlockEntityType` constructors | 1.21.2 | [BlockEntityTypes Privatized!](detailed-primers/1.21.2-from-1.21.1.md#blockentitytypes-privatized) |
-| `CauldronInteraction` | 26.1 | [Cauldron Interaction Dispatchers](detailed-primers/26.1-from-1.21.11.md#cauldron-interaction-dispatchers) |
-| `ChunkPos` (now record) | 26.1 | [ChunkPos, now a record](detailed-primers/26.1-from-1.21.11.md#chunkpos-now-a-record) |
-| `ChunkSectionLayer` | 1.21.6 | [ChunkSectionLayers](detailed-primers/1.21.6-from-1.21.5.md#chunksectionlayers) |
-| Client item JSONs | 1.21.4 | [Client Items](detailed-primers/1.21.4-from-1.21.2-3.md#client-items) |
-| `Consumable` / `ConsumableListener` | 1.21.2 | [Consumables](detailed-primers/1.21.2-from-1.21.1.md#consumables) |
-| `DataComponents` getters | 1.21.5 | [Data Component Getters](detailed-primers/1.21.5-from-1.21.4.md#data-component-getters) |
-| `DataComponents` new types | 1.21.11 | [New Data Components](detailed-primers/1.21.11-from-1.21.10.md#new-data-components) |
-| `DataComponents` initializers | 26.1 | [Data Component Initializers](detailed-primers/26.1-from-1.21.11.md#data-component-initializers) |
-| `DiggerItem` / `SwordItem` removal | 1.21.5 | [Weapons, Tools, and Armor: Removing the Redundancies](detailed-primers/1.21.5-from-1.21.4.md#weapons-tools-and-armor-removing-the-redundancies) |
-| `DyeRecipe` / `DyeItem` | 26.1 | [Dye Component](detailed-primers/26.1-from-1.21.11.md#dye-component) |
-| `Entity#interactAt` removal | 26.1 | [The Removal of interactAt](detailed-primers/26.1-from-1.21.11.md#the-removal-of-interactat) |
-| `EntityReference` (replaces UUID) | 1.21.5 | [Entity References](detailed-primers/1.21.5-from-1.21.4.md#entity-references) |
-| `EntityRenderState` | 1.21.2 | [Entity Render States](detailed-primers/1.21.2-from-1.21.1.md#entity-render-states) |
-| `Explosion` (now interface) | 1.21.2 | [EXPLOOOOSSSION!](detailed-primers/1.21.2-from-1.21.1.md#exploooosssion) |
-| `GameRules` | 1.21.11 | [The Game Rule Shuffle](detailed-primers/1.21.11-from-1.21.10.md#the-game-rule-shuffle) |
-| `GameTest` framework | 1.21.5 | [The Game Test Overhaul](detailed-primers/1.21.5-from-1.21.4.md#the-game-test-overhaul) |
-| `GenerationStep$Carving` removal | 1.21.2 | [The Removal of the Carving Generation Step](detailed-primers/1.21.2-from-1.21.1.md#the-removal-of-the-carving-generation-step) |
-| `GpuTexture` / `RenderPipeline` | 1.21.5 | [Render Pipeline Rework](detailed-primers/1.21.5-from-1.21.4.md#render-pipeline-rework) |
-| `GuiGraphics` / GUI rendering | 1.21.6 | [GUI Changes](detailed-primers/1.21.6-from-1.21.5.md#gui-changes) |
-| `Holder` / `HolderSet` / `HolderGetter` | 1.21.2 | [The Holder Set Transition](detailed-primers/1.21.2-from-1.21.1.md#the-holder-set-transition) |
-| `Identifier` (was `ResourceLocation`) | 1.21.11 | [ResourceLocation to Identifier](detailed-primers/1.21.11-from-1.21.10.md#resourcelocation-to-identifier) |
-| `Ingredient` | 1.21.2 | [The Ingredient Shift](detailed-primers/1.21.2-from-1.21.1.md#the-ingredient-shift) |
-| `InteractionResult` | 1.21.2 | [Interaction Results](detailed-primers/1.21.2-from-1.21.1.md#interaction-results) |
-| `ItemInstance` / `StackTemplate` | 26.1 | [Item Instances and Stack Templates](detailed-primers/26.1-from-1.21.11.md#item-instances-and-stack-templates) |
-| `KeyMapping` / input events | 1.21.9 | [Input Handling Consolidation](detailed-primers/1.21.9-from-1.21.8.md#input-handling-consolidation) |
-| `Leashable` | 1.21.6 | [Leashes](detailed-primers/1.21.6-from-1.21.5.md#leashes) |
-| `Level#isClientSide` | 1.21.9 | [Level#isClientSide now private](detailed-primers/1.21.9-from-1.21.8.md#levelisclientside-now-private) |
-| `Level#random` | 26.1 | [Level#random field now protected](detailed-primers/26.1-from-1.21.11.md#levelrandom-field-now-protected) |
-| `LootContextParam` / `LootContextParamSet` | 1.21.2 | [Context Keys](detailed-primers/1.21.2-from-1.21.1.md#context-keys) |
-| `LootPoolEntry` / loot codecs | 26.1 | [Loot Type Unrolling](detailed-primers/26.1-from-1.21.11.md#loot-type-unrolling) |
-| `Mob#convertTo` | 1.21.2 | [Mob Conversions](detailed-primers/1.21.2-from-1.21.1.md#mob-conversions) |
-| `OptionEnum` removal | 1.21.11 | [OptionEnum Removal](detailed-primers/1.21.11-from-1.21.10.md#optionenum-removal) |
-| `Permission` / `PermissionSet` | 1.21.11 | [Permission Overhaul](detailed-primers/1.21.11-from-1.21.10.md#permission-overhaul) |
-| `Profiler#get` (replaces `getProfiler`) | 1.21.2 | [Profilers and the Tracy Client](detailed-primers/1.21.2-from-1.21.1.md#profilers-and-the-tracy-client) |
-| `Recipe` registry format | 1.21.2 | [Recipes, now in Registry format](detailed-primers/1.21.2-from-1.21.1.md#recipes-now-in-registry-format) |
-| `RecipeDisplay` / `SlotDisplay` | 1.21.2 | [Recipes, now in Registry format](detailed-primers/1.21.2-from-1.21.1.md#recipes-now-in-registry-format) |
-| `RenderType` shuffle | 1.21.11 | [Oh Hey, Another Rendering Rewrite](detailed-primers/1.21.11-from-1.21.10.md#oh-hey-another-rendering-rewrite) |
-| `SavedData` / `SavedDataType` | 1.21.5 | [Saved Data, now with Types](detailed-primers/1.21.5-from-1.21.4.md#saved-data-now-with-types) |
-| `ServerExplosion` | 1.21.2 | [EXPLOOOOSSSION!](detailed-primers/1.21.2-from-1.21.1.md#exploooosssion) |
-| Shader JSON / `.vsh` / `.fsh` | 1.21.2 | [Shader Rewrites](detailed-primers/1.21.2-from-1.21.1.md#shader-rewrites) |
-| `SimpleJsonResourceReloadListener` | 1.21.4 | [SimpleJsonResourceReloadListener](detailed-primers/1.21.4-from-1.21.2-3.md#simplejsonresourcereloadlistener) |
-| `TagProvider` appender | 1.21.6 | [Tag Providers: Appender Rewrite](detailed-primers/1.21.6-from-1.21.5.md#tag-providers-appender-rewrite) |
-| `Validatable` / `ValidationContext` | 26.1 | [Validation Overhaul](detailed-primers/26.1-from-1.21.11.md#validation-overhaul) |
-| Villager trades (datapack) | 26.1 | [Datapack Villager Trades](detailed-primers/26.1-from-1.21.11.md#datapack-villager-trades) |
-| `VoxelShape` helpers | 1.21.5 | [Voxel Shape Helpers](detailed-primers/1.21.5-from-1.21.4.md#voxel-shape-helpers) |
-| `Waypoint` system | 1.21.6 | [Waypoints](detailed-primers/1.21.6-from-1.21.5.md#waypoints) |
-| World clocks / time markers | 26.1 | [World Clocks and Time Markers](detailed-primers/26.1-from-1.21.11.md#world-clocks-and-time-markers) |
-| World data split | 26.1 | [Splitting the Primary Level Data into Saved Data](detailed-primers/26.1-from-1.21.11.md#splitting-the-primary-level-data-into-saved-data) |
+| 类 / 方法                                  | 版本    | 章节                                                                                                          |
+| ------------------------------------------ | ------- | ------------------------------------------------------------------------------------------------------------- |
+| `AbstractFurnaceBlockEntity` 燃料          | 1.21.2  | [燃料值](detailed-primers/1.21.2-from-1.21.1.md#燃料值)                                                       |
+| `AbstractMinecart`                         | 1.21.2  | [矿车行为](detailed-primers/1.21.2-from-1.21.1.md#矿车行为)                                                   |
+| `Activities` / `Brain`                     | 26.1    | [活动与大脑](detailed-primers/26.1-from-1.21.11.md#活动与大脑)                                                |
+| `AnimationDefinition#bake`                 | 1.21.6  | [动画烘焙](detailed-primers/1.21.6-from-1.21.5.md#动画烘焙)                                                   |
+| `ArmorItem` / `ArmorMaterial`              | 1.21.2  | [盔甲材料、装备和模型（纹理）](detailed-primers/1.21.2-from-1.21.1.md#盔甲材料装备和模型纹理)                |
+| `BakedModel` / `BakedQuad`                 | 1.21.5  | [模型重做](detailed-primers/1.21.5-from-1.21.4.md#模型重做)                                                   |
+| `BlockBehaviour#neighborChanged`           | 1.21.2  | [朝向](detailed-primers/1.21.2-from-1.21.1.md#朝向)                                                           |
+| `BlockEntityType` 构造器                   | 1.21.2  | [BlockEntityTypes 私有化了！](detailed-primers/1.21.2-from-1.21.1.md#blockentitytypes-私有化了)                   |
+| `CauldronInteraction`                      | 26.1    | [炼药锅交互调度器](detailed-primers/26.1-from-1.21.11.md#炼药锅交互调度器)                                    |
+| `ChunkPos` (现为记录)                      | 26.1    | [ChunkPos，现在是一个记录](detailed-primers/26.1-from-1.21.11.md#chunkpos现在是一个记录)                     |
+| `ChunkSectionLayer`                        | 1.21.6  | [ChunkSectionLayers](detailed-primers/1.21.6-from-1.21.5.md#chunksectionlayers)                               |
+| 客户端物品 JSON                            | 1.21.4  | [客户端物品](detailed-primers/1.21.4-from-1.21.2-3.md#客户端物品)                                            |
+| `Consumable` / `ConsumableListener`        | 1.21.2  | [消耗品](detailed-primers/1.21.2-from-1.21.1.md#消耗品)                                                       |
+| `DataComponents` 获取器                    | 1.21.5  | [数据组件获取器](detailed-primers/1.21.5-from-1.21.4.md#数据组件获取器)                                      |
+| `DataComponents` 新类型                    | 1.21.11 | [新数据组件](detailed-primers/1.21.11-from-1.21.10.md#新数据组件)                                             |
+| `DataComponents` 初始化器                  | 26.1    | [数据组件初始化器](detailed-primers/26.1-from-1.21.11.md#数据组件初始化器)                                   |
+| `DiggerItem` / `SwordItem` 移除            | 1.21.5  | [武器、工具和盔甲：去除冗余](detailed-primers/1.21.5-from-1.21.4.md#武器工具和盔甲去除冗余)                  |
+| `DyeRecipe` / `DyeItem`                    | 26.1    | [染料组件](detailed-primers/26.1-from-1.21.11.md#染料组件)                                                    |
+| `Entity#interactAt` 移除                   | 26.1    | [interactAt 的移除](detailed-primers/26.1-from-1.21.11.md#interactat-的移除)                                  |
+| `EntityReference` (取代 UUID)              | 1.21.5  | [实体引用](detailed-primers/1.21.5-from-1.21.4.md#实体引用)                                                   |
+| `EntityRenderState`                        | 1.21.2  | [实体渲染状态](detailed-primers/1.21.2-from-1.21.1.md#实体渲染状态)                                           |
+| `Explosion` (现为接口)                     | 1.21.2  | [爆——炸——！](detailed-primers/1.21.2-from-1.21.1.md#爆炸)                                                     |
+| `GameRules`                                | 1.21.11 | [游戏规则洗牌](detailed-primers/1.21.11-from-1.21.10.md#游戏规则洗牌)                                         |
+| `GameTest` 框架                            | 1.21.5  | [游戏测试大修](detailed-primers/1.21.5-from-1.21.4.md#游戏测试大修)                                          |
+| `GenerationStep$Carving` 移除              | 1.21.2  | [移除雕刻生成步骤](detailed-primers/1.21.2-from-1.21.1.md#移除雕刻生成步骤)                                   |
+| `GpuTexture` / `RenderPipeline`            | 1.21.5  | [渲染管线重做](detailed-primers/1.21.5-from-1.21.4.md#渲染管线重做)                                           |
+| `GuiGraphics` / GUI 渲染                   | 1.21.6  | [GUI 变更](detailed-primers/1.21.6-from-1.21.5.md#gui-变更)                                                   |
+| `Holder` / `HolderSet` / `HolderGetter`    | 1.21.2  | [持有者集过渡](detailed-primers/1.21.2-from-1.21.1.md#持有者集-过渡)                                          |
+| `Identifier` (原 `ResourceLocation`)       | 1.21.11 | [ResourceLocation 到 Identifier](detailed-primers/1.21.11-from-1.21.10.md#resourcelocation-到-identifier)     |
+| `Ingredient`                               | 1.21.2  | [原料的转变](detailed-primers/1.21.2-from-1.21.1.md#原料的转变)                                               |
+| `InteractionResult`                        | 1.21.2  | [交互结果](detailed-primers/1.21.2-from-1.21.1.md#交互结果)                                                   |
+| `ItemInstance` / `StackTemplate`           | 26.1    | [物品实例与堆栈模板](detailed-primers/26.1-from-1.21.11.md#物品实例与堆栈模板)                                |
+| `KeyMapping` / 输入事件                    | 1.21.9  | [输入处理整合](detailed-primers/1.21.9-from-1.21.8.md#输入处理整合)                                           |
+| `Leashable`                                | 1.21.6  | [拴绳](detailed-primers/1.21.6-from-1.21.5.md#拴绳)                                                           |
+| `Level#isClientSide`                       | 1.21.9  | [Level#isClientSide 现在为 private](detailed-primers/1.21.9-from-1.21.8.md#levelisclientside-现在为-private)  |
+| `Level#random`                             | 26.1    | [Level#random 字段现在为 protected](detailed-primers/26.1-from-1.21.11.md#levelrandom-字段现在为-protected)   |
+| `LootContextParam` / `LootContextParamSet` | 1.21.2  | [上下文键](detailed-primers/1.21.2-from-1.21.1.md#上下文键)                                                   |
+| `LootPoolEntry` / 战利品编解码器           | 26.1    | [战利品类型展开](detailed-primers/26.1-from-1.21.11.md#战利品类型展开)                                       |
+| `Mob#convertTo`                            | 1.21.2  | [生物转化](detailed-primers/1.21.2-from-1.21.1.md#生物转化)                                                   |
+| `OptionEnum` 移除                          | 1.21.11 | [OptionEnum 移除](detailed-primers/1.21.11-from-1.21.10.md#optionenum-移除)                                   |
+| `Permission` / `PermissionSet`             | 1.21.11 | [权限大修](detailed-primers/1.21.11-from-1.21.10.md#权限大修)                                                |
+| `Profiler#get` (取代 `getProfiler`)        | 1.21.2  | [分析器与 Tracy 客户端](detailed-primers/1.21.2-from-1.21.1.md#分析器与-tracy-客户端)                         |
+| `Recipe` 注册表格式                        | 1.21.2  | [配方，现在采用注册表格式](detailed-primers/1.21.2-from-1.21.1.md#配方现在采用注册表格式)                    |
+| `RecipeDisplay` / `SlotDisplay`            | 1.21.2  | [配方，现在采用注册表格式](detailed-primers/1.21.2-from-1.21.1.md#配方现在采用注册表格式)                    |
+| `RenderType` 洗牌                          | 1.21.11 | [哦，又来了，一次渲染重写](detailed-primers/1.21.11-from-1.21.10.md#哦又来了一次渲染重写)                    |
+| `SavedData` / `SavedDataType`              | 1.21.5  | [保存数据，现在带有类型](detailed-primers/1.21.5-from-1.21.4.md#保存数据现在带有类型)                        |
+| `ServerExplosion`                          | 1.21.2  | [爆——炸——！](detailed-primers/1.21.2-from-1.21.1.md#爆炸)                                                     |
+| 着色器 JSON / `.vsh` / `.fsh`              | 1.21.2  | [着色器重写](detailed-primers/1.21.2-from-1.21.1.md#着色器重写)                                               |
+| `SimpleJsonResourceReloadListener`         | 1.21.4  | [SimpleJsonResourceReloadListener](detailed-primers/1.21.4-from-1.21.2-3.md#simplejsonresourcereloadlistener) |
+| `TagProvider` 追加器                       | 1.21.6  | [标签提供者：追加器重写](detailed-primers/1.21.6-from-1.21.5.md#标签提供者-追加器重写)                        |
+| `Validatable` / `ValidationContext`        | 26.1    | [验证大修](detailed-primers/26.1-from-1.21.11.md#验证大修)                                                   |
+| 村民交易（数据包）                         | 26.1    | [数据包村民交易](detailed-primers/26.1-from-1.21.11.md#数据包村民交易)                                        |
+| `VoxelShape` 辅助类                        | 1.21.5  | [体素形状辅助类](detailed-primers/1.21.5-from-1.21.4.md#体素形状辅助类)                                       |
+| `Waypoint` 系统                            | 1.21.6  | [路径点](detailed-primers/1.21.6-from-1.21.5.md#路径点)                                                       |
+| 世界时钟 / 时间标记                        | 26.1    | [世界时钟与时间标记](detailed-primers/26.1-from-1.21.11.md#世界时钟与时间标记)                                |
+| 世界数据拆分                               | 26.1    | [将主关卡数据拆分为保存数据](detailed-primers/26.1-from-1.21.11.md#将主关卡数据拆分为保存数据)                |

 ---

-## Source and attribution
+## 来源与署名

-The split primer pages are copied from `ChampionAsh5357/neoforged-github`, branch `update/26.1`. See [Source And Attribution](source-and-attribution.md).
+拆分后的入门文档页面复制自 `ChampionAsh5357/neoforged-github`，分支 `update/26.1`。详见[来源与署名](source-and-attribution.md)。
--- a/src/SUMMARY.md
+++ b/src/SUMMARY.md
@ -1,8 +1,8 @@
-# Summary
+# 摘要

- [1.21.1 to 26.1 NeoForge Porting Guide](README.md)
- [Repeatedly Changing Systems](repeatedly-changing-systems.md)
- [Detailed Primers](detailed-primers/README.md)
+- [1.21.1至26.1 NeoForge迁移指南](README.md)
+- [频繁变更的系统](repeatedly-changing-systems.md)
+- [详细指引](detailed-primers/README.md)
    - [1.21.1 -> 1.21.2/3](detailed-primers/1.21.2-from-1.21.1.md)
    - [1.21.2/3 -> 1.21.4](detailed-primers/1.21.4-from-1.21.2-3.md)
    - [1.21.4 -> 1.21.5](detailed-primers/1.21.5-from-1.21.4.md)
@ -13,4 +13,4 @@
    - [1.21.9 -> 1.21.10](detailed-primers/1.21.10-from-1.21.9.md)
    - [1.21.10 -> 1.21.11](detailed-primers/1.21.11-from-1.21.10.md)
    - [1.21.11 -> 26.1](detailed-primers/26.1-from-1.21.11.md)
- [Source And Attribution](source-and-attribution.md)
+- [来源与署名](source-and-attribution.md)
--- a/src/detailed-primers/1.21.10-from-1.21.9.md
+++ b/src/detailed-primers/1.21.10-from-1.21.9.md
@ -1,27 +1,27 @@
-# Minecraft 1.21.9 -> 1.21.10 Mod Migration Primer
+# Minecraft 1.21.9 -> 1.21.10 模组迁移入门文档

-This is a high level, non-exhaustive overview on how to migrate your mod from 1.21.9 to 1.21.10. This does not look at any specific mod loader, just the changes to the vanilla classes. All provided names use the official mojang mappings.
+本文档是一个高层次、非详尽的概述，介绍如何将您的模组从 1.21.9 迁移到 1.21.10。本文不涉及任何特定的模组加载器，只关注原版类的变更。所有提供的名称均使用官方的 Mojang 映射。

-This primer is licensed under the [Creative Commons Attribution 4.0 International](http://creativecommons.org/licenses/by/4.0/), so feel free to use it as a reference and leave a link so that other readers can consume the primer.
+本入门文档采用 [知识共享署名 4.0 国际许可协议](http://creativecommons.org/licenses/by/4.0/) 授权，因此您可以自由地将其用作参考，并请留下链接以便其他读者查阅。

-If there's any incorrect or missing information, please file an issue on this repository or ping @ChampionAsh5357 in the Neoforged Discord server.
+如果存在任何不正确或缺失的信息，请在本仓库提交 issue，或在 Neoforged Discord 服务器中 @ChampionAsh5357。

-Thank you to:
+感谢：

- @melanx for a typo
+- @melanx 指出了一个拼写错误

-## Pack Changes
+## 资源包变更

-There are a number of user-facing changes that are part of vanilla which are not discussed below that may be relevant to modders. You can find a list of them on [Misode's version changelog](https://misode.github.io/versions/?id=1.21.10&tab=changelog).
+原版中有许多面向用户的变更为未在下面讨论，但这些变更可能与模组制作者相关。您可以在 [Misode 的版本更新日志](https://misode.github.io/versions/?id=1.21.10&tab=changelog) 中找到它们的列表。

-## Minor Migrations
+## 小幅迁移

-The following is a list of useful or interesting additions, changes, and removals that do not deserve their own section in the primer.
+以下是有用或有趣的增加、变更和移除的列表，它们不值得在入门文档中拥有自己的章节。

-### List of Additions
+### 新增列表

- `net.minecraft.world.entity.decoration.HangingEntity#getPopBox` - Returns the bounding box indicating where the entity will pop off if colliding.
+- `net.minecraft.world.entity.decoration.HangingEntity#getPopBox` - 返回一个边界框，指示如果发生碰撞，实体将从何处弹出。

-### List of Changes
+### 变更列表

-`net.minecraft.world.level.block.state.BlockBehaviour#entityInside` now takes in a `boolean` indicating whether the entity is intersecting or inside the block
+- `net.minecraft.world.level.block.state.BlockBehaviour#entityInside` 现在接受一个 `boolean` 参数，指示实体是与方块相交还是在方块内部。
--- a/src/detailed-primers/1.21.11-from-1.21.10.md
+++ b/src/detailed-primers/1.21.11-from-1.21.10.md
--- a/src/detailed-primers/1.21.2-from-1.21.1.md
+++ b/src/detailed-primers/1.21.2-from-1.21.1.md
--- a/src/detailed-primers/1.21.4-from-1.21.2-3.md
+++ b/src/detailed-primers/1.21.4-from-1.21.2-3.md
--- a/src/detailed-primers/1.21.5-from-1.21.4.md
+++ b/src/detailed-primers/1.21.5-from-1.21.4.md
--- a/src/detailed-primers/1.21.6-from-1.21.5.md
+++ b/src/detailed-primers/1.21.6-from-1.21.5.md
--- a/src/detailed-primers/1.21.7-from-1.21.6.md
+++ b/src/detailed-primers/1.21.7-from-1.21.6.md
@ -1,38 +1,38 @@
-# Minecraft 1.21.6 -> 1.21.7 Mod Migration Primer
+# Minecraft 1.21.6 -> 1.21.7 模组迁移入门文档

-This is a high level, non-exhaustive overview on how to migrate your mod from 1.21.6 to 1.21.7. This does not look at any specific mod loader, just the changes to the vanilla classes. All provided names use the official mojang mappings.
+本文档是一个高层次、非详尽的概述，介绍如何将您的模组从 1.21.6 迁移到 1.21.7。本文不涉及任何特定的模组加载器，只关注原版类的变更。所有提供的名称均使用官方的 Mojang 映射。

-This primer is licensed under the [Creative Commons Attribution 4.0 International](http://creativecommons.org/licenses/by/4.0/), so feel free to use it as a reference and leave a link so that other readers can consume the primer.
+本入门文档采用 [知识共享署名 4.0 国际许可协议](http://creativecommons.org/licenses/by/4.0/) 授权，因此您可以自由地将其用作参考，并请留下链接以便其他读者查阅。

-If there's any incorrect or missing information, please file an issue on this repository or ping @ChampionAsh5357 in the Neoforged Discord server.
+如果存在任何不正确或缺失的信息，请在本仓库提交 issue，或在 Neoforged Discord 服务器中 @ChampionAsh5357。

-## Pack Changes
+## 资源包变更

-There are a number of user-facing changes that are part of vanilla which are not discussed below that may be relevant to modders. You can find a list of them on [Misode's version changelog](https://misode.github.io/versions/?id=1.21.7&tab=changelog).
+原版中有许多面向用户的变更为未在下面讨论，但这些变更可能与模组制作者相关。您可以在 [Misode 的版本更新日志](https://misode.github.io/versions/?id=1.21.7&tab=changelog) 中找到它们的列表。

-## Minor Migrations
+## 小幅迁移

-The following is a list of useful or interesting additions, changes, and removals that do not deserve their own section in the primer.
+以下是有用或有趣的增加、变更和移除的列表，它们不值得在入门文档中拥有自己的章节。

-### List of Additions
+### 新增列表

- `com.mojang.blaze3d.opengl.DirectStateAccess#copyBufferSubData` - Copies all or part of one buffer object's data store to the data store of another buffer object.
- `com.mojang.blaze3d.pipeline.BlendFunction#INVERT` - Inverts the blend factors of the RGB source and destination. Alpha uses the default one from source and zero from destination.
- `com.mojang.blaze3d.systems.CommandEncoder#copyToBuffer` - Copies the data store of one buffer slice to another buffer slice.
- `net.minecraft.Util#isAarch64` - Returns whether the OS architecture uses aarch64.
- `net.minecraft.client.gui.GuiGraphics#textHighlight` - Adds a highlighted box around the provided bounds.
- `net.minecraft.client.renderer.RenderPipelines#GUI_INVERT` - A render pipeline for drawing a gui element with inverted colors.
- `net.minecraft.client.renderer.item.TrackingItemRenderState` - A render state that tracks the model sources being used to render the item stack.
+- `com.mojang.blaze3d.opengl.DirectStateAccess#copyBufferSubData` - 将一个缓冲区对象的数据存储的全部或部分复制到另一个缓冲区对象的数据存储。
+- `com.mojang.blaze3d.pipeline.BlendFunction#INVERT` - 反转 RGB 源和目标的混合因子。Alpha 使用源的默认因子，目标使用零。
+- `com.mojang.blaze3d.systems.CommandEncoder#copyToBuffer` - 将一个缓冲区切片的数据存储复制到另一个缓冲区切片。
+- `net.minecraft.Util#isAarch64` - 返回操作系统架构是否使用 aarch64。
+- `net.minecraft.client.gui.GuiGraphics#textHighlight` - 在提供的边界周围添加一个高亮框。
+- `net.minecraft.client.renderer.RenderPipelines#GUI_INVERT` - 用于绘制具有反色效果的 GUI 元素的渲染管线。
+- `net.minecraft.client.renderer.item.TrackingItemRenderState` - 一个跟踪用于渲染物品堆栈的模型源的渲染状态。

-### List of Changes
+### 变更列表

- `com.mojang.blaze3d.pipeline.RenderPipeline$Builder#withColorLogic` is now deprecated
- `net.minecraft.client.gui.renderer.GuiRenderer#MIN_GUI_Z` is now private
- `net.minecraft.client.gui.render.state.GuiItemRenderState` now takes in a `TrackingItemRenderState` instead of a `ItemStackRenderState`
-    - `itemStackRenderState` now returns a `TrackingItemRenderState`
- `net.minecraft.client.renderer.RenderPipelines#GUI_TEXT_HIGHLIGHT` now uses the `ADDITIVE` blend function instead of the `OR_REVERSE` color logic
+- `com.mojang.blaze3d.pipeline.RenderPipeline$Builder#withColorLogic` 现已弃用
+- `net.minecraft.client.gui.renderer.GuiRenderer#MIN_GUI_Z` 现在是私有的
+- `net.minecraft.client.gui.render.state.GuiItemRenderState` 现在接受 `TrackingItemRenderState` 而不是 `ItemStackRenderState`
+    - `itemStackRenderState` 现在返回 `TrackingItemRenderState`
+- `net.minecraft.client.renderer.RenderPipelines#GUI_TEXT_HIGHLIGHT` 现在使用 `ADDITIVE` 混合函数而不是 `OR_REVERSE` 颜色逻辑
 - `net.minecraft.client.renderer.item.ItemStackRenderState#getModelIdentity` -> `TrackingItemRenderState#getModelIdentity`

-### List of Removals
+### 移除列表

 - `net.minecraft.client.renderer.item.ItemStackRenderState#clearModelIdentity`
--- a/src/detailed-primers/1.21.8-from-1.21.7.md
+++ b/src/detailed-primers/1.21.8-from-1.21.7.md
@ -1,19 +1,19 @@
-# Minecraft 1.21.7 -> 1.21.8 Mod Migration Primer
+# Minecraft 1.21.7 -> 1.21.8 模组迁移入门文档

-This is a high level, non-exhaustive overview on how to migrate your mod from 1.21.7 to 1.21.8. This does not look at any specific mod loader, just the changes to the vanilla classes. All provided names use the official mojang mappings.
+本文档是一个高层次、非详尽的概述，介绍如何将您的模组从 1.21.7 迁移到 1.21.8。本文不涉及任何特定的模组加载器，只关注原版类的变更。所有提供的名称均使用官方的 Mojang 映射。

-This primer is licensed under the [Creative Commons Attribution 4.0 International](http://creativecommons.org/licenses/by/4.0/), so feel free to use it as a reference and leave a link so that other readers can consume the primer.
+本入门文档采用 [知识共享署名 4.0 国际许可协议](http://creativecommons.org/licenses/by/4.0/) 授权，因此您可以自由地将其用作参考，并请留下链接以便其他读者查阅。

-If there's any incorrect or missing information, please file an issue on this repository or ping @ChampionAsh5357 in the Neoforged Discord server.
+如果存在任何不正确或缺失的信息，请在本仓库提交 issue，或在 Neoforged Discord 服务器中 @ChampionAsh5357。

-## Pack Changes
+## 资源包变更

-There are a number of user-facing changes that are part of vanilla which are not discussed below that may be relevant to modders. You can find a list of them on [Misode's version changelog](https://misode.github.io/versions/?id=1.21.8&tab=changelog).
+原版中有许多面向用户的变更为未在下面讨论，但这些变更可能与模组制作者相关。您可以在 [Misode 的版本更新日志](https://misode.github.io/versions/?id=1.21.8&tab=changelog) 中找到它们的列表。

-## Minor Migrations
+## 小幅迁移

-The following is a list of useful or interesting additions, changes, and removals that do not deserve their own section in the primer.
+以下是有用或有趣的增加、变更和移除的列表，它们不值得在入门文档中拥有自己的章节。

-### List of Additions
+### 新增列表

- `com.mojang.blaze3d.GraphicsWorkarounds` - A helper for working around issues with specific graphics hardware.
+- `com.mojang.blaze3d.GraphicsWorkarounds` - 一个用于解决特定图形硬件问题的辅助工具。
--- a/src/detailed-primers/1.21.9-from-1.21.8.md
+++ b/src/detailed-primers/1.21.9-from-1.21.8.md
--- a/src/detailed-primers/26.1-from-1.21.11.md
+++ b/src/detailed-primers/26.1-from-1.21.11.md
--- a/src/detailed-primers/README.md
+++ b/src/detailed-primers/README.md
@ -1,135 +1,135 @@
-# Detailed Primers
+# 详细入门文档

-These chapters preserve the upstream primer content step by step. Each section heading links directly to that section within the primer page.
+这些章节按步骤保留了上游入门文档的内容。每个章节标题都直接链接到入门文档页面内的相应章节。

 ## 1.21.1 -> 1.21.2/3

-[Full primer](1.21.2-from-1.21.1.md)
+[完整入门文档](1.21.2-from-1.21.1.md)

- [Pack Changes](1.21.2-from-1.21.1.md#pack-changes)
- [The Holder Set Transition](1.21.2-from-1.21.1.md#the-holder-set-transition)
- [Gui Render Types](1.21.2-from-1.21.1.md#gui-render-types)
- [Shader Rewrites](1.21.2-from-1.21.1.md#shader-rewrites)
- [Entity Render States](1.21.2-from-1.21.1.md#entity-render-states)
- [Equipments and Items, Models and All](1.21.2-from-1.21.1.md#equipments-and-items-models-and-all)
- [Armor Materials, Equipment, and Model (Textures)](1.21.2-from-1.21.1.md#armor-materials-equipment-and-model-textures)
- [Interaction Results](1.21.2-from-1.21.1.md#interaction-results)
- [Instruments, the Datapack Edition](1.21.2-from-1.21.1.md#instruments-the-datapack-edition)
- [Trial Spawner Configurations, now in Datapack Form](1.21.2-from-1.21.1.md#trial-spawner-configurations-now-in-datapack-form)
- [Recipe Providers, the 'not actually' of Data Providers](1.21.2-from-1.21.1.md#recipe-providers-the-not-actually-of-data-providers)
- [The Ingredient Shift](1.21.2-from-1.21.1.md#the-ingredient-shift)
- [BlockEntityTypes Privatized!](1.21.2-from-1.21.1.md#blockentitytypes-privatized)
- [Consumables](1.21.2-from-1.21.1.md#consumables)
- [Registry Objcet Id, in the Properties?](1.21.2-from-1.21.1.md#registry-objcet-id-in-the-properties)
- [Properties Changes](1.21.2-from-1.21.1.md#properties-changes)
- [Recipes, now in Registry format](1.21.2-from-1.21.1.md#recipes-now-in-registry-format)
- [Minor Migrations](1.21.2-from-1.21.1.md#minor-migrations)
+- [资源包变更](1.21.2-from-1.21.1.md#资源包变更)
+- [持有者集过渡](1.21.2-from-1.21.1.md#持有者集-过渡)
+- [GUI 渲染类型](1.21.2-from-1.21.1.md#gui-渲染类型)
+- [着色器重写](1.21.2-from-1.21.1.md#着色器重写)
+- [实体渲染状态](1.21.2-from-1.21.1.md#实体渲染状态)
+- [装备与物品、模型等等](1.21.2-from-1.21.1.md#装备与物品-模型等等)
+- [盔甲材料、装备和模型（纹理）](1.21.2-from-1.21.1.md#盔甲材料-装备和模型纹理)
+- [交互结果](1.21.2-from-1.21.1.md#交互结果)
+- [乐器，数据包版](1.21.2-from-1.21.1.md#乐器-数据包版)
+- [试炼刷怪笼配置，现在采用数据包形式](1.21.2-from-1.21.1.md#试炼刷怪笼配置-现在采用数据包形式)
+- [配方提供者，数据提供者的“并非真正”](1.21.2-from-1.21.1.md#配方提供者-数据提供者的并非真正)
+- [原料的转变](1.21.2-from-1.21.1.md#原料的转变)
+- [BlockEntityTypes 私有化了！](1.21.2-from-1.21.1.md#blockentitytypes-私有化)
+- [消耗品](1.21.2-from-1.21.1.md#消耗品)
+- [注册表对象 ID，在属性里？](1.21.2-from-1.21.1.md#注册表对象-id-在属性里)
+- [属性变更](1.21.2-from-1.21.1.md#属性变更)
+- [配方，现在采用注册表格式](1.21.2-from-1.21.1.md#配方-现在采用注册表格式)
+- [小幅迁移](1.21.2-from-1.21.1.md#小幅-迁移)

 ## 1.21.2/3 -> 1.21.4

-[Full primer](1.21.4-from-1.21.2-3.md)
+[完整入门文档](1.21.4-from-1.21.2-3.md)

- [Pack Changes](1.21.4-from-1.21.2-3.md#pack-changes)
- [Client Items](1.21.4-from-1.21.2-3.md#client-items)
- [Mob Replacing Current Items](1.21.4-from-1.21.2-3.md#mob-replacing-current-items)
- [Particles, rendered through Render Types](1.21.4-from-1.21.2-3.md#particles-rendered-through-render-types)
- [Minor Migrations](1.21.4-from-1.21.2-3.md#minor-migrations)
+- [资源包变更](1.21.4-from-1.21.2-3.md#资源包变更)
+- [客户端物品](1.21.4-from-1.21.2-3.md#客户端-物品)
+- [生物替换当前物品](1.21.4-from-1.21.2-3.md#生物-替换当前物品)
+- [粒子，通过渲染类型渲染](1.21.4-from-1.21.2-3.md#粒子-通过渲染类型渲染)
+- [小幅迁移](1.21.4-from-1.21.2-3.md#小幅-迁移)

 ## 1.21.4 -> 1.21.5

-[Full primer](1.21.5-from-1.21.4.md)
+[完整入门文档](1.21.5-from-1.21.4.md)

- [Pack Changes](1.21.5-from-1.21.4.md#pack-changes)
- [Handling the Removal of Block Entities Properly](1.21.5-from-1.21.4.md#handling-the-removal-of-block-entities-properly)
- [Voxel Shape Helpers](1.21.5-from-1.21.4.md#voxel-shape-helpers)
- [Weapons, Tools, and Armor: Removing the Redundancies](1.21.5-from-1.21.4.md#weapons-tools-and-armor-removing-the-redundancies)
- [Weighted List Rework](1.21.5-from-1.21.4.md#weighted-list-rework)
- [Tickets](1.21.5-from-1.21.4.md#tickets)
- [The Game Test Overhaul](1.21.5-from-1.21.4.md#the-game-test-overhaul)
- [Data Component Getters](1.21.5-from-1.21.4.md#data-component-getters)
- [Tags and Parsing](1.21.5-from-1.21.4.md#tags-and-parsing)
- [Saved Data, now with Types](1.21.5-from-1.21.4.md#saved-data-now-with-types)
- [Render Pipeline Rework](1.21.5-from-1.21.4.md#render-pipeline-rework)
- [Model Rework](1.21.5-from-1.21.4.md#model-rework)
- [Minor Migrations](1.21.5-from-1.21.4.md#minor-migrations)
+- [资源包变更](1.21.5-from-1.21.4.md#资源包变更)
+- [正确处理方块实体的移除](1.21.5-from-1.21.4.md#正确处理方块实体的移除)
+- [体素形状辅助类](1.21.5-from-1.21.4.md#体素形状辅助类)
+- [武器、工具和盔甲：去除冗余](1.21.5-from-1.21.4.md#武器工具和盔甲-去除冗余)
+- [加权列表重做](1.21.5-from-1.21.4.md#加权列表重做)
+- [加载票](1.21.5-from-1.21.4.md#加载票)
+- [游戏测试大修](1.21.5-from-1.21.4.md#游戏测试-大修)
+- [数据组件获取器](1.21.5-from-1.21.4.md#数据组件-获取器)
+- [标签与解析](1.21.5-from-1.21.4.md#标签与解析)
+- [保存数据，现在带有类型](1.21.5-from-1.21.4.md#保存数据-现在带有类型)
+- [渲染管线重做](1.21.5-from-1.21.4.md#渲染管线重做)
+- [模型重做](1.21.5-from-1.21.4.md#模型-重做)
+- [小幅迁移](1.21.5-from-1.21.4.md#小幅-迁移)

 ## 1.21.5 -> 1.21.6

-[Full primer](1.21.6-from-1.21.5.md)
+[完整入门文档](1.21.6-from-1.21.5.md)

- [Pack Changes](1.21.6-from-1.21.5.md#pack-changes)
- [GUI Changes](1.21.6-from-1.21.5.md#gui-changes)
- [Waypoints](1.21.6-from-1.21.5.md#waypoints)
- [Blaze3d Changes](1.21.6-from-1.21.5.md#blaze3d-changes)
- [Tag Providers: Appender Rewrite](1.21.6-from-1.21.5.md#tag-providers-appender-rewrite)
- [Generic Encoding and Decoding: Replacing Direct NBT Access](1.21.6-from-1.21.5.md#generic-encoding-and-decoding-replacing-direct-nbt-access)
- [Server Player Changes](1.21.6-from-1.21.5.md#server-player-changes)
- [Minor Migrations](1.21.6-from-1.21.5.md#minor-migrations)
+- [资源包变更](1.21.6-from-1.21.5.md#资源包变更)
+- [GUI 变更](1.21.6-from-1.21.5.md#gui-变更)
+- [路径点](1.21.6-from-1.21.5.md#路径点)
+- [Blaze3d 变更](1.21.6-from-1.21.5.md#blaze3d-变更)
+- [标签提供者：追加器重写](1.21.6-from-1.21.5.md#标签提供者-追加器重写)
+- [通用编码与解码：替换直接 NBT 访问](1.21.6-from-1.21.5.md#通用编码与解码-替换直接-nbt-访问)
+- [服务端玩家变更](1.21.6-from-1.21.5.md#服务端玩家变更)
+- [小幅迁移](1.21.6-from-1.21.5.md#小幅-迁移)

 ## 1.21.6 -> 1.21.7

-[Full primer](1.21.7-from-1.21.6.md)
+[完整入门文档](1.21.7-from-1.21.6.md)

- [Pack Changes](1.21.7-from-1.21.6.md#pack-changes)
- [Minor Migrations](1.21.7-from-1.21.6.md#minor-migrations)
+- [资源包变更](1.21.7-from-1.21.6.md#资源包变更)
+- [小幅迁移](1.21.7-from-1.21.6.md#小幅-迁移)

 ## 1.21.7 -> 1.21.8

-[Full primer](1.21.8-from-1.21.7.md)
+[完整入门文档](1.21.8-from-1.21.7.md)

- [Pack Changes](1.21.8-from-1.21.7.md#pack-changes)
- [Minor Migrations](1.21.8-from-1.21.7.md#minor-migrations)
+- [资源包变更](1.21.8-from-1.21.7.md#资源包变更)
+- [小幅迁移](1.21.8-from-1.21.7.md#小幅-迁移)

 ## 1.21.8 -> 1.21.9

-[Full primer](1.21.9-from-1.21.8.md)
+[完整入门文档](1.21.9-from-1.21.8.md)

- [Pack Changes](1.21.9-from-1.21.8.md#pack-changes)
- [The Debugging Overhaul](1.21.9-from-1.21.8.md#the-debugging-overhaul)
- [Debug Screens](1.21.9-from-1.21.8.md#debug-screens)
- [Feature Submissions: The Movie](1.21.9-from-1.21.8.md#feature-submissions-the-movie)
- [The Font Glyph Pipeline](1.21.9-from-1.21.8.md#the-font-glyph-pipeline)
- [The JSON-RPC Management Servers](1.21.9-from-1.21.8.md#the-json-rpc-management-servers)
- [Input Handling Consolidation](1.21.9-from-1.21.8.md#input-handling-consolidation)
- [`Level#isClientSide` now private](1.21.9-from-1.21.8.md#levelisclientside-now-private)
- [Minor Migrations](1.21.9-from-1.21.8.md#minor-migrations)
+- [资源包变更](1.21.9-from-1.21.8.md#资源包变更)
+- [调试大修](1.21.9-from-1.21.8.md#调试-大修)
+- [调试屏幕](1.21.9-from-1.21.8.md#调试-屏幕)
+- [功能提交：电影版](1.21.9-from-1.21.8.md#功能提交-电影版)
+- [字体字形管线](1.21.9-from-1.21.8.md#字体-字形-管线)
+- [JSON-RPC 管理服务器](1.21.9-from-1.21.8.md#json-rpc-管理服务器)
+- [输入处理整合](1.21.9-from-1.21.8.md#输入处理整合)
+- [`Level#isClientSide` 现在为 private](1.21.9-from-1.21.8.md#levelisclientside-现在为-private)
+- [小幅迁移](1.21.9-from-1.21.8.md#小幅-迁移)

 ## 1.21.9 -> 1.21.10

-[Full primer](1.21.10-from-1.21.9.md)
+[完整入门文档](1.21.10-from-1.21.9.md)

- [Pack Changes](1.21.10-from-1.21.9.md#pack-changes)
- [Minor Migrations](1.21.10-from-1.21.9.md#minor-migrations)
+- [资源包变更](1.21.10-from-1.21.9.md#资源包变更)
+- [小幅迁移](1.21.10-from-1.21.9.md#小幅-迁移)

 ## 1.21.10 -> 1.21.11

-[Full primer](1.21.11-from-1.21.10.md)
+[完整入门文档](1.21.11-from-1.21.10.md)

- [Pack Changes](1.21.11-from-1.21.10.md#pack-changes)
- [The Rename Shuffle](1.21.11-from-1.21.10.md#the-rename-shuffle)
- [Oh Hey, Another Rendering Rewrite](1.21.11-from-1.21.10.md#oh-hey-another-rendering-rewrite)
- [Gizmos](1.21.11-from-1.21.10.md#gizmos)
- [Permission Overhaul](1.21.11-from-1.21.10.md#permission-overhaul)
- [New Data Components](1.21.11-from-1.21.10.md#new-data-components)
- [The Timeline of Environment Attributes](1.21.11-from-1.21.10.md#the-timeline-of-environment-attributes)
- [The Game Rule Shuffle](1.21.11-from-1.21.10.md#the-game-rule-shuffle)
- [Minor Migrations](1.21.11-from-1.21.10.md#minor-migrations)
+- [资源包变更](1.21.11-from-1.21.10.md#资源包变更)
+- [重命名混乱](1.21.11-from-1.21.10.md#重命名混乱)
+- [哦，又来了，一次渲染重写](1.21.11-from-1.21.10.md#哦又来了-一次渲染重写)
+- [Gizmo 控件](1.21.11-from-1.21.10.md#gizmo-控件)
+- [权限大修](1.21.11-from-1.21.10.md#权限-大修)
+- [新数据组件](1.21.11-from-1.21.10.md#新数据组件)
+- [环境属性的时间线](1.21.11-from-1.21.10.md#环境属性的时间线)
+- [游戏规则洗牌](1.21.11-from-1.21.10.md#游戏规则洗牌)
+- [小幅迁移](1.21.11-from-1.21.10.md#小幅-迁移)

 ## 1.21.11 -> 26.1

-[Full primer](26.1-from-1.21.11.md)
+[完整入门文档](26.1-from-1.21.11.md)

- [Pack Changes](26.1-from-1.21.11.md#pack-changes)
- [Java 25 and Deobfuscation](26.1-from-1.21.11.md#java-25-and-deobfuscation)
- [Loot Type Unrolling](26.1-from-1.21.11.md#loot-type-unrolling)
- [Validation Overhaul](26.1-from-1.21.11.md#validation-overhaul)
- [Datapack Villager Trades](26.1-from-1.21.11.md#datapack-villager-trades)
- [`Level#random` field now protected](26.1-from-1.21.11.md#levelrandom-field-now-protected)
- [Data Component Initializers](26.1-from-1.21.11.md#data-component-initializers)
- [Item Instances and Stack Templates](26.1-from-1.21.11.md#item-instances-and-stack-templates)
- [Serializer Records and Recipe Info](26.1-from-1.21.11.md#serializer-records-and-recipe-info)
- [Dye Component](26.1-from-1.21.11.md#dye-component)
- [World Clocks and Time Markers](26.1-from-1.21.11.md#world-clocks-and-time-markers)
- [Splitting the Primary Level Data into Saved Data](26.1-from-1.21.11.md#splitting-the-primary-level-data-into-saved-data)
- [Even More Rendering Changes](26.1-from-1.21.11.md#even-more-rendering-changes)
- [Minor Migrations](26.1-from-1.21.11.md#minor-migrations)
+- [资源包变更](26.1-from-1.21.11.md#资源包变更)
+- [Java 25 与反混淆](26.1-from-1.21.11.md#java-25-与反混淆)
+- [战利品类型展开](26.1-from-1.21.11.md#战利品类型-展开)
+- [验证大修](26.1-from-1.21.11.md#验证-大修)
+- [数据包村民交易](26.1-from-1.21.11.md#数据包村民交易)
+- [`Level#random` 字段现在为 protected](26.1-from-1.21.11.md#levelrandom-字段现在为-protected)
+- [数据组件初始化器](26.1-from-1.21.11.md#数据组件-初始化器)
+- [物品实例与堆栈模板](26.1-from-1.21.11.md#物品实例与堆栈模板)
+- [序列化器记录与配方信息](26.1-from-1.21.11.md#序列化器记录与配方信息)
+- [染料组件](26.1-from-1.21.11.md#染料组件)
+- [世界时钟与时间标记](26.1-from-1.21.11.md#世界时钟与时间标记)
+- [将主关卡数据拆分为保存数据](26.1-from-1.21.11.md#将主关卡数据拆分为保存数据)
+- [更多渲染变更](26.1-from-1.21.11.md#更多渲染变更)
+- [小幅迁移](26.1-from-1.21.11.md#小幅-迁移)
--- a/src/repeatedly-changing-systems.md
+++ b/src/repeatedly-changing-systems.md
@ -1,159 +1,159 @@
-# Repeatedly Changing Systems
+# 频繁变更的系统

-This page is the guard rail for the direct port.
+此页面是直接移植的防护栏。

-When the same subsystem changed in multiple intermediate versions, do not treat the earliest migration note as final. Use the latest applicable version as the source of truth, but still apply the older chapter first so the intermediate API transitions make sense.
+当同一子系统在多个中间版本中发生变化时，不要将最早的迁移说明视为最终版本。请使用最新的适用版本作为真实来源，但仍需先应用旧章节的内容，这样才能使中间的 API 过渡看起来合理。

-## Rendering and graphics
+## 渲染与图形

-Relevant sections:
+相关章节：

- [Gui Render Types](detailed-primers/1.21.2-from-1.21.1.md#gui-render-types) (1.21.2)
- [Shader Rewrites](detailed-primers/1.21.2-from-1.21.1.md#shader-rewrites) (1.21.2)
- [Entity Render States](detailed-primers/1.21.2-from-1.21.1.md#entity-render-states) (1.21.2)
- [Render Pipeline Rework](detailed-primers/1.21.5-from-1.21.4.md#render-pipeline-rework) (1.21.5)
- [Model Rework](detailed-primers/1.21.5-from-1.21.4.md#model-rework) (1.21.5)
- [GUI Changes](detailed-primers/1.21.6-from-1.21.5.md#gui-changes) (1.21.6)
- [Blaze3d Changes](detailed-primers/1.21.6-from-1.21.5.md#blaze3d-changes) (1.21.6)
- [Minor Migrations](detailed-primers/1.21.7-from-1.21.6.md#minor-migrations) (1.21.7)
- [Feature Submissions: The Movie](detailed-primers/1.21.9-from-1.21.8.md#feature-submissions-the-movie) (1.21.9)
- [The Font Glyph Pipeline](detailed-primers/1.21.9-from-1.21.8.md#the-font-glyph-pipeline) (1.21.9)
- [Oh Hey, Another Rendering Rewrite](detailed-primers/1.21.11-from-1.21.10.md#oh-hey-another-rendering-rewrite) (1.21.11)
- [Even More Rendering Changes](detailed-primers/26.1-from-1.21.11.md#even-more-rendering-changes) (26.1)
+- [GUI 渲染类型](detailed-primers/1.21.2-from-1.21.1.md#gui-渲染类型) (1.21.2)
+- [着色器重写](detailed-primers/1.21.2-from-1.21.1.md#着色器重写) (1.21.2)
+- [实体渲染状态](detailed-primers/1.21.2-from-1.21.1.md#实体渲染状态) (1.21.2)
+- [渲染管线重做](detailed-primers/1.21.5-from-1.21.4.md#渲染管线重做) (1.21.5)
+- [模型重做](detailed-primers/1.21.5-from-1.21.4.md#模型重做) (1.21.5)
+- [GUI 变更](detailed-primers/1.21.6-from-1.21.5.md#gui-变更) (1.21.6)
+- [Blaze3d 变更](detailed-primers/1.21.6-from-1.21.5.md#blaze3d-变更) (1.21.6)
+- [小幅迁移](detailed-primers/1.21.7-from-1.21.6.md#小幅迁移) (1.21.7)
+- [功能提交：电影版](detailed-primers/1.21.9-from-1.21.8.md#功能提交电影版) (1.21.9)
+- [字体 字形 管线](detailed-primers/1.21.9-from-1.21.8.md#字体-字形-管线) (1.21.9)
+- [哦，又来了，一次渲染重写](detailed-primers/1.21.11-from-1.21.10.md#哦又来了一次渲染重写) (1.21.11)
+- [更多渲染变更](detailed-primers/26.1-from-1.21.11.md#更多渲染变更) (26.1)

-How to read them:
+如何阅读它们：

- `1.21.2/3` changes GUI blits, shader JSON structure, and render-state assumptions.
- `1.21.5` is the first large rendering infrastructure rewrite around `RenderPipeline`, `GpuTexture`, and render passes.
- `1.21.6` changes GUI rendering flow again through prepare/render state separation.
- `1.21.9` changes how features are submitted for rendering.
- `1.21.11` changes samplers, render types, terrain split, and atlases.
- `26.1` is the final authority for block/item rendering, materials, tint sources, fluid models, particle layers, and backend-facing rendering APIs.
+- `1.21.2/3` 修改了 GUI 贴图混合、着色器 JSON 结构以及渲染状态假设。
+- `1.21.5` 是第一次大型渲染基础设施重写，围绕 `RenderPipeline`、`GpuTexture` 和渲染通道展开。
+- `1.21.6` 通过准备/渲染状态分离再次修改了 GUI 渲染流程。
+- `1.21.9` 修改了功能提交到渲染的方式。
+- `1.21.11` 修改了采样器、渲染类型、地形拆分和纹理图集。
+- `26.1` 是方块/物品渲染、材质、染色源、流体模型、粒子层以及面向后端的渲染 API 的最终权威。

-Practical rule:
+实用规则：

- Treat `26.1` as the final rendering target.
- Keep `1.21.4` client items and `1.21.6` GUI flow as still-active requirements, not obsolete history.
+- 将 `26.1` 视为最终的渲染目标。
+- 保留 `1.21.4` 客户端物品和 `1.21.6` GUI 流程作为仍然有效的要求，而不是过时的历史。

-## Item models and item metadata
+## 物品模型与物品元数据

-Relevant sections:
+相关章节：

- [Client Items](detailed-primers/1.21.4-from-1.21.2-3.md#client-items) (1.21.4)
- [Mob Replacing Current Items](detailed-primers/1.21.4-from-1.21.2-3.md#mob-replacing-current-items) (1.21.4)
- [Particles, rendered through Render Types](detailed-primers/1.21.4-from-1.21.2-3.md#particles-rendered-through-render-types) (1.21.4)
- [Weapons, Tools, and Armor: Removing the Redundancies](detailed-primers/1.21.5-from-1.21.4.md#weapons-tools-and-armor-removing-the-redundancies) (1.21.5)
- [Data Component Getters](detailed-primers/1.21.5-from-1.21.4.md#data-component-getters) (1.21.5)
- [Feature Submissions: The Movie](detailed-primers/1.21.9-from-1.21.8.md#feature-submissions-the-movie) (1.21.9)
- [Oh Hey, Another Rendering Rewrite](detailed-primers/1.21.11-from-1.21.10.md#oh-hey-another-rendering-rewrite) (1.21.11)
- [New Data Components](detailed-primers/1.21.11-from-1.21.10.md#new-data-components) (1.21.11)
- [Data Component Initializers](detailed-primers/26.1-from-1.21.11.md#data-component-initializers) (26.1)
- [Item Instances and Stack Templates](detailed-primers/26.1-from-1.21.11.md#item-instances-and-stack-templates) (26.1)
- [Dye Component](detailed-primers/26.1-from-1.21.11.md#dye-component) (26.1)
- [Even More Rendering Changes](detailed-primers/26.1-from-1.21.11.md#even-more-rendering-changes) (26.1)
+- [客户端物品](detailed-primers/1.21.4-from-1.21.2-3.md#客户端物品) (1.21.4)
+- [生物替换当前物品](detailed-primers/1.21.4-from-1.21.2-3.md#生物-替换当前物品) (1.21.4)
+- [粒子，通过渲染类型渲染](detailed-primers/1.21.4-from-1.21.2-3.md#粒子通过渲染类型渲染) (1.21.4)
+- [武器、工具和盔甲：去除冗余](detailed-primers/1.21.5-from-1.21.4.md#武器工具和盔甲去除冗余) (1.21.5)
+- [数据组件获取器](detailed-primers/1.21.5-from-1.21.4.md#数据组件获取器) (1.21.5)
+- [功能提交：电影版](detailed-primers/1.21.9-from-1.21.8.md#功能提交电影版) (1.21.9)
+- [哦，又来了，一次渲染重写](detailed-primers/1.21.11-from-1.21.10.md#哦又来了一次渲染重写) (1.21.11)
+- [新数据组件](detailed-primers/1.21.11-from-1.21.10.md#新数据组件) (1.21.11)
+- [数据组件初始化器](detailed-primers/26.1-from-1.21.11.md#数据组件初始化器) (26.1)
+- [物品实例与堆栈模板](detailed-primers/26.1-from-1.21.11.md#物品实例与堆栈模板) (26.1)
+- [染料组件](detailed-primers/26.1-from-1.21.11.md#染料组件) (26.1)
+- [更多渲染变更](detailed-primers/26.1-from-1.21.11.md#更多渲染变更) (26.1)

-What sticks:
+哪些内容留存下来：

- `1.21.4` client items are the baseline for item rendering data.
- `1.21.5` removes more hardcoded item-class assumptions in favor of components and equipment data.
- `1.21.9`, `1.21.11`, and `26.1` further change how items participate in rendering and metadata pipelines.
+- `1.21.4` 客户端物品是物品渲染数据的基线。
+- `1.21.5` 移除了更多硬编码的物品类假设，改用组件和装备数据。
+- `1.21.9`、`1.21.11` 和 `26.1` 进一步改变了物品参与渲染和元数据管道的方式。

-Practical rule:
+实用规则：

- First convert item assets to client items.
- Then port behavior and metadata around components.
- Finally validate them against the `26.1` rendering and item-instance model.
+- 首先将物品资源转换为客户端物品。
+- 然后围绕组件移植行为和元数据。
+- 最后对照 `26.1` 的渲染和物品实例模型进行验证。

-## Tags, registries, codecs, and validation
+## 标签、注册表、编解码器与验证

-Relevant sections:
+相关章节：

- [The Holder Set Transition](detailed-primers/1.21.2-from-1.21.1.md#the-holder-set-transition) (1.21.2)
- [Registry Objcet Id, in the Properties?](detailed-primers/1.21.2-from-1.21.1.md#registry-objcet-id-in-the-properties) (1.21.2)
- [Recipes, now in Registry format](detailed-primers/1.21.2-from-1.21.1.md#recipes-now-in-registry-format) (1.21.2)
- [Tags and Parsing](detailed-primers/1.21.5-from-1.21.4.md#tags-and-parsing) (1.21.5)
- [Tag Providers: Appender Rewrite](detailed-primers/1.21.6-from-1.21.5.md#tag-providers-appender-rewrite) (1.21.6)
- [Generic Encoding and Decoding: Replacing Direct NBT Access](detailed-primers/1.21.6-from-1.21.5.md#generic-encoding-and-decoding-replacing-direct-nbt-access) (1.21.6)
- [The Rename Shuffle](detailed-primers/1.21.11-from-1.21.10.md#the-rename-shuffle) (1.21.11)
- [Loot Type Unrolling](detailed-primers/26.1-from-1.21.11.md#loot-type-unrolling) (26.1)
- [Validation Overhaul](detailed-primers/26.1-from-1.21.11.md#validation-overhaul) (26.1)
- [Serializer Records and Recipe Info](detailed-primers/26.1-from-1.21.11.md#serializer-records-and-recipe-info) (26.1)
+- [持有者集过渡](detailed-primers/1.21.2-from-1.21.1.md#持有者集-过渡) (1.21.2)
+- [注册表对象 ID，在属性里？](detailed-primers/1.21.2-from-1.21.1.md#注册表对象-id在属性里) (1.21.2)
+- [配方，现在采用注册表格式](detailed-primers/1.21.2-from-1.21.1.md#配方现在采用注册表格式) (1.21.2)
+- [标签与解析](detailed-primers/1.21.5-from-1.21.4.md#标签与解析) (1.21.5)
+- [TagAppender 重写](detailed-primers/1.21.6-from-1.21.5.md#TagAppender-重写) (1.21.6)
+- [通用编码与解码：替换直接 NBT 访问](detailed-primers/1.21.6-from-1.21.5.md#通用编码与解码替换直接-nbt-访问) (1.21.6)
+- [重命名混乱](detailed-primers/1.21.11-from-1.21.10.md#重命名混乱) (1.21.11)
+- [战利品类型展开](detailed-primers/26.1-from-1.21.11.md#战利品类型展开) (26.1)
+- [验证大修](detailed-primers/26.1-from-1.21.11.md#验证大修) (26.1)
+- [序列化器记录与配方信息](detailed-primers/26.1-from-1.21.11.md#序列化器记录与配方信息) (26.1)

-What sticks:
+哪些内容留存下来：

- `1.21.2/3` is where `Holder` and `HolderSet` start affecting large parts of the codebase.
- `1.21.5` changes tag access, parser behavior, codec-based reads and writes, and saved-data construction.
- `1.21.6` changes tag provider building and nudges more code toward generic encoding and decoding.
- `1.21.11` contributes rename churn that affects registry and identifier-facing code.
- `26.1` finalizes more codec-driven infrastructure with loot type unrolling and validation overhaul.
+- `1.21.2/3` 是 `Holder` 和 `HolderSet` 开始影响代码库大部分内容的版本。
+- `1.21.5` 修改了标签访问、解析器行为、基于编解码器的读写以及保存数据的构造。
+- `1.21.6` 修改了标签提供者的构建方式，并推动更多代码转向通用编码和解码。
+- `1.21.11` 带来了重命名的变动，影响注册表和标识符相关的代码。
+- `26.1` 通过战利品类型展开和验证大修最终确定了更多基于编解码器的基础设施。

-Practical rule:
+实用规则：

- The earlier chapters tell you how to get onto holder- and codec-based APIs.
- `26.1` is the final target for validation and loot registration shape.
+- 前面的章节告诉您如何迁移到基于持有者和编解码器的 API。
+- `26.1` 是验证和战利品注册形式的最终目标。

-## Data components
+## 数据组件

-Relevant sections:
+相关章节：

- [Consumables](detailed-primers/1.21.2-from-1.21.1.md#consumables) (1.21.2)
- [Equipments and Items, Models and All](detailed-primers/1.21.2-from-1.21.1.md#equipments-and-items-models-and-all) (1.21.2)
- [The Ingredient Shift](detailed-primers/1.21.2-from-1.21.1.md#the-ingredient-shift) (1.21.2)
- [Recipes, now in Registry format](detailed-primers/1.21.2-from-1.21.1.md#recipes-now-in-registry-format) (1.21.2)
- [Weapons, Tools, and Armor: Removing the Redundancies](detailed-primers/1.21.5-from-1.21.4.md#weapons-tools-and-armor-removing-the-redundancies) (1.21.5)
- [Data Component Getters](detailed-primers/1.21.5-from-1.21.4.md#data-component-getters) (1.21.5)
- [New Data Components](detailed-primers/1.21.11-from-1.21.10.md#new-data-components) (1.21.11)
- [Data Component Initializers](detailed-primers/26.1-from-1.21.11.md#data-component-initializers) (26.1)
- [Dye Component](detailed-primers/26.1-from-1.21.11.md#dye-component) (26.1)
+- [消耗品](detailed-primers/1.21.2-from-1.21.1.md#消耗品) (1.21.2)
+- [装备与物品、模型等等](detailed-primers/1.21.2-from-1.21.1.md#装备与物品模型等等) (1.21.2)
+- [原料的转变](detailed-primers/1.21.2-from-1.21.1.md#原料的转变) (1.21.2)
+- [配方，现在采用注册表格式](detailed-primers/1.21.2-from-1.21.1.md#配方现在采用注册表格式) (1.21.2)
+- [武器、工具和盔甲：去除冗余](detailed-primers/1.21.5-from-1.21.4.md#武器工具和盔甲去除冗余) (1.21.5)
+- [数据组件获取器](detailed-primers/1.21.5-from-1.21.4.md#数据组件获取器) (1.21.5)
+- [新数据组件](detailed-primers/1.21.11-from-1.21.10.md#新数据组件) (1.21.11)
+- [数据组件初始化器](detailed-primers/26.1-from-1.21.11.md#数据组件初始化器) (26.1)
+- [染料组件](detailed-primers/26.1-from-1.21.11.md#染料组件) (26.1)

-What sticks:
+哪些内容留存下来：

- `1.21.2/3` introduces important component-facing migrations such as consumables and recipe-related data moves.
- `1.21.5` expands component-centered behavior for tools, armor, weapons, and general data access.
- `1.21.11` adds more component types.
- `26.1` continues with initializers, dye components, and more component additions.
+- `1.21.2/3` 引入了重要的组件相关迁移，例如消耗品和配方相关数据的移动。
+- `1.21.5` 扩展了以组件为中心的工具、盔甲、武器以及通用数据访问行为。
+- `1.21.11` 添加了更多组件类型。
+- `26.1` 继续添加初始化器、染料组件以及更多组件。

-Practical rule:
+实用规则：

- Expect items and recipes to get less class-driven and more component-driven as you move forward.
+- 随着版本推进，物品和配方将越来越少地由类驱动，而越来越多地由组件驱动。

-## Saved data and world state
+## 保存数据与世界状态

-Relevant sections:
+相关章节：

- [Saved Data, now with Types](detailed-primers/1.21.5-from-1.21.4.md#saved-data-now-with-types) (1.21.5)
- [Splitting the Primary Level Data into Saved Data](detailed-primers/26.1-from-1.21.11.md#splitting-the-primary-level-data-into-saved-data) (26.1)
- [World Clocks and Time Markers](detailed-primers/26.1-from-1.21.11.md#world-clocks-and-time-markers) (26.1)
+- [保存数据，现在带有类型](detailed-primers/1.21.5-from-1.21.4.md#保存数据现在带有类型) (1.21.5)
+- [将主关卡数据拆分为保存数据](detailed-primers/26.1-from-1.21.11.md#将主关卡数据拆分为保存数据) (26.1)
+- [世界时钟与时间标记](detailed-primers/26.1-from-1.21.11.md#世界时钟与时间标记) (26.1)

-What sticks:
+哪些内容留存下来：

- `1.21.5` moves saved data to `SavedDataType`.
- `26.1` splits primary level data further into dedicated saved-data objects.
+- `1.21.5` 将保存数据迁移到 `SavedDataType`。
+- `26.1` 进一步将主关卡数据拆分到专用的保存数据对象中。

-Practical rule:
+实用规则：

- Do the `1.21.5` migration first, then revisit every level/world persistence assumption again in `26.1`.
+- 先完成 `1.21.5` 的迁移，然后在 `26.1` 中重新审视每个关卡/世界持久化的假设。

-## Developer tooling, tests, debugging, and permissions
+## 开发者工具、测试、调试与权限

-Relevant sections:
+相关章节：

- [The Game Test Overhaul](detailed-primers/1.21.5-from-1.21.4.md#the-game-test-overhaul) (1.21.5)
- [The Debugging Overhaul](detailed-primers/1.21.9-from-1.21.8.md#the-debugging-overhaul) (1.21.9)
- [Debug Screens](detailed-primers/1.21.9-from-1.21.8.md#debug-screens) (1.21.9)
- [The JSON-RPC Management Servers](detailed-primers/1.21.9-from-1.21.8.md#the-json-rpc-management-servers) (1.21.9)
- [Permission Overhaul](detailed-primers/1.21.11-from-1.21.10.md#permission-overhaul) (1.21.11)
- [Gizmos](detailed-primers/1.21.11-from-1.21.10.md#gizmos) (1.21.11)
- [Java 25 and Deobfuscation](detailed-primers/26.1-from-1.21.11.md#java-25-and-deobfuscation) (26.1)
+- [游戏测试大修](detailed-primers/1.21.5-from-1.21.4.md#游戏测试大修) (1.21.5)
+- [调试大修](detailed-primers/1.21.9-from-1.21.8.md#调试大修) (1.21.9)
+- [调试屏幕](detailed-primers/1.21.9-from-1.21.8.md#调试屏幕) (1.21.9)
+- [JSON-RPC 管理服务器](detailed-primers/1.21.9-from-1.21.8.md#json-rpc-管理服务器) (1.21.9)
+- [权限大修](detailed-primers/1.21.11-from-1.21.10.md#权限大修) (1.21.11)
+- [Gizmo 控件](detailed-primers/1.21.11-from-1.21.10.md#gizmo-控件) (1.21.11)
+- [Java 25 与反混淆](detailed-primers/26.1-from-1.21.11.md#java-25-与反混淆) (26.1)

-What sticks:
+哪些内容留存下来：

- `1.21.5` overhauls game tests.
- `1.21.9` overhauls debugging and management-server shape.
- `1.21.11` adds a permission overhaul and gizmo-focused visualization work.
- `26.1` adds Java 25 and more minor tooling-facing changes.
+- `1.21.5` 大修了游戏测试。
+- `1.21.9` 大修了调试和管理服务器的形态。
+- `1.21.11` 添加了权限大修和以 gizmo 为中心的可视化工作。
+- `26.1` 添加了 Java 25 以及更多面向工具的小改动。

-Practical rule:
+实用规则：

- Port gameplay code first.
- Then re-enable your debug, test, and operator-only tooling against the later chapters.
+- 先移植游戏玩法代码。
+- 然后根据后续章节重新启用您的调试、测试和仅限操作员的工具。
--- a/src/source-and-attribution.md
+++ b/src/source-and-attribution.md
@ -1,14 +1,14 @@
-# Source And Attribution
+# 来源与归属声明

-This docs tree was assembled from the upstream primers in:
+本文档树由以下上游迁移指南汇编而成：

- Repository: `https://github.com/ChampionAsh5357/neoforged-github`
- Branch: `update/26.1`
- Primer root: `primers/`
+- 代码库：`https://github.com/ChampionAsh5357/neoforged-github`
+- 分支：`update/26.1`
+- 指南根目录：`primers/`

-## Coverage used for this compilation
+## 本次汇编采用的覆盖范围

-The compiled direct-port guide includes these upstream primer steps:
+编译的直接移植指南包含以下上游迁移步骤：

 - `1.21.1 -> 1.21.2/3`
 - `1.21.2/3 -> 1.21.4`
@ -21,19 +21,20 @@ The compiled direct-port guide includes these upstream primer steps:
 - `1.21.10 -> 1.21.11`
 - `1.21.11 -> 26.1`

-## Attribution
+## 归属说明

-Per the upstream `primers/README.md`:
+根据上游`primers/README.md`声明：

- Primers for versions `1.12 - 1.15` were written by `@williewillus`.
- Primers for versions `1.16 - 1.17` were written by `@50ap5ud5`.
- All newer primers, including the ones used here, were written by `@ChampionAsh5357`.
+- `1.12 - 1.15`版本迁移指南由`@williewillus`编写
+- `1.16 - 1.17`版本迁移指南由`@50ap5ud5`编写
+- 所有新版指南（包括本文采用的）均由`@ChampionAsh5357`编写
+- 文本翻译由`@Gugle`借助`@Deepseek`编写

-## Licensing note
+## 许可证说明

-The detailed primers copied into this docs tree remain under their upstream licenses and attribution requirements.
+复制到本文档树的详细迁移指南仍遵循其上游许可证及归属要求。

-For the exact license text and upstream breakdown, refer to:
+具体许可证文本及上游拆分请查阅：

 - `repo/primers/README.md`
 - `repo/primers/LICENSE-CHAMPIONASH5357`