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

Restructure site for usability

Browse Source 
- Add anchor links to every section reference across README,
  repeatedly-changing-systems, and detailed-primers index
- Add Quick-Scan Class/Method Index table for compile-error lookup
- Add Entities/mobs/mob AI topic section to the topic map
- Surface all Minor Migrations subsections individually
- Nest primer pages under Detailed Primers in sidebar
- Enable search
- Replace CSS with cleaner dark theme (system fonts, GitHub palette)
- Remove direct-port-guide.md (21k line inlined primer merge)
- Remove duplicate Google Fonts import from head.hbs
This commit is contained in:
Leclowndu93150 2026-03-15 20:14:48 +01:00
parent df0165537f
commit 7bf7ee6fe6
8 changed files with 731 additions and 22050 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
book.toml
View File

@ -15,4 +15,4 @@ no-section-label = true
additional-css = ["theme/gitbook.css"]
[output.html.search]
enable = false
enable = true

478
src/README.md
View File

@ -1,285 +1,271 @@
# 1.21.1 to 26.1 NeoForge Porting GitBook
# 1.21.1 to 26.1 NeoForge Porting Guide
This GitBook is organized around two goals:
1. Keep every upstream primer page available on its own.
2. Make the main page a topic map so you can jump straight to the primers that matter for a subsystem, workflow, or type of breakage.
This site indexes the upstream NeoForge porting primers so you can jump straight to the section that matters.
The upstream chain covered here is:
`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 is the upstream `1.21.1 -> 1.21.2/3` step and is treated that way here.
There is no separate `1.21.3` primer upstream. The `1.21.2` primer covers the `1.21.1 -> 1.21.2/3` step.
## How to use this GitBook
## How to use this site
If you already know the kind of change you are looking for, use the topic map below.
**If you know what subsystem changed**, use the [Topic Map](#topic-map) below. Every link goes directly to the relevant section.
If you want a short compiled overview first, use:
**If the same subsystem changed across multiple versions**, see [Repeatedly Changing Systems](repeatedly-changing-systems.md) for the reading order.
- [Compiled Direct Port Guide](direct-port-guide.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.
If you want the raw primers as separate pages, use:
**If you have a compile error**, use the [Class and Method Index](#class-and-method-index) to find where it changed.
- [Detailed Primers](detailed-primers/README.md)
If you want a quick view of which subsystems changed repeatedly across multiple versions, use:
- [Repeatedly Changing Systems](repeatedly-changing-systems.md)
---
## Topic Map
### Build, mappings, names, imports, and package moves
**Build, mappings, names, imports, and package moves**
For Java version bumps, deobfuscation, `ResourceLocation` to `Identifier`, utility-package moves, `critereon` to `criterion`, and large import/package shuffles, go to:
- [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)
- [1.21.10 -> 1.21.11](detailed-primers/1.21.11-from-1.21.10.md): `The Rename Shuffle`
- [1.21.11 -> 26.1](detailed-primers/26.1-from-1.21.11.md): `Java 25 and Deobfuscation`
- [1.21.10 -> 1.21.11](detailed-primers/1.21.11-from-1.21.10.md): `Minor Migrations`
- [1.21.11 -> 26.1](detailed-primers/26.1-from-1.21.11.md): `Minor Migrations`
**Datagen, packs, registries, tags, codecs, loot, validation, and recipe serialization**
### 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)
For holder sets, ingredients, recipe registry changes, datapack-facing systems, tag/provider rewrites, generic encoding, loot codec registration, validation, and serializer structure changes, go to:
**Items, components, equipment, armor, tools, combat, dyes, and consumables**
- [1.21.1 -> 1.21.2/3](detailed-primers/1.21.2-from-1.21.1.md): `Pack Changes`
- [1.21.1 -> 1.21.2/3](detailed-primers/1.21.2-from-1.21.1.md): `The Holder Set Transition`
- [1.21.1 -> 1.21.2/3](detailed-primers/1.21.2-from-1.21.1.md): `Instruments, the Datapack Edition`
- [1.21.1 -> 1.21.2/3](detailed-primers/1.21.2-from-1.21.1.md): `Trial Spawner Configurations, now in Datapack Form`
- [1.21.1 -> 1.21.2/3](detailed-primers/1.21.2-from-1.21.1.md): `Recipe Providers, the 'not actually' of Data Providers`
- [1.21.1 -> 1.21.2/3](detailed-primers/1.21.2-from-1.21.1.md): `The Ingredient Shift`
- [1.21.1 -> 1.21.2/3](detailed-primers/1.21.2-from-1.21.1.md): `Recipes, now in Registry format`
- [1.21.4 -> 1.21.5](detailed-primers/1.21.5-from-1.21.4.md): `Tags and Parsing`
- [1.21.4 -> 1.21.5](detailed-primers/1.21.5-from-1.21.4.md): `Model Rework`
- [1.21.5 -> 1.21.6](detailed-primers/1.21.6-from-1.21.5.md): `Tag Providers: Appender Rewrite`
- [1.21.5 -> 1.21.6](detailed-primers/1.21.6-from-1.21.5.md): `Generic Encoding and Decoding: Replacing Direct NBT Access`
- [1.21.10 -> 1.21.11](detailed-primers/1.21.11-from-1.21.10.md): `The Rename Shuffle`
- [1.21.11 -> 26.1](detailed-primers/26.1-from-1.21.11.md): `Loot Type Unrolling`
- [1.21.11 -> 26.1](detailed-primers/26.1-from-1.21.11.md): `Validation Overhaul`
- [1.21.11 -> 26.1](detailed-primers/26.1-from-1.21.11.md): `Datapack Villager Trades`
- [1.21.11 -> 26.1](detailed-primers/26.1-from-1.21.11.md): `Serializer Records and Recipe Info`
- [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)
### Items, components, equipment, armor, tools, combat, dyes, and consumables
**Rendering, models, shaders, particles, block models, item models, materials, atlases, and visual pipelines**
For modern item setup, item/equipment data, armor/equippable changes, consumables, cooldowns, data components, dye behavior, and stack-template changes, go to:
- [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)
- [1.21.1 -> 1.21.2/3](detailed-primers/1.21.2-from-1.21.1.md): `Equipments and Items, Models and All`
- [1.21.1 -> 1.21.2/3](detailed-primers/1.21.2-from-1.21.1.md): `Armor Materials, Equipment, and Model (Textures)`
- [1.21.1 -> 1.21.2/3](detailed-primers/1.21.2-from-1.21.1.md): `Interaction Results`
- [1.21.1 -> 1.21.2/3](detailed-primers/1.21.2-from-1.21.1.md): `BlockEntityTypes Privatized!`
- [1.21.1 -> 1.21.2/3](detailed-primers/1.21.2-from-1.21.1.md): `Consumables`
- [1.21.1 -> 1.21.2/3](detailed-primers/1.21.2-from-1.21.1.md): `Registry Objcet Id, in the Properties?`
- [1.21.1 -> 1.21.2/3](detailed-primers/1.21.2-from-1.21.1.md): `Properties Changes`
- [1.21.2/3 -> 1.21.4](detailed-primers/1.21.4-from-1.21.2-3.md): `Mob Replacing Current Items`
- [1.21.4 -> 1.21.5](detailed-primers/1.21.5-from-1.21.4.md): `Weapons, Tools, and Armor: Removing the Redundancies`
- [1.21.4 -> 1.21.5](detailed-primers/1.21.5-from-1.21.4.md): `Data Component Getters`
- [1.21.10 -> 1.21.11](detailed-primers/1.21.11-from-1.21.10.md): `New Data Components`
- [1.21.11 -> 26.1](detailed-primers/26.1-from-1.21.11.md): `Data Component Initializers`
- [1.21.11 -> 26.1](detailed-primers/26.1-from-1.21.11.md): `Item Instances and Stack Templates`
- [1.21.11 -> 26.1](detailed-primers/26.1-from-1.21.11.md): `Dye Component`
**Entities, mobs, mob AI, conversions, spawning, and entity data**
### Rendering, models, shaders, particles, block models, item models, materials, atlases, and visual pipelines
- [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)
For shaders, render types, render states, client items, particles, model baking, render pipeline rewrites, block/item model systems, atlas/material changes, GUI rendering internals, and the large `26.1` rendering pass, go to:
**GUI, input, keybinds, debug screens, debug tooling, RPC tooling, and test infrastructure**
- [1.21.1 -> 1.21.2/3](detailed-primers/1.21.2-from-1.21.1.md): `Gui Render Types`
- [1.21.1 -> 1.21.2/3](detailed-primers/1.21.2-from-1.21.1.md): `Shader Rewrites`
- [1.21.1 -> 1.21.2/3](detailed-primers/1.21.2-from-1.21.1.md): `Entity Render States`
- [1.21.1 -> 1.21.2/3](detailed-primers/1.21.2-from-1.21.1.md): `Equipments and Items, Models and All`
- [1.21.1 -> 1.21.2/3](detailed-primers/1.21.2-from-1.21.1.md): `Armor Materials, Equipment, and Model (Textures)`
- [1.21.2/3 -> 1.21.4](detailed-primers/1.21.4-from-1.21.2-3.md): `Client Items`
- [1.21.2/3 -> 1.21.4](detailed-primers/1.21.4-from-1.21.2-3.md): `Particles, rendered through Render Types`
- [1.21.4 -> 1.21.5](detailed-primers/1.21.5-from-1.21.4.md): `Render Pipeline Rework`
- [1.21.4 -> 1.21.5](detailed-primers/1.21.5-from-1.21.4.md): `Model Rework`
- [1.21.5 -> 1.21.6](detailed-primers/1.21.6-from-1.21.5.md): `GUI Changes`
- [1.21.5 -> 1.21.6](detailed-primers/1.21.6-from-1.21.5.md): `Blaze3d Changes`
- [1.21.6 -> 1.21.7](detailed-primers/1.21.7-from-1.21.6.md): `Minor Migrations`
- [1.21.7 -> 1.21.8](detailed-primers/1.21.8-from-1.21.7.md): `Minor Migrations`
- [1.21.8 -> 1.21.9](detailed-primers/1.21.9-from-1.21.8.md): `Feature Submissions: The Movie`
- [1.21.8 -> 1.21.9](detailed-primers/1.21.9-from-1.21.8.md): `The Font Glyph Pipeline`
- [1.21.10 -> 1.21.11](detailed-primers/1.21.11-from-1.21.10.md): `Oh Hey, Another Rendering Rewrite`
- [1.21.10 -> 1.21.11](detailed-primers/1.21.11-from-1.21.10.md): `Gizmos`
- [1.21.11 -> 26.1](detailed-primers/26.1-from-1.21.11.md): `Even More Rendering Changes`
- [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, input, keybinds, debug screens, debug tooling, RPC tooling, and test infrastructure
**World state, saved data, game rules, timelines, clocks, players, permissions, waypoints, and other server-side systems**
For GUI framework changes, input events, key categories, debug renderers, debug screens, tooling servers, and game tests, go to:
- [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)
- [1.21.1 -> 1.21.2/3](detailed-primers/1.21.2-from-1.21.1.md): `Gui Render Types`
- [1.21.4 -> 1.21.5](detailed-primers/1.21.5-from-1.21.4.md): `The Game Test Overhaul`
- [1.21.5 -> 1.21.6](detailed-primers/1.21.6-from-1.21.5.md): `GUI Changes`
- [1.21.6 -> 1.21.7](detailed-primers/1.21.7-from-1.21.6.md): `Minor Migrations`
- [1.21.8 -> 1.21.9](detailed-primers/1.21.9-from-1.21.8.md): `The Debugging Overhaul`
- [1.21.8 -> 1.21.9](detailed-primers/1.21.9-from-1.21.8.md): `Debug Screens`
- [1.21.8 -> 1.21.9](detailed-primers/1.21.9-from-1.21.8.md): `The JSON-RPC Management Servers`
- [1.21.8 -> 1.21.9](detailed-primers/1.21.9-from-1.21.8.md): `Input Handling Consolidation`
- [1.21.10 -> 1.21.11](detailed-primers/1.21.11-from-1.21.10.md): `Gizmos`
- [1.21.10 -> 1.21.11](detailed-primers/1.21.11-from-1.21.10.md): `Permission Overhaul`
- [1.21.11 -> 26.1](detailed-primers/26.1-from-1.21.11.md): `Java 25 and Deobfuscation`
- [1.21.11 -> 26.1](detailed-primers/26.1-from-1.21.11.md): `Minor Migrations`
**Remaining minor migrations**
### World state, saved data, game rules, timelines, clocks, players, permissions, waypoints, and other server-side systems
- [Language File Removals and Renames](detailed-primers/1.21.2-from-1.21.1.md#language-file-removals-and-renames) (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)
For block removal flow, voxel shapes, weighted lists, tickets, saved data, server player changes, waypoints, permissions, game rules, timelines, clocks, and level/server data ownership, go to:
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).
- [1.21.4 -> 1.21.5](detailed-primers/1.21.5-from-1.21.4.md): `Handling the Removal of Block Entities Properly`
- [1.21.4 -> 1.21.5](detailed-primers/1.21.5-from-1.21.4.md): `Voxel Shape Helpers`
- [1.21.4 -> 1.21.5](detailed-primers/1.21.5-from-1.21.4.md): `Weighted List Rework`
- [1.21.4 -> 1.21.5](detailed-primers/1.21.5-from-1.21.4.md): `Tickets`
- [1.21.4 -> 1.21.5](detailed-primers/1.21.5-from-1.21.4.md): `Saved Data, now with Types`
- [1.21.5 -> 1.21.6](detailed-primers/1.21.6-from-1.21.5.md): `Waypoints`
- [1.21.5 -> 1.21.6](detailed-primers/1.21.6-from-1.21.5.md): `Server Player Changes`
- [1.21.8 -> 1.21.9](detailed-primers/1.21.9-from-1.21.8.md): ``Level#isClientSide` now private`
- [1.21.10 -> 1.21.11](detailed-primers/1.21.11-from-1.21.10.md): `Permission Overhaul`
- [1.21.10 -> 1.21.11](detailed-primers/1.21.11-from-1.21.10.md): `The Timeline of Environment Attributes`
- [1.21.10 -> 1.21.11](detailed-primers/1.21.11-from-1.21.10.md): `The Game Rule Shuffle`
- [1.21.11 -> 26.1](detailed-primers/26.1-from-1.21.11.md): ``Level#random` field now protected`
- [1.21.11 -> 26.1](detailed-primers/26.1-from-1.21.11.md): `World Clocks and Time Markers`
- [1.21.11 -> 26.1](detailed-primers/26.1-from-1.21.11.md): `Splitting the Primary Level Data into Saved Data`
---
### Short releases and catch-all API churn
## Class and Method Index
If the thing you are chasing is not obviously a major subsystem rewrite, check these first:
If you have a compile error or need to find where a specific class/method changed, search this table.
- [1.21.1 -> 1.21.2/3](detailed-primers/1.21.2-from-1.21.1.md): `Minor Migrations`
- [1.21.2/3 -> 1.21.4](detailed-primers/1.21.4-from-1.21.2-3.md): `Minor Migrations`
- [1.21.4 -> 1.21.5](detailed-primers/1.21.5-from-1.21.4.md): `Minor Migrations`
- [1.21.5 -> 1.21.6](detailed-primers/1.21.6-from-1.21.5.md): `Minor Migrations`
- [1.21.6 -> 1.21.7](detailed-primers/1.21.7-from-1.21.6.md): `Minor Migrations`
- [1.21.7 -> 1.21.8](detailed-primers/1.21.8-from-1.21.7.md): `Minor Migrations`
- [1.21.8 -> 1.21.9](detailed-primers/1.21.9-from-1.21.8.md): `Minor Migrations`
- [1.21.9 -> 1.21.10](detailed-primers/1.21.10-from-1.21.9.md): `Minor Migrations`
- [1.21.10 -> 1.21.11](detailed-primers/1.21.11-from-1.21.10.md): `Minor Migrations`
- [1.21.11 -> 26.1](detailed-primers/26.1-from-1.21.11.md): `Minor Migrations`
| 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) |
The smallest releases in this chain are still indexed here and should not be skipped:
- [1.21.6 -> 1.21.7](detailed-primers/1.21.7-from-1.21.6.md)
- [1.21.7 -> 1.21.8](detailed-primers/1.21.8-from-1.21.7.md)
- [1.21.9 -> 1.21.10](detailed-primers/1.21.10-from-1.21.9.md)
## Complete Section Inventory By Version
This inventory exists so the main page indexes every upstream `##` section used in this GitBook.
### 1.21.1 -> 1.21.2/3
- [1.21.1 -> 1.21.2/3](detailed-primers/1.21.2-from-1.21.1.md): `Pack Changes`
- [1.21.1 -> 1.21.2/3](detailed-primers/1.21.2-from-1.21.1.md): `The Holder Set Transition`
- [1.21.1 -> 1.21.2/3](detailed-primers/1.21.2-from-1.21.1.md): `Gui Render Types`
- [1.21.1 -> 1.21.2/3](detailed-primers/1.21.2-from-1.21.1.md): `Shader Rewrites`
- [1.21.1 -> 1.21.2/3](detailed-primers/1.21.2-from-1.21.1.md): `Entity Render States`
- [1.21.1 -> 1.21.2/3](detailed-primers/1.21.2-from-1.21.1.md): `Equipments and Items, Models and All`
- [1.21.1 -> 1.21.2/3](detailed-primers/1.21.2-from-1.21.1.md): `Armor Materials, Equipment, and Model (Textures)`
- [1.21.1 -> 1.21.2/3](detailed-primers/1.21.2-from-1.21.1.md): `Interaction Results`
- [1.21.1 -> 1.21.2/3](detailed-primers/1.21.2-from-1.21.1.md): `Instruments, the Datapack Edition`
- [1.21.1 -> 1.21.2/3](detailed-primers/1.21.2-from-1.21.1.md): `Trial Spawner Configurations, now in Datapack Form`
- [1.21.1 -> 1.21.2/3](detailed-primers/1.21.2-from-1.21.1.md): `Recipe Providers, the 'not actually' of Data Providers`
- [1.21.1 -> 1.21.2/3](detailed-primers/1.21.2-from-1.21.1.md): `The Ingredient Shift`
- [1.21.1 -> 1.21.2/3](detailed-primers/1.21.2-from-1.21.1.md): `BlockEntityTypes Privatized!`
- [1.21.1 -> 1.21.2/3](detailed-primers/1.21.2-from-1.21.1.md): `Consumables`
- [1.21.1 -> 1.21.2/3](detailed-primers/1.21.2-from-1.21.1.md): `Registry Objcet Id, in the Properties?`
- [1.21.1 -> 1.21.2/3](detailed-primers/1.21.2-from-1.21.1.md): `Properties Changes`
- [1.21.1 -> 1.21.2/3](detailed-primers/1.21.2-from-1.21.1.md): `Recipes, now in Registry format`
- [1.21.1 -> 1.21.2/3](detailed-primers/1.21.2-from-1.21.1.md): `Minor Migrations`
### 1.21.2/3 -> 1.21.4
- [1.21.2/3 -> 1.21.4](detailed-primers/1.21.4-from-1.21.2-3.md): `Pack Changes`
- [1.21.2/3 -> 1.21.4](detailed-primers/1.21.4-from-1.21.2-3.md): `Client Items`
- [1.21.2/3 -> 1.21.4](detailed-primers/1.21.4-from-1.21.2-3.md): `Mob Replacing Current Items`
- [1.21.2/3 -> 1.21.4](detailed-primers/1.21.4-from-1.21.2-3.md): `Particles, rendered through Render Types`
- [1.21.2/3 -> 1.21.4](detailed-primers/1.21.4-from-1.21.2-3.md): `Minor Migrations`
### 1.21.4 -> 1.21.5
- [1.21.4 -> 1.21.5](detailed-primers/1.21.5-from-1.21.4.md): `Pack Changes`
- [1.21.4 -> 1.21.5](detailed-primers/1.21.5-from-1.21.4.md): `Handling the Removal of Block Entities Properly`
- [1.21.4 -> 1.21.5](detailed-primers/1.21.5-from-1.21.4.md): `Voxel Shape Helpers`
- [1.21.4 -> 1.21.5](detailed-primers/1.21.5-from-1.21.4.md): `Weapons, Tools, and Armor: Removing the Redundancies`
- [1.21.4 -> 1.21.5](detailed-primers/1.21.5-from-1.21.4.md): `Weighted List Rework`
- [1.21.4 -> 1.21.5](detailed-primers/1.21.5-from-1.21.4.md): `Tickets`
- [1.21.4 -> 1.21.5](detailed-primers/1.21.5-from-1.21.4.md): `The Game Test Overhaul`
- [1.21.4 -> 1.21.5](detailed-primers/1.21.5-from-1.21.4.md): `Data Component Getters`
- [1.21.4 -> 1.21.5](detailed-primers/1.21.5-from-1.21.4.md): `Tags and Parsing`
- [1.21.4 -> 1.21.5](detailed-primers/1.21.5-from-1.21.4.md): `Saved Data, now with Types`
- [1.21.4 -> 1.21.5](detailed-primers/1.21.5-from-1.21.4.md): `Render Pipeline Rework`
- [1.21.4 -> 1.21.5](detailed-primers/1.21.5-from-1.21.4.md): `Model Rework`
- [1.21.4 -> 1.21.5](detailed-primers/1.21.5-from-1.21.4.md): `Minor Migrations`
### 1.21.5 -> 1.21.6
- [1.21.5 -> 1.21.6](detailed-primers/1.21.6-from-1.21.5.md): `Pack Changes`
- [1.21.5 -> 1.21.6](detailed-primers/1.21.6-from-1.21.5.md): `GUI Changes`
- [1.21.5 -> 1.21.6](detailed-primers/1.21.6-from-1.21.5.md): `Waypoints`
- [1.21.5 -> 1.21.6](detailed-primers/1.21.6-from-1.21.5.md): `Blaze3d Changes`
- [1.21.5 -> 1.21.6](detailed-primers/1.21.6-from-1.21.5.md): `Tag Providers: Appender Rewrite`
- [1.21.5 -> 1.21.6](detailed-primers/1.21.6-from-1.21.5.md): `Generic Encoding and Decoding: Replacing Direct NBT Access`
- [1.21.5 -> 1.21.6](detailed-primers/1.21.6-from-1.21.5.md): `Server Player Changes`
- [1.21.5 -> 1.21.6](detailed-primers/1.21.6-from-1.21.5.md): `Minor Migrations`
### 1.21.6 -> 1.21.7
- [1.21.6 -> 1.21.7](detailed-primers/1.21.7-from-1.21.6.md): `Pack Changes`
- [1.21.6 -> 1.21.7](detailed-primers/1.21.7-from-1.21.6.md): `Minor Migrations`
### 1.21.7 -> 1.21.8
- [1.21.7 -> 1.21.8](detailed-primers/1.21.8-from-1.21.7.md): `Pack Changes`
- [1.21.7 -> 1.21.8](detailed-primers/1.21.8-from-1.21.7.md): `Minor Migrations`
### 1.21.8 -> 1.21.9
- [1.21.8 -> 1.21.9](detailed-primers/1.21.9-from-1.21.8.md): `Pack Changes`
- [1.21.8 -> 1.21.9](detailed-primers/1.21.9-from-1.21.8.md): `The Debugging Overhaul`
- [1.21.8 -> 1.21.9](detailed-primers/1.21.9-from-1.21.8.md): `Debug Screens`
- [1.21.8 -> 1.21.9](detailed-primers/1.21.9-from-1.21.8.md): `Feature Submissions: The Movie`
- [1.21.8 -> 1.21.9](detailed-primers/1.21.9-from-1.21.8.md): `The Font Glyph Pipeline`
- [1.21.8 -> 1.21.9](detailed-primers/1.21.9-from-1.21.8.md): `The JSON-RPC Management Servers`
- [1.21.8 -> 1.21.9](detailed-primers/1.21.9-from-1.21.8.md): `Input Handling Consolidation`
- [1.21.8 -> 1.21.9](detailed-primers/1.21.9-from-1.21.8.md): ``Level#isClientSide` now private`
- [1.21.8 -> 1.21.9](detailed-primers/1.21.9-from-1.21.8.md): `Minor Migrations`
### 1.21.9 -> 1.21.10
- [1.21.9 -> 1.21.10](detailed-primers/1.21.10-from-1.21.9.md): `Pack Changes`
- [1.21.9 -> 1.21.10](detailed-primers/1.21.10-from-1.21.9.md): `Minor Migrations`
### 1.21.10 -> 1.21.11
- [1.21.10 -> 1.21.11](detailed-primers/1.21.11-from-1.21.10.md): `Pack Changes`
- [1.21.10 -> 1.21.11](detailed-primers/1.21.11-from-1.21.10.md): `The Rename Shuffle`
- [1.21.10 -> 1.21.11](detailed-primers/1.21.11-from-1.21.10.md): `Oh Hey, Another Rendering Rewrite`
- [1.21.10 -> 1.21.11](detailed-primers/1.21.11-from-1.21.10.md): `Gizmos`
- [1.21.10 -> 1.21.11](detailed-primers/1.21.11-from-1.21.10.md): `Permission Overhaul`
- [1.21.10 -> 1.21.11](detailed-primers/1.21.11-from-1.21.10.md): `New Data Components`
- [1.21.10 -> 1.21.11](detailed-primers/1.21.11-from-1.21.10.md): `The Timeline of Environment Attributes`
- [1.21.10 -> 1.21.11](detailed-primers/1.21.11-from-1.21.10.md): `The Game Rule Shuffle`
- [1.21.10 -> 1.21.11](detailed-primers/1.21.11-from-1.21.10.md): `Minor Migrations`
### 1.21.11 -> 26.1
- [1.21.11 -> 26.1](detailed-primers/26.1-from-1.21.11.md): `Pack Changes`
- [1.21.11 -> 26.1](detailed-primers/26.1-from-1.21.11.md): `Java 25 and Deobfuscation`
- [1.21.11 -> 26.1](detailed-primers/26.1-from-1.21.11.md): `Loot Type Unrolling`
- [1.21.11 -> 26.1](detailed-primers/26.1-from-1.21.11.md): `Validation Overhaul`
- [1.21.11 -> 26.1](detailed-primers/26.1-from-1.21.11.md): `Datapack Villager Trades`
- [1.21.11 -> 26.1](detailed-primers/26.1-from-1.21.11.md): ``Level#random` field now protected`
- [1.21.11 -> 26.1](detailed-primers/26.1-from-1.21.11.md): `Data Component Initializers`
- [1.21.11 -> 26.1](detailed-primers/26.1-from-1.21.11.md): `Item Instances and Stack Templates`
- [1.21.11 -> 26.1](detailed-primers/26.1-from-1.21.11.md): `Serializer Records and Recipe Info`
- [1.21.11 -> 26.1](detailed-primers/26.1-from-1.21.11.md): `Dye Component`
- [1.21.11 -> 26.1](detailed-primers/26.1-from-1.21.11.md): `World Clocks and Time Markers`
- [1.21.11 -> 26.1](detailed-primers/26.1-from-1.21.11.md): `Splitting the Primary Level Data into Saved Data`
- [1.21.11 -> 26.1](detailed-primers/26.1-from-1.21.11.md): `Even More Rendering Changes`
- [1.21.11 -> 26.1](detailed-primers/26.1-from-1.21.11.md): `Minor Migrations`
---
## Source and attribution
The split primer pages in this GitBook are copied from the upstream primers in:
- `ChampionAsh5357/neoforged-github`, branch `update/26.1`
For attribution and license notes, see:
- [Source And Attribution](source-and-attribution.md)
The split primer pages are copied from `ChampionAsh5357/neoforged-github`, branch `update/26.1`. See [Source And Attribution](source-and-attribution.md).

