Leisuretimedock/Porting-Primers
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Add zh-CN translation and update deployment

Browse Source 
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.
This commit is contained in:
Gugle 2026-04-14 17:03:08 +08:00
parent 7bf7ee6fe6
commit bd6f1d5ffe
No known key found for this signature in database
GPG Key ID: 8EA96633CB40D9FE
18 changed files with 11402 additions and 12048 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
.github/workflows/deploy-pages.yml vendored
View File

@ -3,7 +3,7 @@ name: Deploy Pages
on: on:
push: push:
branches: branches:
- main - translate/**
workflow_dispatch: workflow_dispatch:
permissions: permissions:

15
README.md
View File

@ -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 站点通过`.github/workflows/deploy-pages.yml`工作流自动部署至GitHub Pages，源文件来自`main`分支。
- 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`.

12
book.toml
View File

@ -1,16 +1,16 @@
[book] [book]
authors = ["Leclowndu93150", "OpenAI Codex"] authors = ["Leclowndu93150", "OpenAI Codex", "Gugle", "Deepseek"]
language = "en" language = "zh-CN"
src = "src" src = "src"
title = "1.21.1 to 26.1 Porting Primers" title = "1.21.1至26.1迁移指南"
description = "A topic-indexed NeoForge porting guide and upstream primer archive for migrating from 1.21.1 to 26.1." description = "针对从1.21.1迁移至26.1版本的主题索引式NeoForge迁移指南与上游基础教程存档。"
[output.html] [output.html]
default-theme = "navy" default-theme = "navy"
preferred-dark-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/" 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 no-section-label = true
additional-css = ["theme/gitbook.css"] additional-css = ["theme/gitbook.css"]

465
src/README.md
View File

@ -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` `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) - [重命名混乱](detailed-primers/1.21.11-from-1.21.10.md#重命名混乱) (1.21.11)
- [ResourceLocation to Identifier](detailed-primers/1.21.11-from-1.21.10.md#resourcelocation-to-identifier) (1.21.11) - [ResourceLocation 到 Identifier](detailed-primers/1.21.11-from-1.21.10.md#resourcelocation-到-identifier) (1.21.11)
- [The util Package](detailed-primers/1.21.11-from-1.21.10.md#the-util-package) (1.21.11) - [util 包](detailed-primers/1.21.11-from-1.21.10.md#util-包) (1.21.11)
- [critereon to criterion](detailed-primers/1.21.11-from-1.21.10.md#critereon-to-criterion) (1.21.11) - [critereon 到 criterion](detailed-primers/1.21.11-from-1.21.10.md#critereon-到-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) - [实体和对象子包](detailed-primers/1.21.11-from-1.21.10.md#实体和对象子包) (1.21.11)
- [Java 25 and Deobfuscation](detailed-primers/26.1-from-1.21.11.md#java-25-and-deobfuscation) (26.1) - [Java 25 与反混淆](detailed-primers/26.1-from-1.21.11.md#java-25-与反混淆) (26.1)
- [JSpecify Annotations](detailed-primers/1.21.11-from-1.21.10.md#jspecify-annotations) (1.21.11) - [JSpecify 注解](detailed-primers/1.21.11-from-1.21.10.md#jspecify-注解) (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)
**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) - [持有者集过渡](detailed-primers/1.21.2-from-1.21.1.md#持有者集-过渡) (1.21.2)
- [The Ingredient Shift](detailed-primers/1.21.2-from-1.21.1.md#the-ingredient-shift) (1.21.2) - [原料的转变](detailed-primers/1.21.2-from-1.21.1.md#原料的转变) (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) - [配方，现在采用注册表格式](detailed-primers/1.21.2-from-1.21.1.md#配方现在采用注册表格式) (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) - [配方提供者，数据提供者的“并非真正”](detailed-primers/1.21.2-from-1.21.1.md#配方提供者数据提供者的并非真正) (1.21.2)
- [Instruments, the Datapack Edition](detailed-primers/1.21.2-from-1.21.1.md#instruments-the-datapack-edition) (1.21.2) - [乐器，数据包版](detailed-primers/1.21.2-from-1.21.1.md#乐器-数据包版) (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) - [试炼刷怪笼配置，现在采用数据包形式](detailed-primers/1.21.2-from-1.21.1.md#试炼刷怪笼配置现在采用数据包形式) (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) - [条件，通过 HolderGetter 提供](detailed-primers/1.21.2-from-1.21.1.md#条件通过-holdergetter-提供) (1.21.2 次要)
- [Codecable Json Reload Listener](detailed-primers/1.21.2-from-1.21.1.md#codecable-json-reload-listener) (1.21.2 minor) - [可编解码的 JSON 重载监听器](detailed-primers/1.21.2-from-1.21.1.md#可编解码的-json-重载监听器) (1.21.2 次要)
- [Context Keys](detailed-primers/1.21.2-from-1.21.1.md#context-keys) (1.21.2 minor) - [上下文键](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 minor) - [SimpleJsonResourceReloadListener](detailed-primers/1.21.4-from-1.21.2-3.md#simplejsonresourcereloadlistener) (1.21.4 次要)
- [MetadataSectionSerializer, replaced by Codecs](detailed-primers/1.21.4-from-1.21.2-3.md#metadatasectionserializer-replaced-by-codecs) (1.21.4 minor) - [MetadataSectionSerializer，被 Codec 取代](detailed-primers/1.21.4-from-1.21.2-3.md#metadatasectionserializer被-codec-取代) (1.21.4 次要)
- [Tags and Parsing](detailed-primers/1.21.5-from-1.21.4.md#tags-and-parsing) (1.21.5) - [标签与解析](detailed-primers/1.21.5-from-1.21.4.md#标签与解析) (1.21.5)
- [Model Rework](detailed-primers/1.21.5-from-1.21.4.md#model-rework) (1.21.5) - [模型重做](detailed-primers/1.21.5-from-1.21.4.md#模型重做) (1.21.5)
- [Registry Context Swapper](detailed-primers/1.21.5-from-1.21.4.md#registry-context-swapper) (1.21.5 minor) - [注册表上下文交换器](detailed-primers/1.21.5-from-1.21.4.md#注册表上下文交换器) (1.21.5 次要)
- [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) - [定时器回调，加入编解码器俱乐部！](detailed-primers/1.21.5-from-1.21.4.md#定时器回调加入编解码器俱乐部) (1.21.5 次要)
- [Tag Providers: Appender Rewrite](detailed-primers/1.21.6-from-1.21.5.md#tag-providers-appender-rewrite) (1.21.6) - [TagAppender 重写](detailed-primers/1.21.6-from-1.21.5.md#TagAppender-重写) (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) - [通用编码与解码：替换直接 NBT 访问](detailed-primers/1.21.6-from-1.21.5.md#通用编码与解码替换直接-nbt-访问) (1.21.6)
- [Loot Type Unrolling](detailed-primers/26.1-from-1.21.11.md#loot-type-unrolling) (26.1) - [战利品类型展开](detailed-primers/26.1-from-1.21.11.md#战利品类型展开) (26.1)
- [Validation Overhaul](detailed-primers/26.1-from-1.21.11.md#validation-overhaul) (26.1) - [验证大修](detailed-primers/26.1-from-1.21.11.md#验证大修) (26.1)
- [Datapack Villager Trades](detailed-primers/26.1-from-1.21.11.md#datapack-villager-trades) (26.1) - [数据包村民交易](detailed-primers/26.1-from-1.21.11.md#数据包村民交易) (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/26.1-from-1.21.11.md#序列化器记录与配方信息) (26.1)
- [New Tag Providers](detailed-primers/26.1-from-1.21.11.md#new-tag-providers) (26.1 minor) - [新标签提供者](detailed-primers/26.1-from-1.21.11.md#新标签提供者) (26.1 次要)
- [Plantable Tags](detailed-primers/26.1-from-1.21.11.md#plantable-tags) (26.1 minor) - [可种植标签](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) - [装备与物品、模型等等](detailed-primers/1.21.2-from-1.21.1.md#装备与物品模型等等) (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) - [盔甲材料、装备和模型（纹理）](detailed-primers/1.21.2-from-1.21.1.md#盔甲材料装备和模型纹理) (1.21.2)
- [Consumables](detailed-primers/1.21.2-from-1.21.1.md#consumables) (1.21.2) - [消耗品](detailed-primers/1.21.2-from-1.21.1.md#消耗品) (1.21.2)
- [Interaction Results](detailed-primers/1.21.2-from-1.21.1.md#interaction-results) (1.21.2) - [交互结果](detailed-primers/1.21.2-from-1.21.1.md#交互结果) (1.21.2)
- [BlockEntityTypes Privatized!](detailed-primers/1.21.2-from-1.21.1.md#blockentitytypes-privatized) (1.21.2) - [BlockEntityTypes 私有化了！](detailed-primers/1.21.2-from-1.21.1.md#blockentitytypes-私有化了) (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) - [注册表对象 ID，在属性里？](detailed-primers/1.21.2-from-1.21.1.md#注册表对象-id在属性里) (1.21.2)
- [Properties Changes](detailed-primers/1.21.2-from-1.21.1.md#properties-changes) (1.21.2) - [属性变更](detailed-primers/1.21.2-from-1.21.1.md#属性变更) (1.21.2)
- [Fuel Values](detailed-primers/1.21.2-from-1.21.1.md#fuel-values) (1.21.2 minor) - [燃料值](detailed-primers/1.21.2-from-1.21.1.md#燃料值) (1.21.2 次要)
- [Mob Replacing Current Items](detailed-primers/1.21.4-from-1.21.2-3.md#mob-replacing-current-items) (1.21.4) - [生物替换当前物品](detailed-primers/1.21.4-from-1.21.2-3.md#生物-替换当前物品) (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) - [武器、工具和盔甲：去除冗余](detailed-primers/1.21.5-from-1.21.4.md#武器工具和盔甲去除冗余) (1.21.5)
- [Data Component Getters](detailed-primers/1.21.5-from-1.21.4.md#data-component-getters) (1.21.5) - [数据组件获取器](detailed-primers/1.21.5-from-1.21.4.md#数据组件获取器) (1.21.5)
- [Component Interaction Events](detailed-primers/1.21.5-from-1.21.4.md#component-interaction-events) (1.21.5 minor) - [组件交互事件](detailed-primers/1.21.5-from-1.21.4.md#组件交互事件) (1.21.5 次要)
- [Item Owner](detailed-primers/1.21.9-from-1.21.8.md#item-owner) (1.21.9 minor) - [物品拥有者](detailed-primers/1.21.9-from-1.21.8.md#物品拥有者) (1.21.9 次要)
- [Container User](detailed-primers/1.21.9-from-1.21.8.md#container-user) (1.21.9 minor) - [容器使用者](detailed-primers/1.21.9-from-1.21.8.md#容器使用者) (1.21.9 次要)
- [Slot Sources](detailed-primers/1.21.11-from-1.21.10.md#slot-sources) (1.21.11 minor) - [槽位来源](detailed-primers/1.21.11-from-1.21.10.md#槽位来源) (1.21.11 次要)
- [New Data Components](detailed-primers/1.21.11-from-1.21.10.md#new-data-components) (1.21.11) - [新数据组件](detailed-primers/1.21.11-from-1.21.10.md#新数据组件) (1.21.11)
- [Data Component Initializers](detailed-primers/26.1-from-1.21.11.md#data-component-initializers) (26.1) - [数据组件初始化器](detailed-primers/26.1-from-1.21.11.md#数据组件初始化器) (26.1)
- [Item Instances and Stack Templates](detailed-primers/26.1-from-1.21.11.md#item-instances-and-stack-templates) (26.1) - [物品实例与堆栈模板](detailed-primers/26.1-from-1.21.11.md#物品实例与堆栈模板) (26.1)
- [Dye Component](detailed-primers/26.1-from-1.21.11.md#dye-component) (26.1) - [染料组件](detailed-primers/26.1-from-1.21.11.md#染料组件) (26.1)
- [Data Component Additions](detailed-primers/26.1-from-1.21.11.md#data-component-additions) (26.1 minor) - [数据组件新增](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) - [GUI 渲染类型](detailed-primers/1.21.2-from-1.21.1.md#gui-渲染类型) (1.21.2)
- [Shader Rewrites](detailed-primers/1.21.2-from-1.21.1.md#shader-rewrites) (1.21.2) - [着色器重写](detailed-primers/1.21.2-from-1.21.1.md#着色器重写) (1.21.2)
- [Entity Render States](detailed-primers/1.21.2-from-1.21.1.md#entity-render-states) (1.21.2) - [实体渲染状态](detailed-primers/1.21.2-from-1.21.1.md#实体渲染状态) (1.21.2)
- [Fog Parameters](detailed-primers/1.21.2-from-1.21.1.md#fog-parameters) (1.21.2 minor) - [雾参数](detailed-primers/1.21.2-from-1.21.1.md#雾参数) (1.21.2 次要)
- [Light Emissions](detailed-primers/1.21.2-from-1.21.1.md#light-emissions) (1.21.2 minor) - [发光强度](detailed-primers/1.21.2-from-1.21.1.md#发光强度) (1.21.2 次要)
- [Map Textures](detailed-primers/1.21.2-from-1.21.1.md#map-textures) (1.21.2 minor) - [地图纹理](detailed-primers/1.21.2-from-1.21.1.md#地图纹理) (1.21.2 次要)
- [Client Items](detailed-primers/1.21.4-from-1.21.2-3.md#client-items) (1.21.4) - [客户端物品](detailed-primers/1.21.4-from-1.21.2-3.md#客户端物品) (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) - [粒子，通过渲染类型渲染](detailed-primers/1.21.4-from-1.21.2-3.md#粒子通过渲染类型渲染) (1.21.4)
- [Render Pipeline Rework](detailed-primers/1.21.5-from-1.21.4.md#render-pipeline-rework) (1.21.5) - [渲染管线重做](detailed-primers/1.21.5-from-1.21.4.md#渲染管线重做) (1.21.5)
- [Model Rework](detailed-primers/1.21.5-from-1.21.4.md#model-rework) (1.21.5) - [模型重做](detailed-primers/1.21.5-from-1.21.4.md#模型重做) (1.21.5)
- [Texture Atlas Reworks](detailed-primers/1.21.5-from-1.21.4.md#texture-atlas-reworks) (1.21.5 minor) - [纹理图集重做](detailed-primers/1.21.5-from-1.21.4.md#纹理图集重做) (1.21.5 次要)
- [GUI Changes](detailed-primers/1.21.6-from-1.21.5.md#gui-changes) (1.21.6) - [GUI 变更](detailed-primers/1.21.6-from-1.21.5.md#gui-变更) (1.21.6)
- [Blaze3d Changes](detailed-primers/1.21.6-from-1.21.5.md#blaze3d-changes) (1.21.6) - [Blaze3d 变更](detailed-primers/1.21.6-from-1.21.5.md#blaze3d-变更) (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) - [移除生物效果图集](detailed-primers/1.21.6-from-1.21.5.md#移除生物效果图集) (1.21.6 次要)
- [Animation Baking](detailed-primers/1.21.6-from-1.21.5.md#animation-baking) (1.21.6 minor) - [动画烘焙](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 minor) - [ChunkSectionLayers](detailed-primers/1.21.6-from-1.21.5.md#chunksectionlayers) (1.21.6 次要)
- [Minor Migrations](detailed-primers/1.21.7-from-1.21.6.md#minor-migrations) (1.21.7 -- GUI render follow-ups) - [小幅迁移](detailed-primers/1.21.7-from-1.21.6.md#小幅迁移) (1.21.7 —— GUI 渲染后续)
- [Minor Migrations](detailed-primers/1.21.8-from-1.21.7.md#minor-migrations) (1.21.8 -- GraphicsWorkarounds) - [小幅迁移](detailed-primers/1.21.8-from-1.21.7.md#小幅迁移) (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) - [功能提交：电影版](detailed-primers/1.21.9-from-1.21.8.md#功能提交电影版) (1.21.9)
- [The Font Glyph Pipeline](detailed-primers/1.21.9-from-1.21.8.md#the-font-glyph-pipeline) (1.21.9) - [字体字形管线](detailed-primers/1.21.9-from-1.21.8.md#字体-字形-管线) (1.21.9)
- [Client Asset Split](detailed-primers/1.21.9-from-1.21.8.md#client-asset-split) (1.21.9 minor) - [客户端资源拆分](detailed-primers/1.21.9-from-1.21.8.md#客户端资源拆分) (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) - [哦，又来了，一次渲染重写](detailed-primers/1.21.11-from-1.21.10.md#哦又来了一次渲染重写) (1.21.11)
- [Gizmos](detailed-primers/1.21.11-from-1.21.10.md#gizmos) (1.21.11) - [Gizmo 控件](detailed-primers/1.21.11-from-1.21.10.md#gizmo-控件) (1.21.11)
- [Even More Rendering Changes](detailed-primers/26.1-from-1.21.11.md#even-more-rendering-changes) (26.1) - [更多渲染变更](detailed-primers/26.1-from-1.21.11.md#更多渲染变更) (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) - [实体纹理与成年/幼年模型](detailed-primers/26.1-from-1.21.11.md#实体纹理与成年幼年模型) (26.1 次要)
- [Audio Changes](detailed-primers/26.1-from-1.21.11.md#audio-changes) (26.1 minor) - [音频变更](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) - [交互结果](detailed-primers/1.21.2-from-1.21.1.md#交互结果) (1.21.2)
- [EXPLOOOOSSSION!](detailed-primers/1.21.2-from-1.21.1.md#exploooosssion) (1.21.2 minor -- `Explosion` is now an interface) - [爆——炸——！](detailed-primers/1.21.2-from-1.21.1.md#爆炸) (1.21.2 次要 —— `Explosion` 现在是一个接口)
- [Mob Conversions](detailed-primers/1.21.2-from-1.21.1.md#mob-conversions) (1.21.2 minor -- `Mob#convertTo` changed) - [生物转化](detailed-primers/1.21.2-from-1.21.1.md#生物转化) (1.21.2 次要 —— `Mob#convertTo` 已变更)
- [Minecart Behavior](detailed-primers/1.21.2-from-1.21.1.md#minecart-behavior) (1.21.2 minor) - [矿车行为](detailed-primers/1.21.2-from-1.21.1.md#矿车行为) (1.21.2 次要)
- [Ender Pearl Chunk Loading](detailed-primers/1.21.2-from-1.21.1.md#ender-pearl-chunk-loading) (1.21.2 minor) - [末影珍珠加载区块](detailed-primers/1.21.2-from-1.21.1.md#末影珍珠加载区块) (1.21.2 次要)
- [Entity References](detailed-primers/1.21.5-from-1.21.4.md#entity-references) (1.21.5 minor -- UUID replaced by `EntityReference`) - [实体引用](detailed-primers/1.21.5-from-1.21.4.md#实体引用) (1.21.5 次要 —— UUID 被 `EntityReference` 取代)
- [Leashes](detailed-primers/1.21.6-from-1.21.5.md#leashes) (1.21.6 minor) - [拴绳](detailed-primers/1.21.6-from-1.21.5.md#拴绳) (1.21.6 次要)
- [Typed Entity Data](detailed-primers/1.21.9-from-1.21.8.md#typed-entity-data) (1.21.9 minor) - [类型化实体数据](detailed-primers/1.21.9-from-1.21.8.md#类型化实体数据) (1.21.9 次要)
- [Name And Id](detailed-primers/1.21.9-from-1.21.8.md#name-and-id) (1.21.9 minor) - [名称和 ID](detailed-primers/1.21.9-from-1.21.8.md#名称和-id) (1.21.9 次要)
- [The Removal of interactAt](detailed-primers/26.1-from-1.21.11.md#the-removal-of-interactat) (26.1 minor -- `Entity#interactAt` removed) - [interactAt 的移除](detailed-primers/26.1-from-1.21.11.md#interactat-的移除) (26.1 次要 —— `Entity#interactAt` 已移除)
- [Activities and Brains](detailed-primers/26.1-from-1.21.11.md#activities-and-brains) (26.1 minor -- AI brain system changes) - [活动与大脑](detailed-primers/26.1-from-1.21.11.md#活动与大脑) (26.1 次要 —— AI 大脑系统变更)
- [More Entity Sound Variant Registries](detailed-primers/26.1-from-1.21.11.md#more-entity-sound-variant-registries) (26.1 minor) - [更多实体声音变种注册表](detailed-primers/26.1-from-1.21.11.md#更多实体声音变种注册表) (26.1 次要)
- [Zombie Nautilus Variant](detailed-primers/1.21.11-from-1.21.10.md#zombie-nautilus-variant) (1.21.11 minor) - [僵尸鹦鹉螺变体](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) - [GUI 渲染类型](detailed-primers/1.21.2-from-1.21.1.md#gui-渲染类型) (1.21.2)
- [The Game Test Overhaul](detailed-primers/1.21.5-from-1.21.4.md#the-game-test-overhaul) (1.21.5) - [游戏测试大修](detailed-primers/1.21.5-from-1.21.4.md#游戏测试大修) (1.21.5)
- [GUI Changes](detailed-primers/1.21.6-from-1.21.5.md#gui-changes) (1.21.6) - [GUI 变更](detailed-primers/1.21.6-from-1.21.5.md#gui-变更) (1.21.6)
- [Minor Migrations](detailed-primers/1.21.7-from-1.21.6.md#minor-migrations) (1.21.7) - [小幅迁移](detailed-primers/1.21.7-from-1.21.6.md#小幅迁移) (1.21.7)
- [The Debugging Overhaul](detailed-primers/1.21.9-from-1.21.8.md#the-debugging-overhaul) (1.21.9) - [调试大修](detailed-primers/1.21.9-from-1.21.8.md#调试大修) (1.21.9)
- [Debug Screens](detailed-primers/1.21.9-from-1.21.8.md#debug-screens) (1.21.9) - [调试屏幕](detailed-primers/1.21.9-from-1.21.8.md#调试屏幕) (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) - [JSON-RPC 管理服务器](detailed-primers/1.21.9-from-1.21.8.md#json-rpc-管理服务器) (1.21.9)
- [Input Handling Consolidation](detailed-primers/1.21.9-from-1.21.8.md#input-handling-consolidation) (1.21.9) - [输入处理整合](detailed-primers/1.21.9-from-1.21.8.md#输入处理整合) (1.21.9)
- [Cursor Types](detailed-primers/1.21.9-from-1.21.8.md#cursor-types) (1.21.9 minor) - [光标类型](detailed-primers/1.21.9-from-1.21.8.md#光标类型) (1.21.9 次要)
- [Gizmos](detailed-primers/1.21.11-from-1.21.10.md#gizmos) (1.21.11) - [Gizmo 控件](detailed-primers/1.21.11-from-1.21.10.md#gizmo-控件) (1.21.11)
- [Text Collectors](detailed-primers/1.21.11-from-1.21.10.md#text-collectors) (1.21.11 minor) - [文本收集器](detailed-primers/1.21.11-from-1.21.10.md#文本收集器) (1.21.11 次要)
- [OptionEnum Removal](detailed-primers/1.21.11-from-1.21.10.md#optionenum-removal) (1.21.11 minor) - [OptionEnum 移除](detailed-primers/1.21.11-from-1.21.10.md#optionenum-移除) (1.21.11 次要)
- [Container Screen Changes](detailed-primers/26.1-from-1.21.11.md#container-screen-changes) (26.1 minor) - [容器屏幕变更](detailed-primers/26.1-from-1.21.11.md#容器屏幕变更) (26.1 次要)
- [Input Message Editor Support](detailed-primers/26.1-from-1.21.11.md#input-message-editor-support) (26.1 minor) - [输入消息编辑器支持](detailed-primers/26.1-from-1.21.11.md#输入消息编辑器支持) (26.1 次要)
- [Test Environment State Tracking](detailed-primers/26.1-from-1.21.11.md#test-environment-state-tracking) (26.1 minor) - [测试环境状态追踪](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) - [正确处理方块实体的移除](detailed-primers/1.21.5-from-1.21.4.md#正确处理方块实体的移除) (1.21.5)
- [Voxel Shape Helpers](detailed-primers/1.21.5-from-1.21.4.md#voxel-shape-helpers) (1.21.5) - [体素形状辅助类](detailed-primers/1.21.5-from-1.21.4.md#体素形状辅助类) (1.21.5)
- [Weighted List Rework](detailed-primers/1.21.5-from-1.21.4.md#weighted-list-rework) (1.21.5) - [加权列表重做](detailed-primers/1.21.5-from-1.21.4.md#加权列表重做) (1.21.5)
- [Tickets](detailed-primers/1.21.5-from-1.21.4.md#tickets) (1.21.5) - [加载票](detailed-primers/1.21.5-from-1.21.4.md#加载票) (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) - [保存数据，现在带有类型](detailed-primers/1.21.5-from-1.21.4.md#保存数据现在带有类型) (1.21.5)
- [Block Effect Appliers](detailed-primers/1.21.5-from-1.21.4.md#block-effect-appliers) (1.21.5 minor) - [方块效果应用器](detailed-primers/1.21.5-from-1.21.4.md#方块效果应用器) (1.21.5 次要)
- [Waypoints](detailed-primers/1.21.6-from-1.21.5.md#waypoints) (1.21.6) - [路径点](detailed-primers/1.21.6-from-1.21.5.md#路径点) (1.21.6)
- [Server Player Changes](detailed-primers/1.21.6-from-1.21.5.md#server-player-changes) (1.21.6) - [服务端玩家变更](detailed-primers/1.21.6-from-1.21.5.md#服务端玩家变更) (1.21.6)
- [Permission Sources](detailed-primers/1.21.6-from-1.21.5.md#permission-sources) (1.21.6 minor) - [权限来源](detailed-primers/1.21.6-from-1.21.5.md#权限来源) (1.21.6 次要)
- [Level#isClientSide now private](detailed-primers/1.21.9-from-1.21.8.md#levelisclientside-now-private) (1.21.9) - [Level#isClientSide 现在为 private](detailed-primers/1.21.9-from-1.21.8.md#levelisclientside-现在为-private) (1.21.9)
- [Ticket Flags](detailed-primers/1.21.9-from-1.21.8.md#ticket-flags) (1.21.9 minor) - [加载票标志](detailed-primers/1.21.9-from-1.21.8.md#加载票标志) (1.21.9 次要)
- [Respawn Data](detailed-primers/1.21.9-from-1.21.8.md#respawn-data) (1.21.9 minor) - [重生数据](detailed-primers/1.21.9-from-1.21.8.md#重生数据) (1.21.9 次要)
- [Permission Overhaul](detailed-primers/1.21.11-from-1.21.10.md#permission-overhaul) (1.21.11) - [权限大修](detailed-primers/1.21.11-from-1.21.10.md#权限大修) (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) - [环境属性的时间线](detailed-primers/1.21.11-from-1.21.10.md#环境属性的时间线) (1.21.11)
- [The Game Rule Shuffle](detailed-primers/1.21.11-from-1.21.10.md#the-game-rule-shuffle) (1.21.11) - [游戏规则洗牌](detailed-primers/1.21.11-from-1.21.10.md#游戏规则洗牌) (1.21.11)
- [Level#random field now protected](detailed-primers/26.1-from-1.21.11.md#levelrandom-field-now-protected) (26.1) - [Level#random 字段现在为 protected](detailed-primers/26.1-from-1.21.11.md#levelrandom-字段现在为-protected) (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/26.1-from-1.21.11.md#世界时钟与时间标记) (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) - [将主关卡数据拆分为保存数据](detailed-primers/26.1-from-1.21.11.md#将主关卡数据拆分为保存数据) (26.1)
- [Chat Permissions](detailed-primers/26.1-from-1.21.11.md#chat-permissions) (26.1 minor) - [聊天权限](detailed-primers/26.1-from-1.21.11.md#聊天权限) (26.1 次要)
- [ChunkPos, now a record](detailed-primers/26.1-from-1.21.11.md#chunkpos-now-a-record) (26.1 minor) - [ChunkPos，现在是一个记录](detailed-primers/26.1-from-1.21.11.md#chunkpos现在是一个记录) (26.1 次要)
- [Cauldron Interaction Dispatchers](detailed-primers/26.1-from-1.21.11.md#cauldron-interaction-dispatchers) (26.1 minor) - [炼药锅交互调度器](detailed-primers/26.1-from-1.21.11.md#炼药锅交互调度器) (26.1 次要)
- [Fluid Logic Reorganization](detailed-primers/26.1-from-1.21.11.md#fluid-logic-reorganization) (26.1 minor) - [流体逻辑重组](detailed-primers/26.1-from-1.21.11.md#流体逻辑重组) (26.1 次要)
- [Removal of Random Patch Feature](detailed-primers/26.1-from-1.21.11.md#removal-of-random-patch-feature) (26.1 minor) - [移除随机斑块特征](detailed-primers/26.1-from-1.21.11.md#移除随机斑块特征) (26.1 次要)
- [Rule-Based Block State Providers](detailed-primers/26.1-from-1.21.11.md#rule-based-block-state-providers) (26.1 minor) - [基于规则的方块状态提供者](detailed-primers/26.1-from-1.21.11.md#基于规则的方块状态提供者) (26.1 次要)
- [File Fixer Upper](detailed-primers/26.1-from-1.21.11.md#file-fixer-upper) (26.1 minor) - [文件修缮工](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) - [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) - [更智能的帧率限制](detailed-primers/1.21.2-from-1.21.1.md#更智能的帧率限制) (1.21.2)
- [Orientations](detailed-primers/1.21.2-from-1.21.1.md#orientations) (1.21.2) - [朝向](detailed-primers/1.21.2-from-1.21.1.md#朝向) (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) - [移除雕刻生成步骤](detailed-primers/1.21.2-from-1.21.1.md#移除雕刻生成步骤) (1.21.2)
- [Consecutive Executors](detailed-primers/1.21.2-from-1.21.1.md#consecutive-executors) (1.21.2) - [连续执行器](detailed-primers/1.21.2-from-1.21.1.md#连续执行器) (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) - [分析器与 Tracy 客户端](detailed-primers/1.21.2-from-1.21.1.md#分析器与-tracy-客户端) (1.21.2)
- [Tick Throttler](detailed-primers/1.21.2-from-1.21.1.md#tick-throttler) (1.21.2) - [Tick节流器](detailed-primers/1.21.2-from-1.21.1.md#Tick节流器) (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) - [音乐，现在带有音量控制](detailed-primers/1.21.4-from-1.21.2-3.md#音乐现在带有音量控制) (1.21.4)
- [Descoping Player Arguments](detailed-primers/1.21.5-from-1.21.4.md#descoping-player-arguments) (1.21.5) - [解作用域玩家参数](detailed-primers/1.21.5-from-1.21.4.md#解作用域玩家参数) (1.21.5)
- [Reload Instance Creation](detailed-primers/1.21.5-from-1.21.4.md#reload-instance-creation) (1.21.5) - [重载实例创建](detailed-primers/1.21.5-from-1.21.4.md#重载实例创建) (1.21.5)
- [The JOML Backing Interfaces](detailed-primers/1.21.5-from-1.21.4.md#the-joml-backing-interfaces) (1.21.5) - [JOML 后端接口](detailed-primers/1.21.5-from-1.21.4.md#joml-后端接口) (1.21.5)
- [Mob Effects Field Renames](detailed-primers/1.21.5-from-1.21.4.md#mob-effects-field-renames) (1.21.5) - [状态效果字段重命名](detailed-primers/1.21.5-from-1.21.4.md#状态效果字段重命名) (1.21.5)
- [Reload Listener Shared State](detailed-primers/1.21.9-from-1.21.8.md#reload-listener-shared-state) (1.21.9) - [重载监听器共享状态](detailed-primers/1.21.9-from-1.21.8.md#重载监听器共享状态) (1.21.9)
- [The 'On Shelf' Transform](detailed-primers/1.21.9-from-1.21.8.md#the-on-shelf-transform) (1.21.9) - ["在架子上" 变换](detailed-primers/1.21.9-from-1.21.8.md#在架子上变换) (1.21.9)
- [Shared Text Areas Debugger](detailed-primers/1.21.11-from-1.21.10.md#shared-text-areas-debugger) (1.21.11) - [共享文本区域调试器](detailed-primers/1.21.11-from-1.21.10.md#共享文本区域调试器) (1.21.11)
- [Specific Logic Changes](detailed-primers/1.21.11-from-1.21.10.md#specific-logic-changes) (1.21.11) - [特定逻辑变更](detailed-primers/1.21.11-from-1.21.10.md#特定逻辑变更) (1.21.11)
- [Typed Instance](detailed-primers/26.1-from-1.21.11.md#typed-instance) (26.1) - [类型化实例](detailed-primers/26.1-from-1.21.11.md#类型化实例) (26.1)
- [No More Tripwire Pipelines](detailed-primers/26.1-from-1.21.11.md#no-more-tripwire-pipelines) (26.1) - [不再有绊线管线](detailed-primers/26.1-from-1.21.11.md#不再有绊线管线) (26.1)
- [Environment Attribute Additions](detailed-primers/26.1-from-1.21.11.md#environment-attribute-additions) (26.1) - [环境属性新增](detailed-primers/26.1-from-1.21.11.md#环境属性新增) (26.1)
- [Specific Logic Changes](detailed-primers/26.1-from-1.21.11.md#specific-logic-changes) (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) | | `AbstractFurnaceBlockEntity` 燃料 | 1.21.2 | [燃料值](detailed-primers/1.21.2-from-1.21.1.md#燃料值) |
| `AbstractMinecart` | 1.21.2 | [Minecart Behavior](detailed-primers/1.21.2-from-1.21.1.md#minecart-behavior) | | `AbstractMinecart` | 1.21.2 | [矿车行为](detailed-primers/1.21.2-from-1.21.1.md#矿车行为) |
| `Activities` / `Brain` | 26.1 | [Activities and Brains](detailed-primers/26.1-from-1.21.11.md#activities-and-brains) | | `Activities` / `Brain` | 26.1 | [活动与大脑](detailed-primers/26.1-from-1.21.11.md#活动与大脑) |
| `AnimationDefinition#bake` | 1.21.6 | [Animation Baking](detailed-primers/1.21.6-from-1.21.5.md#animation-baking) | | `AnimationDefinition#bake` | 1.21.6 | [动画烘焙](detailed-primers/1.21.6-from-1.21.5.md#动画烘焙) |
| `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) | | `ArmorItem` / `ArmorMaterial` | 1.21.2 | [盔甲材料、装备和模型（纹理）](detailed-primers/1.21.2-from-1.21.1.md#盔甲材料装备和模型纹理) |
| `BakedModel` / `BakedQuad` | 1.21.5 | [Model Rework](detailed-primers/1.21.5-from-1.21.4.md#model-rework) | | `BakedModel` / `BakedQuad` | 1.21.5 | [模型重做](detailed-primers/1.21.5-from-1.21.4.md#模型重做) |
| `BlockBehaviour#neighborChanged` | 1.21.2 | [Orientations](detailed-primers/1.21.2-from-1.21.1.md#orientations) | | `BlockBehaviour#neighborChanged` | 1.21.2 | [朝向](detailed-primers/1.21.2-from-1.21.1.md#朝向) |
| `BlockEntityType` constructors | 1.21.2 | [BlockEntityTypes Privatized!](detailed-primers/1.21.2-from-1.21.1.md#blockentitytypes-privatized) | | `BlockEntityType` 构造器 | 1.21.2 | [BlockEntityTypes 私有化了！](detailed-primers/1.21.2-from-1.21.1.md#blockentitytypes-私有化了) |
| `CauldronInteraction` | 26.1 | [Cauldron Interaction Dispatchers](detailed-primers/26.1-from-1.21.11.md#cauldron-interaction-dispatchers) | | `CauldronInteraction` | 26.1 | [炼药锅交互调度器](detailed-primers/26.1-from-1.21.11.md#炼药锅交互调度器) |
| `ChunkPos` (now record) | 26.1 | [ChunkPos, now a record](detailed-primers/26.1-from-1.21.11.md#chunkpos-now-a-record) | | `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) | | `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) | | 客户端物品 JSON | 1.21.4 | [客户端物品](detailed-primers/1.21.4-from-1.21.2-3.md#客户端物品) |
| `Consumable` / `ConsumableListener` | 1.21.2 | [Consumables](detailed-primers/1.21.2-from-1.21.1.md#consumables) | | `Consumable` / `ConsumableListener` | 1.21.2 | [消耗品](detailed-primers/1.21.2-from-1.21.1.md#消耗品) |
| `DataComponents` getters | 1.21.5 | [Data Component Getters](detailed-primers/1.21.5-from-1.21.4.md#data-component-getters) | | `DataComponents` 获取器 | 1.21.5 | [数据组件获取器](detailed-primers/1.21.5-from-1.21.4.md#数据组件获取器) |
| `DataComponents` new types | 1.21.11 | [New Data Components](detailed-primers/1.21.11-from-1.21.10.md#new-data-components) | | `DataComponents` 新类型 | 1.21.11 | [新数据组件](detailed-primers/1.21.11-from-1.21.10.md#新数据组件) |
| `DataComponents` initializers | 26.1 | [Data Component Initializers](detailed-primers/26.1-from-1.21.11.md#data-component-initializers) | | `DataComponents` 初始化器 | 26.1 | [数据组件初始化器](detailed-primers/26.1-from-1.21.11.md#数据组件初始化器) |
| `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) | | `DiggerItem` / `SwordItem` 移除 | 1.21.5 | [武器、工具和盔甲：去除冗余](detailed-primers/1.21.5-from-1.21.4.md#武器工具和盔甲去除冗余) |
| `DyeRecipe` / `DyeItem` | 26.1 | [Dye Component](detailed-primers/26.1-from-1.21.11.md#dye-component) | | `DyeRecipe` / `DyeItem` | 26.1 | [染料组件](detailed-primers/26.1-from-1.21.11.md#染料组件) |
| `Entity#interactAt` removal | 26.1 | [The Removal of interactAt](detailed-primers/26.1-from-1.21.11.md#the-removal-of-interactat) | | `Entity#interactAt` 移除 | 26.1 | [interactAt 的移除](detailed-primers/26.1-from-1.21.11.md#interactat-的移除) |
| `EntityReference` (replaces UUID) | 1.21.5 | [Entity References](detailed-primers/1.21.5-from-1.21.4.md#entity-references) | | `EntityReference` (取代 UUID) | 1.21.5 | [实体引用](detailed-primers/1.21.5-from-1.21.4.md#实体引用) |
| `EntityRenderState` | 1.21.2 | [Entity Render States](detailed-primers/1.21.2-from-1.21.1.md#entity-render-states) | | `EntityRenderState` | 1.21.2 | [实体渲染状态](detailed-primers/1.21.2-from-1.21.1.md#实体渲染状态) |
| `Explosion` (now interface) | 1.21.2 | [EXPLOOOOSSSION!](detailed-primers/1.21.2-from-1.21.1.md#exploooosssion) | | `Explosion` (现为接口) | 1.21.2 | [爆——炸——！](detailed-primers/1.21.2-from-1.21.1.md#爆炸) |
| `GameRules` | 1.21.11 | [The Game Rule Shuffle](detailed-primers/1.21.11-from-1.21.10.md#the-game-rule-shuffle) | | `GameRules` | 1.21.11 | [游戏规则洗牌](detailed-primers/1.21.11-from-1.21.10.md#游戏规则洗牌) |
| `GameTest` framework | 1.21.5 | [The Game Test Overhaul](detailed-primers/1.21.5-from-1.21.4.md#the-game-test-overhaul) | | `GameTest` 框架 | 1.21.5 | [游戏测试大修](detailed-primers/1.21.5-from-1.21.4.md#游戏测试大修) |
| `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) | | `GenerationStep$Carving` 移除 | 1.21.2 | [移除雕刻生成步骤](detailed-primers/1.21.2-from-1.21.1.md#移除雕刻生成步骤) |
| `GpuTexture` / `RenderPipeline` | 1.21.5 | [Render Pipeline Rework](detailed-primers/1.21.5-from-1.21.4.md#render-pipeline-rework) | | `GpuTexture` / `RenderPipeline` | 1.21.5 | [渲染管线重做](detailed-primers/1.21.5-from-1.21.4.md#渲染管线重做) |
| `GuiGraphics` / GUI rendering | 1.21.6 | [GUI Changes](detailed-primers/1.21.6-from-1.21.5.md#gui-changes) | | `GuiGraphics` / GUI 渲染 | 1.21.6 | [GUI 变更](detailed-primers/1.21.6-from-1.21.5.md#gui-变更) |
| `Holder` / `HolderSet` / `HolderGetter` | 1.21.2 | [The Holder Set Transition](detailed-primers/1.21.2-from-1.21.1.md#the-holder-set-transition) | | `Holder` / `HolderSet` / `HolderGetter` | 1.21.2 | [持有者集过渡](detailed-primers/1.21.2-from-1.21.1.md#持有者集-过渡) |
| `Identifier` (was `ResourceLocation`) | 1.21.11 | [ResourceLocation to Identifier](detailed-primers/1.21.11-from-1.21.10.md#resourcelocation-to-identifier) | | `Identifier` (原 `ResourceLocation`) | 1.21.11 | [ResourceLocation 到 Identifier](detailed-primers/1.21.11-from-1.21.10.md#resourcelocation-到-identifier) |
| `Ingredient` | 1.21.2 | [The Ingredient Shift](detailed-primers/1.21.2-from-1.21.1.md#the-ingredient-shift) | | `Ingredient` | 1.21.2 | [原料的转变](detailed-primers/1.21.2-from-1.21.1.md#原料的转变) |
| `InteractionResult` | 1.21.2 | [Interaction Results](detailed-primers/1.21.2-from-1.21.1.md#interaction-results) | | `InteractionResult` | 1.21.2 | [交互结果](detailed-primers/1.21.2-from-1.21.1.md#交互结果) |
| `ItemInstance` / `StackTemplate` | 26.1 | [Item Instances and Stack Templates](detailed-primers/26.1-from-1.21.11.md#item-instances-and-stack-templates) | | `ItemInstance` / `StackTemplate` | 26.1 | [物品实例与堆栈模板](detailed-primers/26.1-from-1.21.11.md#物品实例与堆栈模板) |
| `KeyMapping` / input events | 1.21.9 | [Input Handling Consolidation](detailed-primers/1.21.9-from-1.21.8.md#input-handling-consolidation) | | `KeyMapping` / 输入事件 | 1.21.9 | [输入处理整合](detailed-primers/1.21.9-from-1.21.8.md#输入处理整合) |
| `Leashable` | 1.21.6 | [Leashes](detailed-primers/1.21.6-from-1.21.5.md#leashes) | | `Leashable` | 1.21.6 | [拴绳](detailed-primers/1.21.6-from-1.21.5.md#拴绳) |
| `Level#isClientSide` | 1.21.9 | [Level#isClientSide now private](detailed-primers/1.21.9-from-1.21.8.md#levelisclientside-now-private) | | `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 field now protected](detailed-primers/26.1-from-1.21.11.md#levelrandom-field-now-protected) | | `Level#random` | 26.1 | [Level#random 字段现在为 protected](detailed-primers/26.1-from-1.21.11.md#levelrandom-字段现在为-protected) |
| `LootContextParam` / `LootContextParamSet` | 1.21.2 | [Context Keys](detailed-primers/1.21.2-from-1.21.1.md#context-keys) | | `LootContextParam` / `LootContextParamSet` | 1.21.2 | [上下文键](detailed-primers/1.21.2-from-1.21.1.md#上下文键) |
| `LootPoolEntry` / loot codecs | 26.1 | [Loot Type Unrolling](detailed-primers/26.1-from-1.21.11.md#loot-type-unrolling) | | `LootPoolEntry` / 战利品编解码器 | 26.1 | [战利品类型展开](detailed-primers/26.1-from-1.21.11.md#战利品类型展开) |
| `Mob#convertTo` | 1.21.2 | [Mob Conversions](detailed-primers/1.21.2-from-1.21.1.md#mob-conversions) | | `Mob#convertTo` | 1.21.2 | [生物转化](detailed-primers/1.21.2-from-1.21.1.md#生物转化) |
| `OptionEnum` removal | 1.21.11 | [OptionEnum Removal](detailed-primers/1.21.11-from-1.21.10.md#optionenum-removal) | | `OptionEnum` 移除 | 1.21.11 | [OptionEnum 移除](detailed-primers/1.21.11-from-1.21.10.md#optionenum-移除) |
| `Permission` / `PermissionSet` | 1.21.11 | [Permission Overhaul](detailed-primers/1.21.11-from-1.21.10.md#permission-overhaul) | | `Permission` / `PermissionSet` | 1.21.11 | [权限大修](detailed-primers/1.21.11-from-1.21.10.md#权限大修) |
| `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) | | `Profiler#get` (取代 `getProfiler`) | 1.21.2 | [分析器与 Tracy 客户端](detailed-primers/1.21.2-from-1.21.1.md#分析器与-tracy-客户端) |
| `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) | | `Recipe` 注册表格式 | 1.21.2 | [配方，现在采用注册表格式](detailed-primers/1.21.2-from-1.21.1.md#配方现在采用注册表格式) |
| `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) | | `RecipeDisplay` / `SlotDisplay` | 1.21.2 | [配方，现在采用注册表格式](detailed-primers/1.21.2-from-1.21.1.md#配方现在采用注册表格式) |
| `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) | | `RenderType` 洗牌 | 1.21.11 | [哦，又来了，一次渲染重写](detailed-primers/1.21.11-from-1.21.10.md#哦又来了一次渲染重写) |
| `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) | | `SavedData` / `SavedDataType` | 1.21.5 | [保存数据，现在带有类型](detailed-primers/1.21.5-from-1.21.4.md#保存数据现在带有类型) |
| `ServerExplosion` | 1.21.2 | [EXPLOOOOSSSION!](detailed-primers/1.21.2-from-1.21.1.md#exploooosssion) | | `ServerExplosion` | 1.21.2 | [爆——炸——！](detailed-primers/1.21.2-from-1.21.1.md#爆炸) |
| Shader JSON / `.vsh` / `.fsh` | 1.21.2 | [Shader Rewrites](detailed-primers/1.21.2-from-1.21.1.md#shader-rewrites) | | 着色器 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) | | `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) | | `TagProvider` 追加器 | 1.21.6 | [标签提供者：追加器重写](detailed-primers/1.21.6-from-1.21.5.md#标签提供者-追加器重写) |
| `Validatable` / `ValidationContext` | 26.1 | [Validation Overhaul](detailed-primers/26.1-from-1.21.11.md#validation-overhaul) | | `Validatable` / `ValidationContext` | 26.1 | [验证大修](detailed-primers/26.1-from-1.21.11.md#验证大修) |
| Villager trades (datapack) | 26.1 | [Datapack Villager Trades](detailed-primers/26.1-from-1.21.11.md#datapack-villager-trades) | | 村民交易（数据包） | 26.1 | [数据包村民交易](detailed-primers/26.1-from-1.21.11.md#数据包村民交易) |
| `VoxelShape` helpers | 1.21.5 | [Voxel Shape Helpers](detailed-primers/1.21.5-from-1.21.4.md#voxel-shape-helpers) | | `VoxelShape` 辅助类 | 1.21.5 | [体素形状辅助类](detailed-primers/1.21.5-from-1.21.4.md#体素形状辅助类) |
| `Waypoint` system | 1.21.6 | [Waypoints](detailed-primers/1.21.6-from-1.21.5.md#waypoints) | | `Waypoint` 系统 | 1.21.6 | [路径点](detailed-primers/1.21.6-from-1.21.5.md#路径点) |
| 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) | | 世界时钟 / 时间标记 | 26.1 | [世界时钟与时间标记](detailed-primers/26.1-from-1.21.11.md#世界时钟与时间标记) |
| 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) | | 世界数据拆分 | 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)。

10
src/SUMMARY.md
View File

@ -1,8 +1,8 @@
# Summary # 摘要
- [1.21.1 to 26.1 NeoForge Porting Guide](README.md) - [1.21.1至26.1 NeoForge迁移指南](README.md)
- [Repeatedly Changing Systems](repeatedly-changing-systems.md) - [频繁变更的系统](repeatedly-changing-systems.md)
- [Detailed Primers](detailed-primers/README.md) - [详细指引](detailed-primers/README.md)
- [1.21.1 -> 1.21.2/3](detailed-primers/1.21.2-from-1.21.1.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.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) - [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.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.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) - [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)

28
src/detailed-primers/1.21.10-from-1.21.9.md
View File

@ -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` 参数，指示实体是与方块相交还是在方块内部。

3223
src/detailed-primers/1.21.11-from-1.21.10.md
View File

File diff suppressed because it is too large Load Diff

3292
src/detailed-primers/1.21.2-from-1.21.1.md
View File

File diff suppressed because it is too large Load Diff

1382
src/detailed-primers/1.21.4-from-1.21.2-3.md
View File

File diff suppressed because it is too large Load Diff

3473
src/detailed-primers/1.21.5-from-1.21.4.md
View File

File diff suppressed because it is too large Load Diff

2284
src/detailed-primers/1.21.6-from-1.21.5.md
View File

File diff suppressed because it is too large Load Diff

46
src/detailed-primers/1.21.7-from-1.21.6.md
View File

@ -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.opengl.DirectStateAccess#copyBufferSubData` - 将一个缓冲区对象的数据存储的全部或部分复制到另一个缓冲区对象的数据存储。
- `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.pipeline.BlendFunction#INVERT` - 反转 RGB 源和目标的混合因子。Alpha 使用源的默认因子，目标使用零。
- `com.mojang.blaze3d.systems.CommandEncoder#copyToBuffer` - Copies the data store of one buffer slice to another buffer slice. - `com.mojang.blaze3d.systems.CommandEncoder#copyToBuffer` - 将一个缓冲区切片的数据存储复制到另一个缓冲区切片。
- `net.minecraft.Util#isAarch64` - Returns whether the OS architecture uses aarch64. - `net.minecraft.Util#isAarch64` - 返回操作系统架构是否使用 aarch64。
- `net.minecraft.client.gui.GuiGraphics#textHighlight` - Adds a highlighted box around the provided bounds. - `net.minecraft.client.gui.GuiGraphics#textHighlight` - 在提供的边界周围添加一个高亮框。
- `net.minecraft.client.renderer.RenderPipelines#GUI_INVERT` - A render pipeline for drawing a gui element with inverted colors. - `net.minecraft.client.renderer.RenderPipelines#GUI_INVERT` - 用于绘制具有反色效果的 GUI 元素的渲染管线。
- `net.minecraft.client.renderer.item.TrackingItemRenderState` - A render state that tracks the model sources being used to render the item stack. - `net.minecraft.client.renderer.item.TrackingItemRenderState` - 一个跟踪用于渲染物品堆栈的模型源的渲染状态。
### List of Changes ### 变更列表
- `com.mojang.blaze3d.pipeline.RenderPipeline$Builder#withColorLogic` is now deprecated - `com.mojang.blaze3d.pipeline.RenderPipeline$Builder#withColorLogic` 现已弃用
- `net.minecraft.client.gui.renderer.GuiRenderer#MIN_GUI_Z` is now private - `net.minecraft.client.gui.renderer.GuiRenderer#MIN_GUI_Z` 现在是私有的
- `net.minecraft.client.gui.render.state.GuiItemRenderState` now takes in a `TrackingItemRenderState` instead of a `ItemStackRenderState` - `net.minecraft.client.gui.render.state.GuiItemRenderState` 现在接受 `TrackingItemRenderState` 而不是 `ItemStackRenderState`
- `itemStackRenderState` now returns a `TrackingItemRenderState` - `itemStackRenderState` 现在返回 `TrackingItemRenderState`
- `net.minecraft.client.renderer.RenderPipelines#GUI_TEXT_HIGHLIGHT` now uses the `ADDITIVE` blend function instead of the `OR_REVERSE` color logic - `net.minecraft.client.renderer.RenderPipelines#GUI_TEXT_HIGHLIGHT` 现在使用 `ADDITIVE` 混合函数而不是 `OR_REVERSE` 颜色逻辑
- `net.minecraft.client.renderer.item.ItemStackRenderState#getModelIdentity` -> `TrackingItemRenderState#getModelIdentity` - `net.minecraft.client.renderer.item.ItemStackRenderState#getModelIdentity` -> `TrackingItemRenderState#getModelIdentity`
### List of Removals ### 移除列表
- `net.minecraft.client.renderer.item.ItemStackRenderState#clearModelIdentity` - `net.minecraft.client.renderer.item.ItemStackRenderState#clearModelIdentity`

20
src/detailed-primers/1.21.8-from-1.21.7.md
View File

@ -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` - 一个用于解决特定图形硬件问题的辅助工具。

3472
src/detailed-primers/1.21.9-from-1.21.8.md
View File

File diff suppressed because it is too large Load Diff

5277
src/detailed-primers/26.1-from-1.21.11.md
View File

File diff suppressed because it is too large Load Diff

188
src/detailed-primers/README.md
View File

@ -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 ## 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) - [资源包变更](1.21.2-from-1.21.1.md#资源包变更)
- [The Holder Set Transition](1.21.2-from-1.21.1.md#the-holder-set-transition) - [持有者集过渡](1.21.2-from-1.21.1.md#持有者集-过渡)
- [Gui Render Types](1.21.2-from-1.21.1.md#gui-render-types) - [GUI 渲染类型](1.21.2-from-1.21.1.md#gui-渲染类型)
- [Shader Rewrites](1.21.2-from-1.21.1.md#shader-rewrites) - [着色器重写](1.21.2-from-1.21.1.md#着色器重写)
- [Entity Render States](1.21.2-from-1.21.1.md#entity-render-states) - [实体渲染状态](1.21.2-from-1.21.1.md#实体渲染状态)
- [Equipments and Items, Models and All](1.21.2-from-1.21.1.md#equipments-and-items-models-and-all) - [装备与物品、模型等等](1.21.2-from-1.21.1.md#装备与物品-模型等等)
- [Armor Materials, Equipment, and Model (Textures)](1.21.2-from-1.21.1.md#armor-materials-equipment-and-model-textures) - [盔甲材料、装备和模型（纹理）](1.21.2-from-1.21.1.md#盔甲材料-装备和模型纹理)
- [Interaction Results](1.21.2-from-1.21.1.md#interaction-results) - [交互结果](1.21.2-from-1.21.1.md#交互结果)
- [Instruments, the Datapack Edition](1.21.2-from-1.21.1.md#instruments-the-datapack-edition) - [乐器，数据包版](1.21.2-from-1.21.1.md#乐器-数据包版)
- [Trial Spawner Configurations, now in Datapack Form](1.21.2-from-1.21.1.md#trial-spawner-configurations-now-in-datapack-form) - [试炼刷怪笼配置，现在采用数据包形式](1.21.2-from-1.21.1.md#试炼刷怪笼配置-现在采用数据包形式)
- [Recipe Providers, the 'not actually' of Data Providers](1.21.2-from-1.21.1.md#recipe-providers-the-not-actually-of-data-providers) - [配方提供者，数据提供者的“并非真正”](1.21.2-from-1.21.1.md#配方提供者-数据提供者的并非真正)
- [The Ingredient Shift](1.21.2-from-1.21.1.md#the-ingredient-shift) - [原料的转变](1.21.2-from-1.21.1.md#原料的转变)
- [BlockEntityTypes Privatized!](1.21.2-from-1.21.1.md#blockentitytypes-privatized) - [BlockEntityTypes 私有化了！](1.21.2-from-1.21.1.md#blockentitytypes-私有化)
- [Consumables](1.21.2-from-1.21.1.md#consumables) - [消耗品](1.21.2-from-1.21.1.md#消耗品)
- [Registry Objcet Id, in the Properties?](1.21.2-from-1.21.1.md#registry-objcet-id-in-the-properties) - [注册表对象 ID，在属性里？](1.21.2-from-1.21.1.md#注册表对象-id-在属性里)
- [Properties Changes](1.21.2-from-1.21.1.md#properties-changes) - [属性变更](1.21.2-from-1.21.1.md#属性变更)
- [Recipes, now in Registry format](1.21.2-from-1.21.1.md#recipes-now-in-registry-format) - [配方，现在采用注册表格式](1.21.2-from-1.21.1.md#配方-现在采用注册表格式)
- [Minor Migrations](1.21.2-from-1.21.1.md#minor-migrations) - [小幅迁移](1.21.2-from-1.21.1.md#小幅-迁移)
## 1.21.2/3 -> 1.21.4 ## 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) - [资源包变更](1.21.4-from-1.21.2-3.md#资源包变更)
- [Client Items](1.21.4-from-1.21.2-3.md#client-items) - [客户端物品](1.21.4-from-1.21.2-3.md#客户端-物品)
- [Mob Replacing Current Items](1.21.4-from-1.21.2-3.md#mob-replacing-current-items) - [生物替换当前物品](1.21.4-from-1.21.2-3.md#生物-替换当前物品)
- [Particles, rendered through Render Types](1.21.4-from-1.21.2-3.md#particles-rendered-through-render-types) - [粒子，通过渲染类型渲染](1.21.4-from-1.21.2-3.md#粒子-通过渲染类型渲染)
- [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 -> 1.21.5 ## 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) - [资源包变更](1.21.5-from-1.21.4.md#资源包变更)
- [Handling the Removal of Block Entities Properly](1.21.5-from-1.21.4.md#handling-the-removal-of-block-entities-properly) - [正确处理方块实体的移除](1.21.5-from-1.21.4.md#正确处理方块实体的移除)
- [Voxel Shape Helpers](1.21.5-from-1.21.4.md#voxel-shape-helpers) - [体素形状辅助类](1.21.5-from-1.21.4.md#体素形状辅助类)
- [Weapons, Tools, and Armor: Removing the Redundancies](1.21.5-from-1.21.4.md#weapons-tools-and-armor-removing-the-redundancies) - [武器、工具和盔甲：去除冗余](1.21.5-from-1.21.4.md#武器工具和盔甲-去除冗余)
- [Weighted List Rework](1.21.5-from-1.21.4.md#weighted-list-rework) - [加权列表重做](1.21.5-from-1.21.4.md#加权列表重做)
- [Tickets](1.21.5-from-1.21.4.md#tickets) - [加载票](1.21.5-from-1.21.4.md#加载票)
- [The Game Test Overhaul](1.21.5-from-1.21.4.md#the-game-test-overhaul) - [游戏测试大修](1.21.5-from-1.21.4.md#游戏测试-大修)
- [Data Component Getters](1.21.5-from-1.21.4.md#data-component-getters) - [数据组件获取器](1.21.5-from-1.21.4.md#数据组件-获取器)
- [Tags and Parsing](1.21.5-from-1.21.4.md#tags-and-parsing) - [标签与解析](1.21.5-from-1.21.4.md#标签与解析)
- [Saved Data, now with Types](1.21.5-from-1.21.4.md#saved-data-now-with-types) - [保存数据，现在带有类型](1.21.5-from-1.21.4.md#保存数据-现在带有类型)
- [Render Pipeline Rework](1.21.5-from-1.21.4.md#render-pipeline-rework) - [渲染管线重做](1.21.5-from-1.21.4.md#渲染管线重做)
- [Model Rework](1.21.5-from-1.21.4.md#model-rework) - [模型重做](1.21.5-from-1.21.4.md#模型-重做)
- [Minor Migrations](1.21.5-from-1.21.4.md#minor-migrations) - [小幅迁移](1.21.5-from-1.21.4.md#小幅-迁移)
## 1.21.5 -> 1.21.6 ## 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) - [资源包变更](1.21.6-from-1.21.5.md#资源包变更)
- [GUI Changes](1.21.6-from-1.21.5.md#gui-changes) - [GUI 变更](1.21.6-from-1.21.5.md#gui-变更)
- [Waypoints](1.21.6-from-1.21.5.md#waypoints) - [路径点](1.21.6-from-1.21.5.md#路径点)
- [Blaze3d Changes](1.21.6-from-1.21.5.md#blaze3d-changes) - [Blaze3d 变更](1.21.6-from-1.21.5.md#blaze3d-变更)
- [Tag Providers: Appender Rewrite](1.21.6-from-1.21.5.md#tag-providers-appender-rewrite) - [标签提供者：追加器重写](1.21.6-from-1.21.5.md#标签提供者-追加器重写)
- [Generic Encoding and Decoding: Replacing Direct NBT Access](1.21.6-from-1.21.5.md#generic-encoding-and-decoding-replacing-direct-nbt-access) - [通用编码与解码：替换直接 NBT 访问](1.21.6-from-1.21.5.md#通用编码与解码-替换直接-nbt-访问)
- [Server Player Changes](1.21.6-from-1.21.5.md#server-player-changes) - [服务端玩家变更](1.21.6-from-1.21.5.md#服务端玩家变更)
- [Minor Migrations](1.21.6-from-1.21.5.md#minor-migrations) - [小幅迁移](1.21.6-from-1.21.5.md#小幅-迁移)
## 1.21.6 -> 1.21.7 ## 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) - [资源包变更](1.21.7-from-1.21.6.md#资源包变更)
- [Minor Migrations](1.21.7-from-1.21.6.md#minor-migrations) - [小幅迁移](1.21.7-from-1.21.6.md#小幅-迁移)
## 1.21.7 -> 1.21.8 ## 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) - [资源包变更](1.21.8-from-1.21.7.md#资源包变更)
- [Minor Migrations](1.21.8-from-1.21.7.md#minor-migrations) - [小幅迁移](1.21.8-from-1.21.7.md#小幅-迁移)
## 1.21.8 -> 1.21.9 ## 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) - [资源包变更](1.21.9-from-1.21.8.md#资源包变更)
- [The Debugging Overhaul](1.21.9-from-1.21.8.md#the-debugging-overhaul) - [调试大修](1.21.9-from-1.21.8.md#调试-大修)
- [Debug Screens](1.21.9-from-1.21.8.md#debug-screens) - [调试屏幕](1.21.9-from-1.21.8.md#调试-屏幕)
- [Feature Submissions: The Movie](1.21.9-from-1.21.8.md#feature-submissions-the-movie) - [功能提交：电影版](1.21.9-from-1.21.8.md#功能提交-电影版)
- [The Font Glyph Pipeline](1.21.9-from-1.21.8.md#the-font-glyph-pipeline) - [字体字形管线](1.21.9-from-1.21.8.md#字体-字形-管线)
- [The JSON-RPC Management Servers](1.21.9-from-1.21.8.md#the-json-rpc-management-servers) - [JSON-RPC 管理服务器](1.21.9-from-1.21.8.md#json-rpc-管理服务器)
- [Input Handling Consolidation](1.21.9-from-1.21.8.md#input-handling-consolidation) - [输入处理整合](1.21.9-from-1.21.8.md#输入处理整合)
- [`Level#isClientSide` now private](1.21.9-from-1.21.8.md#levelisclientside-now-private) - [`Level#isClientSide` 现在为 private](1.21.9-from-1.21.8.md#levelisclientside-现在为-private)
- [Minor Migrations](1.21.9-from-1.21.8.md#minor-migrations) - [小幅迁移](1.21.9-from-1.21.8.md#小幅-迁移)
## 1.21.9 -> 1.21.10 ## 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) - [资源包变更](1.21.10-from-1.21.9.md#资源包变更)
- [Minor Migrations](1.21.10-from-1.21.9.md#minor-migrations) - [小幅迁移](1.21.10-from-1.21.9.md#小幅-迁移)
## 1.21.10 -> 1.21.11 ## 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) - [资源包变更](1.21.11-from-1.21.10.md#资源包变更)
- [The Rename Shuffle](1.21.11-from-1.21.10.md#the-rename-shuffle) - [重命名混乱](1.21.11-from-1.21.10.md#重命名混乱)
- [Oh Hey, Another Rendering Rewrite](1.21.11-from-1.21.10.md#oh-hey-another-rendering-rewrite) - [哦，又来了，一次渲染重写](1.21.11-from-1.21.10.md#哦又来了-一次渲染重写)
- [Gizmos](1.21.11-from-1.21.10.md#gizmos) - [Gizmo 控件](1.21.11-from-1.21.10.md#gizmo-控件)
- [Permission Overhaul](1.21.11-from-1.21.10.md#permission-overhaul) - [权限大修](1.21.11-from-1.21.10.md#权限-大修)
- [New Data Components](1.21.11-from-1.21.10.md#new-data-components) - [新数据组件](1.21.11-from-1.21.10.md#新数据组件)
- [The Timeline of Environment Attributes](1.21.11-from-1.21.10.md#the-timeline-of-environment-attributes) - [环境属性的时间线](1.21.11-from-1.21.10.md#环境属性的时间线)
- [The Game Rule Shuffle](1.21.11-from-1.21.10.md#the-game-rule-shuffle) - [游戏规则洗牌](1.21.11-from-1.21.10.md#游戏规则洗牌)
- [Minor Migrations](1.21.11-from-1.21.10.md#minor-migrations) - [小幅迁移](1.21.11-from-1.21.10.md#小幅-迁移)
## 1.21.11 -> 26.1 ## 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) - [资源包变更](26.1-from-1.21.11.md#资源包变更)
- [Java 25 and Deobfuscation](26.1-from-1.21.11.md#java-25-and-deobfuscation) - [Java 25 与反混淆](26.1-from-1.21.11.md#java-25-与反混淆)
- [Loot Type Unrolling](26.1-from-1.21.11.md#loot-type-unrolling) - [战利品类型展开](26.1-from-1.21.11.md#战利品类型-展开)
- [Validation Overhaul](26.1-from-1.21.11.md#validation-overhaul) - [验证大修](26.1-from-1.21.11.md#验证-大修)
- [Datapack Villager Trades](26.1-from-1.21.11.md#datapack-villager-trades) - [数据包村民交易](26.1-from-1.21.11.md#数据包村民交易)
- [`Level#random` field now protected](26.1-from-1.21.11.md#levelrandom-field-now-protected) - [`Level#random` 字段现在为 protected](26.1-from-1.21.11.md#levelrandom-字段现在为-protected)
- [Data Component Initializers](26.1-from-1.21.11.md#data-component-initializers) - [数据组件初始化器](26.1-from-1.21.11.md#数据组件-初始化器)
- [Item Instances and Stack Templates](26.1-from-1.21.11.md#item-instances-and-stack-templates) - [物品实例与堆栈模板](26.1-from-1.21.11.md#物品实例与堆栈模板)
- [Serializer Records and Recipe Info](26.1-from-1.21.11.md#serializer-records-and-recipe-info) - [序列化器记录与配方信息](26.1-from-1.21.11.md#序列化器记录与配方信息)
- [Dye Component](26.1-from-1.21.11.md#dye-component) - [染料组件](26.1-from-1.21.11.md#染料组件)
- [World Clocks and Time Markers](26.1-from-1.21.11.md#world-clocks-and-time-markers) - [世界时钟与时间标记](26.1-from-1.21.11.md#世界时钟与时间标记)
- [Splitting the Primary Level Data into Saved Data](26.1-from-1.21.11.md#splitting-the-primary-level-data-into-saved-data) - [将主关卡数据拆分为保存数据](26.1-from-1.21.11.md#将主关卡数据拆分为保存数据)
- [Even More Rendering Changes](26.1-from-1.21.11.md#even-more-rendering-changes) - [更多渲染变更](26.1-from-1.21.11.md#更多渲染变更)
- [Minor Migrations](26.1-from-1.21.11.md#minor-migrations) - [小幅迁移](26.1-from-1.21.11.md#小幅-迁移)

230
src/repeatedly-changing-systems.md
View File

@ -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) - [GUI 渲染类型](detailed-primers/1.21.2-from-1.21.1.md#gui-渲染类型) (1.21.2)
- [Shader Rewrites](detailed-primers/1.21.2-from-1.21.1.md#shader-rewrites) (1.21.2) - [着色器重写](detailed-primers/1.21.2-from-1.21.1.md#着色器重写) (1.21.2)
- [Entity Render States](detailed-primers/1.21.2-from-1.21.1.md#entity-render-states) (1.21.2) - [实体渲染状态](detailed-primers/1.21.2-from-1.21.1.md#实体渲染状态) (1.21.2)
- [Render Pipeline Rework](detailed-primers/1.21.5-from-1.21.4.md#render-pipeline-rework) (1.21.5) - [渲染管线重做](detailed-primers/1.21.5-from-1.21.4.md#渲染管线重做) (1.21.5)
- [Model Rework](detailed-primers/1.21.5-from-1.21.4.md#model-rework) (1.21.5) - [模型重做](detailed-primers/1.21.5-from-1.21.4.md#模型重做) (1.21.5)
- [GUI Changes](detailed-primers/1.21.6-from-1.21.5.md#gui-changes) (1.21.6) - [GUI 变更](detailed-primers/1.21.6-from-1.21.5.md#gui-变更) (1.21.6)
- [Blaze3d Changes](detailed-primers/1.21.6-from-1.21.5.md#blaze3d-changes) (1.21.6) - [Blaze3d 变更](detailed-primers/1.21.6-from-1.21.5.md#blaze3d-变更) (1.21.6)
- [Minor Migrations](detailed-primers/1.21.7-from-1.21.6.md#minor-migrations) (1.21.7) - [小幅迁移](detailed-primers/1.21.7-from-1.21.6.md#小幅迁移) (1.21.7)
- [Feature Submissions: The Movie](detailed-primers/1.21.9-from-1.21.8.md#feature-submissions-the-movie) (1.21.9) - [功能提交：电影版](detailed-primers/1.21.9-from-1.21.8.md#功能提交电影版) (1.21.9)
- [The Font Glyph Pipeline](detailed-primers/1.21.9-from-1.21.8.md#the-font-glyph-pipeline) (1.21.9) - [字体 字形 管线](detailed-primers/1.21.9-from-1.21.8.md#字体-字形-管线) (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) - [哦，又来了，一次渲染重写](detailed-primers/1.21.11-from-1.21.10.md#哦又来了一次渲染重写) (1.21.11)
- [Even More Rendering Changes](detailed-primers/26.1-from-1.21.11.md#even-more-rendering-changes) (26.1) - [更多渲染变更](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.2/3` 修改了 GUI 贴图混合、着色器 JSON 结构以及渲染状态假设。
- `1.21.5` is the first large rendering infrastructure rewrite around `RenderPipeline`, `GpuTexture`, and render passes. - `1.21.5` 是第一次大型渲染基础设施重写，围绕 `RenderPipeline`、`GpuTexture` 和渲染通道展开。
- `1.21.6` changes GUI rendering flow again through prepare/render state separation. - `1.21.6` 通过准备/渲染状态分离再次修改了 GUI 渲染流程。
- `1.21.9` changes how features are submitted for rendering. - `1.21.9` 修改了功能提交到渲染的方式。
- `1.21.11` changes samplers, render types, terrain split, and atlases. - `1.21.11` 修改了采样器、渲染类型、地形拆分和纹理图集。
- `26.1` is the final authority for block/item rendering, materials, tint sources, fluid models, particle layers, and backend-facing rendering APIs. - `26.1` 是方块/物品渲染、材质、染色源、流体模型、粒子层以及面向后端的渲染 API 的最终权威。
Practical rule: 实用规则：
- Treat `26.1` as the final rendering target. - 将 `26.1` 视为最终的渲染目标。
- Keep `1.21.4` client items and `1.21.6` GUI flow as still-active requirements, not obsolete history. - 保留 `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) - [客户端物品](detailed-primers/1.21.4-from-1.21.2-3.md#客户端物品) (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) - [生物替换当前物品](detailed-primers/1.21.4-from-1.21.2-3.md#生物-替换当前物品) (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) - [粒子，通过渲染类型渲染](detailed-primers/1.21.4-from-1.21.2-3.md#粒子通过渲染类型渲染) (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) - [武器、工具和盔甲：去除冗余](detailed-primers/1.21.5-from-1.21.4.md#武器工具和盔甲去除冗余) (1.21.5)
- [Data Component Getters](detailed-primers/1.21.5-from-1.21.4.md#data-component-getters) (1.21.5) - [数据组件获取器](detailed-primers/1.21.5-from-1.21.4.md#数据组件获取器) (1.21.5)
- [Feature Submissions: The Movie](detailed-primers/1.21.9-from-1.21.8.md#feature-submissions-the-movie) (1.21.9) - [功能提交：电影版](detailed-primers/1.21.9-from-1.21.8.md#功能提交电影版) (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) - [哦，又来了，一次渲染重写](detailed-primers/1.21.11-from-1.21.10.md#哦又来了一次渲染重写) (1.21.11)
- [New Data Components](detailed-primers/1.21.11-from-1.21.10.md#new-data-components) (1.21.11) - [新数据组件](detailed-primers/1.21.11-from-1.21.10.md#新数据组件) (1.21.11)
- [Data Component Initializers](detailed-primers/26.1-from-1.21.11.md#data-component-initializers) (26.1) - [数据组件初始化器](detailed-primers/26.1-from-1.21.11.md#数据组件初始化器) (26.1)
- [Item Instances and Stack Templates](detailed-primers/26.1-from-1.21.11.md#item-instances-and-stack-templates) (26.1) - [物品实例与堆栈模板](detailed-primers/26.1-from-1.21.11.md#物品实例与堆栈模板) (26.1)
- [Dye Component](detailed-primers/26.1-from-1.21.11.md#dye-component) (26.1) - [染料组件](detailed-primers/26.1-from-1.21.11.md#染料组件) (26.1)
- [Even More Rendering Changes](detailed-primers/26.1-from-1.21.11.md#even-more-rendering-changes) (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.4` 客户端物品是物品渲染数据的基线。
- `1.21.5` removes more hardcoded item-class assumptions in favor of components and equipment data. - `1.21.5` 移除了更多硬编码的物品类假设，改用组件和装备数据。
- `1.21.9`, `1.21.11`, and `26.1` further change how items participate in rendering and metadata pipelines. - `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) - [持有者集过渡](detailed-primers/1.21.2-from-1.21.1.md#持有者集-过渡) (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) - [注册表对象 ID，在属性里？](detailed-primers/1.21.2-from-1.21.1.md#注册表对象-id在属性里) (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) - [配方，现在采用注册表格式](detailed-primers/1.21.2-from-1.21.1.md#配方现在采用注册表格式) (1.21.2)
- [Tags and Parsing](detailed-primers/1.21.5-from-1.21.4.md#tags-and-parsing) (1.21.5) - [标签与解析](detailed-primers/1.21.5-from-1.21.4.md#标签与解析) (1.21.5)
- [Tag Providers: Appender Rewrite](detailed-primers/1.21.6-from-1.21.5.md#tag-providers-appender-rewrite) (1.21.6) - [TagAppender 重写](detailed-primers/1.21.6-from-1.21.5.md#TagAppender-重写) (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) - [通用编码与解码：替换直接 NBT 访问](detailed-primers/1.21.6-from-1.21.5.md#通用编码与解码替换直接-nbt-访问) (1.21.6)
- [The Rename Shuffle](detailed-primers/1.21.11-from-1.21.10.md#the-rename-shuffle) (1.21.11) - [重命名混乱](detailed-primers/1.21.11-from-1.21.10.md#重命名混乱) (1.21.11)
- [Loot Type Unrolling](detailed-primers/26.1-from-1.21.11.md#loot-type-unrolling) (26.1) - [战利品类型展开](detailed-primers/26.1-from-1.21.11.md#战利品类型展开) (26.1)
- [Validation Overhaul](detailed-primers/26.1-from-1.21.11.md#validation-overhaul) (26.1) - [验证大修](detailed-primers/26.1-from-1.21.11.md#验证大修) (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/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.2/3` 是 `Holder` 和 `HolderSet` 开始影响代码库大部分内容的版本。
- `1.21.5` changes tag access, parser behavior, codec-based reads and writes, and saved-data construction. - `1.21.5` 修改了标签访问、解析器行为、基于编解码器的读写以及保存数据的构造。
- `1.21.6` changes tag provider building and nudges more code toward generic encoding and decoding. - `1.21.6` 修改了标签提供者的构建方式，并推动更多代码转向通用编码和解码。
- `1.21.11` contributes rename churn that affects registry and identifier-facing code. - `1.21.11` 带来了重命名的变动，影响注册表和标识符相关的代码。
- `26.1` finalizes more codec-driven infrastructure with loot type unrolling and validation overhaul. - `26.1` 通过战利品类型展开和验证大修最终确定了更多基于编解码器的基础设施。
Practical rule: 实用规则：
- The earlier chapters tell you how to get onto holder- and codec-based APIs. - 前面的章节告诉您如何迁移到基于持有者和编解码器的 API。
- `26.1` is the final target for validation and loot registration shape. - `26.1` 是验证和战利品注册形式的最终目标。
## Data components ## 数据组件
Relevant sections: 相关章节：
- [Consumables](detailed-primers/1.21.2-from-1.21.1.md#consumables) (1.21.2) - [消耗品](detailed-primers/1.21.2-from-1.21.1.md#消耗品) (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) - [装备与物品、模型等等](detailed-primers/1.21.2-from-1.21.1.md#装备与物品模型等等) (1.21.2)
- [The Ingredient Shift](detailed-primers/1.21.2-from-1.21.1.md#the-ingredient-shift) (1.21.2) - [原料的转变](detailed-primers/1.21.2-from-1.21.1.md#原料的转变) (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) - [配方，现在采用注册表格式](detailed-primers/1.21.2-from-1.21.1.md#配方现在采用注册表格式) (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) - [武器、工具和盔甲：去除冗余](detailed-primers/1.21.5-from-1.21.4.md#武器工具和盔甲去除冗余) (1.21.5)
- [Data Component Getters](detailed-primers/1.21.5-from-1.21.4.md#data-component-getters) (1.21.5) - [数据组件获取器](detailed-primers/1.21.5-from-1.21.4.md#数据组件获取器) (1.21.5)
- [New Data Components](detailed-primers/1.21.11-from-1.21.10.md#new-data-components) (1.21.11) - [新数据组件](detailed-primers/1.21.11-from-1.21.10.md#新数据组件) (1.21.11)
- [Data Component Initializers](detailed-primers/26.1-from-1.21.11.md#data-component-initializers) (26.1) - [数据组件初始化器](detailed-primers/26.1-from-1.21.11.md#数据组件初始化器) (26.1)
- [Dye Component](detailed-primers/26.1-from-1.21.11.md#dye-component) (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.2/3` 引入了重要的组件相关迁移，例如消耗品和配方相关数据的移动。
- `1.21.5` expands component-centered behavior for tools, armor, weapons, and general data access. - `1.21.5` 扩展了以组件为中心的工具、盔甲、武器以及通用数据访问行为。
- `1.21.11` adds more component types. - `1.21.11` 添加了更多组件类型。
- `26.1` continues with initializers, dye components, and more component additions. - `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) - [保存数据，现在带有类型](detailed-primers/1.21.5-from-1.21.4.md#保存数据现在带有类型) (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) - [将主关卡数据拆分为保存数据](detailed-primers/26.1-from-1.21.11.md#将主关卡数据拆分为保存数据) (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/26.1-from-1.21.11.md#世界时钟与时间标记) (26.1)
What sticks: 哪些内容留存下来：
- `1.21.5` moves saved data to `SavedDataType`. - `1.21.5` 将保存数据迁移到 `SavedDataType`。
- `26.1` splits primary level data further into dedicated saved-data objects. - `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) - [游戏测试大修](detailed-primers/1.21.5-from-1.21.4.md#游戏测试大修) (1.21.5)
- [The Debugging Overhaul](detailed-primers/1.21.9-from-1.21.8.md#the-debugging-overhaul) (1.21.9) - [调试大修](detailed-primers/1.21.9-from-1.21.8.md#调试大修) (1.21.9)
- [Debug Screens](detailed-primers/1.21.9-from-1.21.8.md#debug-screens) (1.21.9) - [调试屏幕](detailed-primers/1.21.9-from-1.21.8.md#调试屏幕) (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) - [JSON-RPC 管理服务器](detailed-primers/1.21.9-from-1.21.8.md#json-rpc-管理服务器) (1.21.9)
- [Permission Overhaul](detailed-primers/1.21.11-from-1.21.10.md#permission-overhaul) (1.21.11) - [权限大修](detailed-primers/1.21.11-from-1.21.10.md#权限大修) (1.21.11)
- [Gizmos](detailed-primers/1.21.11-from-1.21.10.md#gizmos) (1.21.11) - [Gizmo 控件](detailed-primers/1.21.11-from-1.21.10.md#gizmo-控件) (1.21.11)
- [Java 25 and Deobfuscation](detailed-primers/26.1-from-1.21.11.md#java-25-and-deobfuscation) (26.1) - [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.5` 大修了游戏测试。
- `1.21.9` overhauls debugging and management-server shape. - `1.21.9` 大修了调试和管理服务器的形态。
- `1.21.11` adds a permission overhaul and gizmo-focused visualization work. - `1.21.11` 添加了权限大修和以 gizmo 为中心的可视化工作。
- `26.1` adds Java 25 and more minor tooling-facing changes. - `26.1` 添加了 Java 25 以及更多面向工具的小改动。
Practical rule: 实用规则：
- Port gameplay code first. - 先移植游戏玩法代码。
- Then re-enable your debug, test, and operator-only tooling against the later chapters. - 然后根据后续章节重新启用您的调试、测试和仅限操作员的工具。

31
src/source-and-attribution.md
View File

@ -1,14 +1,14 @@
# Source And Attribution # 来源与归属声明
This docs tree was assembled from the upstream primers in: 本文档树由以下上游迁移指南汇编而成：
- Repository: `https://github.com/ChampionAsh5357/neoforged-github` - 代码库：`https://github.com/ChampionAsh5357/neoforged-github`
- Branch: `update/26.1` - 分支：`update/26.1`
- Primer root: `primers/` - 指南根目录：`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.1 -> 1.21.2/3`
- `1.21.2/3 -> 1.21.4` - `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.10 -> 1.21.11`
- `1.21.11 -> 26.1` - `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`. - `1.12 - 1.15`版本迁移指南由`@williewillus`编写
- Primers for versions `1.16 - 1.17` were written by `@50ap5ud5`. - `1.16 - 1.17`版本迁移指南由`@50ap5ud5`编写
- All newer primers, including the ones used here, were written by `@ChampionAsh5357`. - 所有新版指南（包括本文采用的）均由`@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/README.md`
- `repo/primers/LICENSE-CHAMPIONASH5357` - `repo/primers/LICENSE-CHAMPIONASH5357`