23
src/SUMMARY.md
View File

@ -1,17 +1,16 @@
# Summary
- [1.21.1 to 26.1 NeoForge Porting Guide](README.md)
- [Direct Port Guide](direct-port-guide.md)
- [Repeatedly Changing Systems](repeatedly-changing-systems.md)
- [Source And Attribution](source-and-attribution.md)
- [Detailed Primers](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)
- [1.21.5 -> 1.21.6](detailed-primers/1.21.6-from-1.21.5.md)
- [1.21.6 -> 1.21.7](detailed-primers/1.21.7-from-1.21.6.md)
- [1.21.7 -> 1.21.8](detailed-primers/1.21.8-from-1.21.7.md)
- [1.21.8 -> 1.21.9](detailed-primers/1.21.9-from-1.21.8.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.11 -> 26.1](detailed-primers/26.1-from-1.21.11.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)
- [1.21.5 -> 1.21.6](detailed-primers/1.21.6-from-1.21.5.md)
- [1.21.6 -> 1.21.7](detailed-primers/1.21.7-from-1.21.6.md)
- [1.21.7 -> 1.21.8](detailed-primers/1.21.8-from-1.21.7.md)
- [1.21.8 -> 1.21.9](detailed-primers/1.21.9-from-1.21.8.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.11 -> 26.1](detailed-primers/26.1-from-1.21.11.md)
- [Source And Attribution](source-and-attribution.md)

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

@ -1,16 +1,135 @@
# Detailed Primers
These chapters preserve the upstream primer content step by step so the direct guide does not lose version-specific detail.
These chapters preserve the upstream primer content step by step. Each section heading links directly to that section within the primer page.
Read them in order:
## 1.21.1 -> 1.21.2/3
- [1.21.1 -> 1.21.2/3](1.21.2-from-1.21.1.md)
- [1.21.2/3 -> 1.21.4](1.21.4-from-1.21.2-3.md)
- [1.21.4 -> 1.21.5](1.21.5-from-1.21.4.md)
- [1.21.5 -> 1.21.6](1.21.6-from-1.21.5.md)
- [1.21.6 -> 1.21.7](1.21.7-from-1.21.6.md)
- [1.21.7 -> 1.21.8](1.21.8-from-1.21.7.md)
- [1.21.8 -> 1.21.9](1.21.9-from-1.21.8.md)
- [1.21.9 -> 1.21.10](1.21.10-from-1.21.9.md)
- [1.21.10 -> 1.21.11](1.21.11-from-1.21.10.md)
- [1.21.11 -> 26.1](26.1-from-1.21.11.md)
[Full primer](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/3 -> 1.21.4
[Full primer](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 -> 1.21.5
[Full primer](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 -> 1.21.6
[Full primer](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 -> 1.21.7
[Full primer](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 -> 1.21.8
[Full primer](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 -> 1.21.9
[Full primer](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 -> 1.21.10
[Full primer](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 -> 1.21.11
[Full primer](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 -> 26.1
[Full primer](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)

21598
src/direct-port-guide.md
View File

File diff suppressed because it is too large Load Diff

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

@ -6,15 +6,20 @@ When the same subsystem changed in multiple intermediate versions, do not treat
## Rendering and graphics
Relevant chapters:
Relevant sections:
- [1.21.1 -> 1.21.2/3](detailed-primers/1.21.2-from-1.21.1.md)
- [1.21.4 -> 1.21.5](detailed-primers/1.21.5-from-1.21.4.md)
- [1.21.5 -> 1.21.6](detailed-primers/1.21.6-from-1.21.5.md)
- [1.21.6 -> 1.21.7](detailed-primers/1.21.7-from-1.21.6.md)
- [1.21.8 -> 1.21.9](detailed-primers/1.21.9-from-1.21.8.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)
- [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)
How to read them:
@ -32,13 +37,20 @@ Practical rule:
## Item models and item metadata
Relevant chapters:
Relevant sections:
- [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.8 -> 1.21.9](detailed-primers/1.21.9-from-1.21.8.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)
- [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)
What sticks:
@ -54,13 +66,18 @@ Practical rule:
## Tags, registries, codecs, and validation
Relevant chapters:
Relevant sections:
- [1.21.1 -> 1.21.2/3](detailed-primers/1.21.2-from-1.21.1.md)
- [1.21.4 -> 1.21.5](detailed-primers/1.21.5-from-1.21.4.md)
- [1.21.5 -> 1.21.6](detailed-primers/1.21.6-from-1.21.5.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)
- [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)
What sticks:
@ -77,12 +94,17 @@ Practical rule:
## Data components
Relevant chapters:
Relevant sections:
- [1.21.1 -> 1.21.2/3](detailed-primers/1.21.2-from-1.21.1.md)
- [1.21.4 -> 1.21.5](detailed-primers/1.21.5-from-1.21.4.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)
- [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)
What sticks:
@ -97,10 +119,11 @@ Practical rule:
## Saved data and world state
Relevant chapters:
Relevant sections:
- [1.21.4 -> 1.21.5](detailed-primers/1.21.5-from-1.21.4.md)
- [1.21.11 -> 26.1](detailed-primers/26.1-from-1.21.11.md)
- [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)
What sticks:
@ -113,12 +136,15 @@ Practical rule:
## Developer tooling, tests, debugging, and permissions
Relevant chapters:
Relevant sections:
- [1.21.4 -> 1.21.5](detailed-primers/1.21.5-from-1.21.4.md)
- [1.21.8 -> 1.21.9](detailed-primers/1.21.9-from-1.21.8.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)
- [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)
What sticks:

439
theme/gitbook.css
View File

@ -1,31 +1,32 @@
@import url('https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700;800&display=swap');
/* ── Fonts ────────────────────────────────────────────────── */
:root {
--gb-bg: #1d1d1d;
--gb-surface: #222324;
--gb-surface-2: #2b2c2d;
--gb-surface-3: #343536;
--gb-border: rgba(255, 255, 255, 0.08);
--gb-border-strong: rgba(255, 255, 255, 0.14);
--gb-text: #f4fbfd;
--gb-text-soft: #c0c8cc;
--gb-text-muted: #94a1a8;
--gb-accent: #00beef;
--gb-accent-2: #1cd6ff;
--gb-accent-soft: rgba(0, 190, 239, 0.14);
--gb-shadow: 0 10px 30px rgba(0, 0, 0, 0.22);
--content-max-width: 900px;
--page-padding: 28px;
--menu-bar-height: 64px;
--sidebar-width: 320px;
--sidebar-resize-indicator-width: 2px;
--sidebar-resize-indicator-color: rgba(255, 255, 255, 0.06);
--gb-bg: #161719;
--gb-surface: #1c1d1f;
--gb-surface-2: #242527;
--gb-surface-3: #2e3032;
--gb-border: rgba(255, 255, 255, 0.07);
--gb-border-strong: rgba(255, 255, 255, 0.13);
--gb-text: #e8edf0;
--gb-text-soft: #b0b8be;
--gb-text-muted: #7e8a92;
--gb-accent: #58a6ff;
--gb-accent-dim: #3d7cc9;
--gb-accent-soft: rgba(88, 166, 255, 0.10);
--gb-accent-glow: rgba(88, 166, 255, 0.04);
--gb-green: #3fb950;
--gb-shadow: 0 1px 3px rgba(0, 0, 0, 0.30);
--gb-shadow-lg: 0 4px 16px rgba(0, 0, 0, 0.35);
--gb-radius: 6px;
--gb-radius-lg: 8px;
--gb-mono: "JetBrains Mono", "Fira Code", "Cascadia Code", ui-monospace, "SFMono-Regular", "SF Mono", Menlo, Consolas, monospace;
--gb-sans: -apple-system, BlinkMacSystemFont, "Segoe UI", Helvetica, Arial, sans-serif;
--content-max-width: 920px;
--page-padding: 24px;
--sidebar-width: 300px;
}
html,
body {
background: var(--gb-bg);
}
/* ── Theme overrides (force single dark theme) ───────────── */
html.navy,
html.coal,
@ -34,81 +35,82 @@ html.light,
html.rust {
--bg: var(--gb-bg);
--fg: var(--gb-text);
--sidebar-bg: #1f2021;
--sidebar-bg: var(--gb-surface);
--sidebar-fg: var(--gb-text-soft);
--sidebar-non-existant: #5f6a70;
--sidebar-non-existant: var(--gb-text-muted);
--sidebar-active: var(--gb-accent);
--sidebar-spacer: transparent;
--scrollbar: rgba(255, 255, 255, 0.12);
--icons: var(--gb-text-soft);
--scrollbar: rgba(255, 255, 255, 0.10);
--icons: var(--gb-text-muted);
--icons-hover: var(--gb-text);
--links: var(--gb-accent-2);
--inline-code-color: #9fe8ff;
--theme-popup-bg: #262728;
--links: var(--gb-accent);
--inline-code-color: #c9d1d9;
--theme-popup-bg: var(--gb-surface-2);
--theme-popup-border: var(--gb-border-strong);
--theme-hover: rgba(255, 255, 255, 0.08);
--quote-bg: rgba(255, 255, 255, 0.035);
--quote-border: var(--gb-accent);
--theme-hover: rgba(255, 255, 255, 0.06);
--quote-bg: rgba(255, 255, 255, 0.025);
--quote-border: var(--gb-accent-dim);
--table-border-color: var(--gb-border);
--table-header-bg: rgba(255, 255, 255, 0.03);
--table-alternate-bg: rgba(255, 255, 255, 0.015);
--searchbar-border-color: var(--gb-border-strong);
--searchbar-bg: var(--gb-surface);
--searchbar-bg: var(--gb-surface-2);
--searchbar-fg: var(--gb-text);
--searchbar-shadow-color: transparent;
--searchresults-header-fg: var(--gb-text-soft);
--searchresults-border-color: var(--gb-border);
--searchresults-li-bg: transparent;
--search-mark-bg: rgba(0, 190, 239, 0.25);
--search-mark-bg: rgba(88, 166, 255, 0.22);
}
/* ── Base ─────────────────────────────────────────────────── */
html,
body,
.menu-title,
.content,
.chapter li a,
.nav-chapters,
.mobile-nav-chapters,
.icon-button,
code {
font-family: "Inter", "Open Sans", ui-sans-serif, system-ui, sans-serif;
body {
background: var(--gb-bg);
font-family: var(--gb-sans);
-webkit-font-smoothing: antialiased;
-moz-osx-font-smoothing: grayscale;
}
body {
color: var(--gb-text);
}
#mdbook-body-container {
background:
radial-gradient(circle at top right, rgba(0, 190, 239, 0.12), transparent 26%),
radial-gradient(circle at bottom left, rgba(0, 190, 239, 0.08), transparent 22%),
var(--gb-bg);
::selection {
background: rgba(88, 166, 255, 0.28);
color: #fff;
}
/* ── Hide theme toggle ────────────────────────────────────── */
#mdbook-theme-toggle,
#mdbook-theme-list {
display: none !important;
}
/* ── Menu bar ─────────────────────────────────────────────── */
#mdbook-menu-bar {
backdrop-filter: blur(16px);
-webkit-backdrop-filter: blur(16px);
background: rgba(29, 29, 29, 0.86);
background: rgba(22, 23, 25, 0.82);
backdrop-filter: blur(12px) saturate(1.4);
-webkit-backdrop-filter: blur(12px) saturate(1.4);
border-bottom: 1px solid var(--gb-border);
box-shadow: none;
}
.menu-bar > .left-buttons,
.menu-bar > .right-buttons {
gap: 0.45rem;
}
.menu-title {
font-weight: 700;
letter-spacing: -0.02em;
font-weight: 600;
letter-spacing: -0.01em;
color: var(--gb-text);
font-family: var(--gb-sans);
}
.icon-button,
.nav-chapters,
.mobile-nav-chapters {
border-radius: 14px;
transition: background 0.18s ease, color 0.18s ease, border-color 0.18s ease, transform 0.18s ease;
border-radius: var(--gb-radius);
transition: background 0.15s ease, color 0.15s ease;
}
.icon-button:hover,
@ -118,101 +120,142 @@ body {
color: var(--gb-text);
}
#mdbook-theme-toggle,
#mdbook-theme-list {
display: none !important;
}
/* ── Sidebar ──────────────────────────────────────────────── */
#mdbook-sidebar {
background: linear-gradient(180deg, rgba(36, 37, 38, 0.98), rgba(29, 29, 29, 0.98));
background: var(--gb-surface);
border-right: 1px solid var(--gb-border);
}
.sidebar-scrollbox {
padding: 1rem 0.9rem 2rem;
}
.chapter {
gap: 0.1rem;
}
.chapter li.chapter-item {
margin: 0.08rem 0;
padding: 0.75rem 0.6rem 2rem;
}
.chapter li a,
.chapter li span {
border-radius: 12px;
padding: 0.55rem 0.8rem;
line-height: 1.25;
font-family: var(--gb-sans);
border-radius: var(--gb-radius);
padding: 0.4rem 0.65rem;
line-height: 1.35;
font-size: 0.875rem;
}
.chapter li a {
color: var(--gb-text-soft);
border: 1px solid transparent;
transition: background 0.12s ease, color 0.12s ease, border-color 0.12s ease;
}
.chapter li a:hover {
color: var(--gb-text);
text-decoration: none;
background: rgba(255, 255, 255, 0.045);
background: rgba(255, 255, 255, 0.04);
}
.chapter li a.active,
.chapter a.current-header {
color: var(--gb-text);
background: var(--gb-accent-soft);
border-color: rgba(0, 190, 239, 0.28);
box-shadow: inset 2px 0 0 var(--gb-accent);
border-color: rgba(88, 166, 255, 0.20);
font-weight: 500;
}
.chapter > .chapter-item > .chapter-link-wrapper > a {
font-weight: 600;
font-size: 0.9rem;
}
/* nested sidebar children */
.chapter li li a {
font-size: 0.84rem;
padding-left: 1.4rem;
color: var(--gb-text-muted);
}
.chapter li li a:hover,
.chapter li li a.active {
color: var(--gb-text-soft);
}
/* ── Page wrapper ─────────────────────────────────────────── */
#mdbook-page-wrapper {
background: transparent;
}
#mdbook-body-container {
background: var(--gb-bg);
}
.content {
padding-top: 2.25rem;
padding-top: 1.5rem;
font-family: var(--gb-sans);
}
.content main {
background: rgba(255, 255, 255, 0.02);
background: var(--gb-surface);
border: 1px solid var(--gb-border);
border-radius: 24px;
padding: 2.2rem 2.4rem 2.8rem;
border-radius: var(--gb-radius-lg);
padding: 2rem 2.2rem 2.5rem;
box-shadow: var(--gb-shadow);
}
/* ── Typography ───────────────────────────────────────────── */
.content h1,
.content h2,
.content h3,
.content h4 {
.content h4,
.content h5,
.content h6 {
color: var(--gb-text);
letter-spacing: -0.025em;
letter-spacing: -0.015em;
font-family: var(--gb-sans);
}
.content h1 {
font-size: 2.35rem;
line-height: 1.05;
font-weight: 800;
margin-top: 0.2rem;
margin-bottom: 1rem;
font-size: 2rem;
line-height: 1.15;
font-weight: 700;
margin-top: 0;
margin-bottom: 0.75rem;
padding-bottom: 0.5rem;
border-bottom: 1px solid var(--gb-border);
}
.content h2 {
font-size: 1.5rem;
font-weight: 750;
margin-top: 2.6rem;
padding-top: 0.35rem;
border-top: 1px solid rgba(255, 255, 255, 0.06);
font-size: 1.4rem;
font-weight: 650;
margin-top: 2.5rem;
margin-bottom: 0.6rem;
padding-bottom: 0.3rem;
border-bottom: 1px solid var(--gb-border);
}
.content h3 {
font-size: 1.12rem;
font-weight: 700;
font-size: 1.15rem;
font-weight: 600;
margin-top: 1.8rem;
margin-bottom: 0.4rem;
}
.content h4 {
font-size: 1rem;
font-weight: 600;
margin-top: 1.4rem;
margin-bottom: 0.3rem;
color: var(--gb-text-soft);
}
.content h5,
.content h6 {
font-size: 0.9rem;
font-weight: 600;
margin-top: 1.2rem;
margin-bottom: 0.25rem;
color: var(--gb-text-soft);
text-transform: uppercase;
letter-spacing: 0.03em;
}
.content p,
@ -220,21 +263,24 @@ body {
.content td,
.content th {
color: var(--gb-text-soft);
line-height: 1.68;
line-height: 1.65;
font-size: 0.95rem;
}
.content strong {
color: var(--gb-text);
font-weight: 600;
}
.content a {
color: var(--gb-accent-2);
color: var(--gb-accent);
text-decoration: none;
border-bottom: 1px solid transparent;
transition: border-color 0.12s ease;
}
.content a:hover {
color: #7deaff;
text-decoration: none;
border-bottom-color: var(--gb-accent);
}
.content .header:link,
@ -242,82 +288,138 @@ body {
color: var(--gb-text);
}
/* ── Inline code ──────────────────────────────────────────── */
.content code {
background: rgba(255, 255, 255, 0.055);
font-family: var(--gb-mono);
background: rgba(255, 255, 255, 0.06);
border: 1px solid rgba(255, 255, 255, 0.06);
border-radius: 10px;
padding: 0.18rem 0.42rem;
font-size: 0.9em;
border-radius: 4px;
padding: 0.15rem 0.35rem;
font-size: 0.85em;
word-break: break-word;
}
/* ── Code blocks ──────────────────────────────────────────── */
.content pre {
background: #202122;
background: #0d1117;
border: 1px solid var(--gb-border);
border-radius: 20px;
padding: 1rem 1.15rem;
box-shadow: inset 0 1px 0 rgba(255, 255, 255, 0.02);
border-radius: var(--gb-radius);
padding: 1rem 1.1rem;
overflow-x: auto;
line-height: 1.5;
}
.content pre code {
font-family: var(--gb-mono);
background: transparent;
border: 0;
padding: 0;
border-radius: 0;
font-size: 0.84rem;
word-break: normal;
white-space: pre;
}
/* ── Blockquotes ──────────────────────────────────────────── */
.content blockquote {
margin: 1.35rem 0;
padding: 0.8rem 1rem 0.8rem 1.15rem;
background: rgba(255, 255, 255, 0.03);
border-left: 3px solid var(--gb-accent);
border-radius: 0 16px 16px 0;
margin: 1.2rem 0;
padding: 0.6rem 1rem;
background: var(--gb-accent-glow);
border-left: 3px solid var(--gb-accent-dim);
border-radius: 0 var(--gb-radius) var(--gb-radius) 0;
color: var(--gb-text-soft);
}
.content blockquote p {
margin: 0.3rem 0;
}
/* ── Tables ───────────────────────────────────────────────── */
.content table {
width: 100%;
border-collapse: separate;
border-spacing: 0;
overflow: hidden;
border-collapse: collapse;
border: 1px solid var(--gb-border);
border-radius: 18px;
border-radius: var(--gb-radius);
overflow: hidden;
font-size: 0.9rem;
}
.content thead {
background: rgba(255, 255, 255, 0.04);
background: rgba(255, 255, 255, 0.035);
}
.content tbody tr:nth-child(even) {
background: rgba(255, 255, 255, 0.018);
.content th {
font-weight: 600;
text-align: left;
color: var(--gb-text);
}
.content th,
.content td {
padding: 0.82rem 0.95rem;
padding: 0.6rem 0.8rem;
border-bottom: 1px solid var(--gb-border);
}
.content hr {
border-color: var(--gb-border);
.content tbody tr:last-child td {
border-bottom: 0;
}
.content tbody tr:nth-child(even) {
background: rgba(255, 255, 255, 0.015);
}
/* ── Lists ────────────────────────────────────────────────── */
.content ul,
.content ol {
padding-left: 1.6rem;
}
.content li {
margin: 0.2rem 0;
}
.content li > p {
margin: 0.25rem 0;
}
/* ── Horizontal rules ─────────────────────────────────────── */
.content hr {
border: none;
border-top: 1px solid var(--gb-border);
margin: 2rem 0;
}
/* ── Navigation ───────────────────────────────────────────── */
.nav-wrapper,
.nav-wide-wrapper {
margin-top: 1rem;
margin-top: 1.5rem;
}
.nav-chapters,
.mobile-nav-chapters {
background: rgba(255, 255, 255, 0.04);
background: var(--gb-surface-2);
border: 1px solid var(--gb-border);
border-radius: var(--gb-radius);
font-family: var(--gb-sans);
}
.nav-chapters.next,
.nav-chapters.previous {
border-radius: 16px;
}
/* ── Toolbar buttons ──────────────────────────────────────── */
#print-button,
#git-edit-button {
opacity: 0.95;
opacity: 0.8;
}
#print-button:hover,
#git-edit-button:hover {
opacity: 1;
}
.left-buttons,
@ -325,35 +427,86 @@ body {
align-items: center;
}
/* ── Scrollbar ────────────────────────────────────────────── */
::-webkit-scrollbar {
width: 10px;
height: 10px;
width: 8px;
height: 8px;
}
::-webkit-scrollbar-thumb {
background: rgba(255, 255, 255, 0.14);
border-radius: 999px;
background: rgba(255, 255, 255, 0.10);
border-radius: 4px;
}
::-webkit-scrollbar-thumb:hover {
background: rgba(255, 255, 255, 0.18);
}
::-webkit-scrollbar-track {
background: transparent;
}
/* ── Search results ───────────────────────────────────────── */
.searchresults a {
color: var(--gb-accent) !important;
}
.search-results .search-results-title {
color: var(--gb-text);
}
mark {
background: rgba(88, 166, 255, 0.22);
color: inherit;
border-radius: 2px;
padding: 0 2px;
}
/* ── Focus states (a11y) ──────────────────────────────────── */
a:focus-visible,
button:focus-visible,
input:focus-visible {
outline: 2px solid var(--gb-accent);
outline-offset: 2px;
}
/* ── Mobile ───────────────────────────────────────────────── */
@media (max-width: 1080px) {
.content {
padding-top: 1.25rem;
padding-top: 0.75rem;
}
.content main {
border-radius: 0;
border-left: 0;
border-right: 0;
padding: 1.4rem 1.1rem 2rem;
background: transparent;
box-shadow: none;
padding: 1.25rem 1rem 2rem;
}
#mdbook-menu-bar {
background: rgba(29, 29, 29, 0.92);
background: rgba(22, 23, 25, 0.92);
}
}
@media (max-width: 600px) {
.content main {
padding: 1rem 0.75rem 1.5rem;
}
.content h1 {
font-size: 1.6rem;
}
.content h2 {
font-size: 1.2rem;
}
.content pre {
font-size: 0.78rem;
padding: 0.75rem;
}
}

6
theme/head.hbs
View File

@ -1,5 +1 @@
<meta name="theme-color" content="#1d1d1d">
<link rel="preconnect" href="https://fonts.googleapis.com">
<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
<link href="https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700;800&display=swap" rel="stylesheet">
<meta name="theme-color" content="#161719">