# Legacy 1.20.1: client events Part of the 1.20.1 pipeline notes ([Legacy-1.20.1-Estimate](Legacy-1.20.1-Estimate.md), [Development](Development)). Audit of every Forge 47.x client event against NeoForge 1.21.1, written 2026-11-16 after a 1.20.1 mod failed in a client with "net.neoforged.neoforge.client.event.TextureStitchEvent does not exist" (1.21.1 has `TextureAtlasStitchedEvent`). Nothing was run in a game: the table comes from the class files of `forge-1.20.1-47.4.20-universal.jar` and NeoForge 21.1.258 (merged jar, bus, FML loader) and from the layer's own tables. ## How the 1.20.1 pipeline maps events * **Class names.** `Forge1201Transformer.mapClass`: a row of `forge-curated-renames.tsv`, `forge-event-renames.tsv` (generated) or `forge-fml-renames.tsv` wins; otherwise the package prefix moves (`net/minecraftforge/` to `net/neoforged/neoforge/`, `fml`, `eventbus` to `bus`, ...). A class that moved by prefix and does not exist in 1.21.1 is exactly the `TextureStitchEvent` failure, so the audit resolves every Forge event the same way and looks the result up in NeoForge. * **Facades.** A class in `src/main/java/legacyconnector/v1_20_1/net/minecraftforge/...` replaces the Forge class (overlays, `TickEvent`, `LivingHurtEvent`, `NetworkEvent`, ...); the old event is posted from the new one in `Forge1201Events` (common) and `Forge1201Client` (client). * **Members.** `forge-members.tsv` renames a member (any descriptor); `forge-call-rewrites.tsv` redirects a call whose owner/name/descriptor 1.21.1 lacks to a static helper (`owner.name(desc)rethelper`; `TailClient.name` = `ForgeApiTailClient1201`, the client part so a dedicated server never loads client classes; the helper takes the receiver typed as the owner of the call first, hence one overload per owner). Mod events get `ICancellableEvent` from their `@Cancelable` annotation. * **Abstract events.** NeoForge refuses a listener on an abstract event; `neoforge-abstract-events.tsv` (generated by `EventTables1201Tool`) fans such a listener out to the concrete events. * `loader/.../tools/EventTables1201Tool` reports unmapped Forge events when given the Forge jar (`./gradlew eventTables1201 -PeventJars=... -PforgeJar=...`); this audit repeated its check without Gradle (class files parsed directly) and added the member level the tool does not do: for each event with a counterpart, every public method (name, parameter and return types by simple name) of the Forge class against the NeoForge class and its superclasses, the event bus (mod/game), and `ICancellableEvent` against `@Cancelable`. ## Counts (the 128 public client events of Forge 47: everything under `net.minecraftforge.client`, nested classes included) | | before | now | open | |---|---|---|---| | class resolves to an existing 1.21.1 class (package move, curated row, facade) | 126 | 126 | 2 | | event with changed members (method gone, retyped or renamed) | 21 events, 6 had a call rewrite | 21, all covered | 0 (constructors aside) | | events on a different bus than in 1.20.1 | 0 | 0 | 0 | | `@Cancelable` in Forge but not cancellable in NeoForge (concrete events) | 0 | 0 | 0 | The 2 open classes: `TextureStitchEvent` (the base class; being mapped on branch `worktree-agent-a715b2d3204d130d2`, not touched here) and `RegisterTextureAtlasSpriteLoadersEvent` (removed in 1.21, see below). The 4 "facade" lines are `RegisterGuiOverlaysEvent`, `RenderGuiOverlayEvent` and its `Pre`/`Post`. Added by this audit (22 call rewrite rows and their helpers in `ForgeApiTailClient1201`, checked by `ClientEventRewriteHelpersTest`): * `getPartialTick()F` of `CustomizeGuiOverlayEvent` (+ `BossEventProgress`, `Chat`, `DebugText`), `RenderLevelStageEvent`, `RenderGuiEvent` and `RenderHighlightEvent` (+ `Entity`) on the base owners (1.21.1 returns a `DeltaTracker`; before only the `Pre`/`Post`/`Block` owners were rewritten); * `getScrollDelta()D` of `ScreenEvent.MouseScrolled` (base owner) and `InputEvent.MouseScrollingEvent` (1.21.1 has an axis each: the vertical one is used); * `wasHandled()Z` of `ScreenEvent.MouseButtonPressed.Post`/`MouseButtonReleased.Post` (now `wasClickHandled`/`wasReleaseHandled`); * `EntityRenderersEvent.AddLayers`: `getEntityRenderer`, `getRenderer` (returned `LivingEntityRenderer`, null for other renderers), `getPlayerSkin`/`getSkin` (took the skin name, now `PlayerSkin.Model`); * the registrations that took a bare name and now take a `ResourceLocation` (the name goes into the namespace of the mod being loaded, `ModLoadingContext.getActiveNamespace()`, as Forge did): `ModelEvent.RegisterGeometryLoaders.register(String, IGeometryLoader)`, `RegisterNamedRenderTypesEvent.register(String, ...)` (both overloads), and `ModelEvent.RegisterAdditional.register(ResourceLocation)` (the model becomes a standalone `ModelResourceLocation`). ## Open items needing design 1. **`RenderLevelStageEvent.getPoseStack()`: semantics, not a signature.** In 1.20.1 the pose stack of every stage carried the camera rotation (`LevelRenderer.renderLevel` applied it to the stack before the event); in 1.21.1 `getPoseStack()` is an identity stack and the rotation is `getModelViewMatrix()`. A mod that renders world-space geometry in a stage (selection boxes, outlines, line renderers) translates by the camera position on the stack it gets and now draws rotated against the view. Proposal: a call rewrite row `RenderLevelStageEvent.getPoseStack()` to a helper that returns, per event instance (cache the last event), a fresh `PoseStack` whose last pose is `getModelViewMatrix()` (normal = inverse transpose of its upper 3x3), never the shared stack (vanilla keeps using that one after the event). Not implemented: only a client with a mod that renders in a stage can show whether the extra matrix is right (the projection matrix also changed place: it is a separate argument of the event in both versions). `Stage` itself has every 1.20.1 constant. 2. **`RegisterTextureAtlasSpriteLoadersEvent`** (custom `ITextureAtlasSpriteLoader`s for atlas entries) has no 1.21.1 class: texture loading moved to data-driven `SpriteSource`s. Proposal: a facade event and `ITextureAtlasSpriteLoader` interface in the shim so the mod loads, registrations recorded and logged once, atlas sprites that name such a loader loaded as plain sprites; only mods that ship animated or multi-part sprites through a custom loader lose anything. 3. **Constructors.** Mods that post these events themselves (rare: `RenderGuiEvent`, `RenderLevelStageEvent`, `ScreenEvent.MouseScrolled`, `InputEvent.MouseScrollingEvent`, `ViewportEvent.ComputeCameraAngles`, `ModelEvent.ModifyBakingResult`, `CustomizeGuiOverlayEvent`, `RenderHighlightEvent`) construct them with 1.20.1 argument lists; 1.21.1 takes a `DeltaTracker` instead of a float, two scroll axes, ... Proposal: `` rewrite rows to static factories, only when a mod needs one. 4. **Custom overlays.** `RenderGuiOverlayEvent` is posted for the layers `VanillaGuiOverlay.byLayer` knows; overlays a mod registers itself through `RegisterGuiOverlaysEvent` render as GUI layers but do not get their own Pre/Post. Proposal: wrap each registered overlay in a layer that posts the pair around the mod's `IGuiOverlay` (the facade already knows the registration). ## Found by the same scan outside the client package (not part of this audit, listed for a follow-up) Forge events with no class in 1.21.1 and no facade: `EntityEvent.EyeHeight`, `LivingMakeBrainEvent`, `LivingPackSizeEvent`, `PotionColorCalculationEvent`, `ZombieEvent` and `ZombieEvent.SummonAidEvent`, `BlockEvent.CreateFluidSourceEvent`, `BlockEvent.CropGrowEvent` (+ `Pre`, `Post`). (`TickEvent.*` and `NetworkEvent.*` nested classes show up in a naive scan but are inside facades.) ## Table (client events) Bus is the 1.20.1 bus; "same members" means the public methods (name, parameter and return types by simple name) match the 1.21.1 class, constructors excluded. | Forge 1.20.1 (`net.minecraftforge.client.event.`) | NeoForge 1.21.1 (`net.neoforged.neoforge.client.event.`) | Bus | Mapping | Members | |---|---|---|---|---| | ClientChatEvent | ClientChatEvent | game bus | package move | same members | | ClientChatReceivedEvent | ClientChatReceivedEvent | game bus | package move | same members | | ClientChatReceivedEvent$Player | ClientChatReceivedEvent$Player | game bus | package move | same members | | ClientChatReceivedEvent$System | ClientChatReceivedEvent$System | game bus | package move | same members | | ClientPlayerChangeGameTypeEvent | ClientPlayerChangeGameTypeEvent | game bus | package move | same members | | ClientPlayerNetworkEvent | ClientPlayerNetworkEvent | game bus | package move | same members | | ClientPlayerNetworkEvent$Clone | ClientPlayerNetworkEvent$Clone | game bus | package move | same members | | ClientPlayerNetworkEvent$LoggingIn | ClientPlayerNetworkEvent$LoggingIn | game bus | package move | same members | | ClientPlayerNetworkEvent$LoggingOut | ClientPlayerNetworkEvent$LoggingOut | game bus | package move | same members | | ComputeFovModifierEvent | ComputeFovModifierEvent | game bus | package move | same members | | ContainerScreenEvent | ContainerScreenEvent | game bus | package move | same members | | ContainerScreenEvent$Render | ContainerScreenEvent$Render | game bus | package move | same members | | ContainerScreenEvent$Render$Background | ContainerScreenEvent$Render$Background | game bus | package move | same members | | ContainerScreenEvent$Render$Foreground | ContainerScreenEvent$Render$Foreground | game bus | package move | same members | | CustomizeGuiOverlayEvent | CustomizeGuiOverlayEvent | game bus | package move | members: `getPartialTick()F` changed (return) -> call rewrite row | | CustomizeGuiOverlayEvent$BossEventProgress | CustomizeGuiOverlayEvent$BossEventProgress | game bus | package move | members: `getPartialTick()F` changed (return) -> call rewrite row | | CustomizeGuiOverlayEvent$Chat | CustomizeGuiOverlayEvent$Chat | game bus | package move | members: `getPartialTick()F` changed (return) -> call rewrite row | | CustomizeGuiOverlayEvent$DebugText | CustomizeGuiOverlayEvent$DebugText | game bus | package move | members: `getLeft()ArrayList` changed (return); `getRight()ArrayList` changed (return); `getPartialTick()F` changed (return) -> call rewrite row (existed) | | EntityRenderersEvent | EntityRenderersEvent | mod bus | package move | same members | | EntityRenderersEvent$AddLayers | EntityRenderersEvent$AddLayers | mod bus | package move | members: `getPlayerSkin(String)EntityRenderer` gone; `getSkin(String)LivingEntityRenderer` changed (params); `getEntityRenderer(EntityType)EntityRenderer` gone; `getRenderer(EntityType)LivingEntityRenderer` changed (return) -> call rewrite row | | EntityRenderersEvent$CreateSkullModels | EntityRenderersEvent$CreateSkullModels | mod bus | package move | same members | | EntityRenderersEvent$RegisterLayerDefinitions | EntityRenderersEvent$RegisterLayerDefinitions | mod bus | package move | same members | | EntityRenderersEvent$RegisterRenderers | EntityRenderersEvent$RegisterRenderers | mod bus | package move | same members | | InputEvent | InputEvent | game bus | package move | same members | | InputEvent$InteractionKeyMappingTriggered | InputEvent$InteractionKeyMappingTriggered | game bus | package move | same members | | InputEvent$Key | InputEvent$Key | game bus | package move | same members | | InputEvent$MouseButton | InputEvent$MouseButton | game bus | package move | same members | | InputEvent$MouseButton$Post | InputEvent$MouseButton$Post | game bus | package move | same members | | InputEvent$MouseButton$Pre | InputEvent$MouseButton$Pre | game bus | package move | same members | | InputEvent$MouseScrollingEvent | InputEvent$MouseScrollingEvent | game bus | package move | members: `getScrollDelta()D` gone -> call rewrite row | | ModelEvent | ModelEvent | game bus | package move | same members | | ModelEvent$BakingCompleted | ModelEvent$BakingCompleted | mod bus | package move | same members | | ModelEvent$ModifyBakingResult | ModelEvent$ModifyBakingResult | mod bus | package move | same members | | ModelEvent$RegisterAdditional | ModelEvent$RegisterAdditional | mod bus | package move | members: `register(ResourceLocation)V` changed (params) -> call rewrite row | | ModelEvent$RegisterGeometryLoaders | ModelEvent$RegisterGeometryLoaders | mod bus | package move | members: `register(String,IGeometryLoader)V` changed (params) -> call rewrite row | | MovementInputUpdateEvent | MovementInputUpdateEvent | game bus | package move | same members | | RecipesUpdatedEvent | RecipesUpdatedEvent | game bus | package move | same members | | RegisterClientCommandsEvent | RegisterClientCommandsEvent | game bus | package move | same members | | RegisterClientReloadListenersEvent | RegisterClientReloadListenersEvent | mod bus | package move | same members | | RegisterClientTooltipComponentFactoriesEvent | RegisterClientTooltipComponentFactoriesEvent | mod bus | package move | same members | | RegisterColorHandlersEvent | RegisterColorHandlersEvent | mod bus | package move | same members | | RegisterColorHandlersEvent$Block | RegisterColorHandlersEvent$Block | mod bus | package move | same members | | RegisterColorHandlersEvent$ColorResolvers | RegisterColorHandlersEvent$ColorResolvers | mod bus | package move | same members | | RegisterColorHandlersEvent$Item | RegisterColorHandlersEvent$Item | mod bus | package move | same members | | RegisterDimensionSpecialEffectsEvent | RegisterDimensionSpecialEffectsEvent | mod bus | package move | same members | | RegisterEntitySpectatorShadersEvent | RegisterEntitySpectatorShadersEvent | mod bus | package move | same members | | RegisterGuiOverlaysEvent | RegisterGuiLayersEvent | mod bus | facade in the shim (`legacyconnector/v1_20_1/net/minecraftforge/client/event`), posted from `RenderGuiLayerEvent` | same members | | RegisterItemDecorationsEvent | RegisterItemDecorationsEvent | mod bus | package move | same members | | RegisterKeyMappingsEvent | RegisterKeyMappingsEvent | mod bus | package move | same members | | RegisterNamedRenderTypesEvent | RegisterNamedRenderTypesEvent | mod bus | package move | members: `register(String,RenderType,RenderType)V` changed (params); `register(String,RenderType,RenderType,RenderType)V` changed (params) -> call rewrite row | | RegisterParticleProvidersEvent | RegisterParticleProvidersEvent | mod bus | package move | same members | | RegisterPresetEditorsEvent | RegisterPresetEditorsEvent | mod bus | package move | same members | | RegisterRecipeBookCategoriesEvent | RegisterRecipeBookCategoriesEvent | mod bus | package move | same members | | RegisterShadersEvent | RegisterShadersEvent | mod bus | package move | same members | | RegisterTextureAtlasSpriteLoadersEvent | - | mod bus | removed in 1.21 (sprite loaders became `SpriteSourceType`s in data); see Open items | | | RenderArmEvent | RenderArmEvent | game bus | package move | same members | | RenderBlockScreenEffectEvent | RenderBlockScreenEffectEvent | game bus | package move | same members | | RenderGuiEvent | RenderGuiEvent | game bus | package move | members: `getWindow()Window` gone; `getPartialTick()F` changed (return) -> call rewrite row | | RenderGuiEvent$Post | RenderGuiEvent$Post | game bus | package move | members: `getWindow()Window` gone; `getPartialTick()F` changed (return) -> call rewrite row (existed) | | RenderGuiEvent$Pre | RenderGuiEvent$Pre | game bus | package move | members: `getWindow()Window` gone; `getPartialTick()F` changed (return) -> call rewrite row (existed) | | RenderGuiOverlayEvent | RenderGuiOverlayEvent | game bus | facade in the shim (`legacyconnector/v1_20_1/net/minecraftforge/client/event`), posted from `RenderGuiLayerEvent` | same members | | RenderGuiOverlayEvent$Post | - | game bus | facade in the shim (`legacyconnector/v1_20_1/net/minecraftforge/client/event`), posted from `RenderGuiLayerEvent` | same members | | RenderGuiOverlayEvent$Pre | - | game bus | facade in the shim (`legacyconnector/v1_20_1/net/minecraftforge/client/event`), posted from `RenderGuiLayerEvent` | same members | | RenderHandEvent | RenderHandEvent | game bus | package move | same members | | RenderHighlightEvent | RenderHighlightEvent | game bus | package move | members: `getPartialTick()F` gone -> call rewrite row | | RenderHighlightEvent$Block | RenderHighlightEvent$Block | game bus | package move | members: `getPartialTick()F` gone -> call rewrite row (existed) | | RenderHighlightEvent$Entity | RenderHighlightEvent$Entity | game bus | package move | members: `getPartialTick()F` gone -> call rewrite row | | RenderItemInFrameEvent | RenderItemInFrameEvent | game bus | package move | same members | | RenderLevelStageEvent | RenderLevelStageEvent | game bus | package move | members: `getPartialTick()F` changed (return) -> call rewrite row | | RenderLevelStageEvent$RegisterStageEvent | RenderLevelStageEvent$RegisterStageEvent | mod bus | package move | same members | | RenderLivingEvent | RenderLivingEvent | game bus | package move | same members | | RenderLivingEvent$Post | RenderLivingEvent$Post | game bus | package move | same members | | RenderLivingEvent$Pre | RenderLivingEvent$Pre | game bus | package move | same members | | RenderNameTagEvent | RenderNameTagEvent | game bus | package move | same members | | RenderPlayerEvent | RenderPlayerEvent | game bus | package move | same members | | RenderPlayerEvent$Post | RenderPlayerEvent$Post | game bus | package move | same members | | RenderPlayerEvent$Pre | RenderPlayerEvent$Pre | game bus | package move | same members | | RenderTooltipEvent | RenderTooltipEvent | game bus | package move | same members | | RenderTooltipEvent$Color | RenderTooltipEvent$Color | game bus | package move | same members | | RenderTooltipEvent$GatherComponents | RenderTooltipEvent$GatherComponents | game bus | package move | same members | | RenderTooltipEvent$Pre | RenderTooltipEvent$Pre | game bus | package move | same members | | ScreenEvent | ScreenEvent | game bus | package move | same members | | ScreenEvent$BackgroundRendered | ScreenEvent$BackgroundRendered | game bus | package move | same members | | ScreenEvent$CharacterTyped | ScreenEvent$CharacterTyped | game bus | package move; abstract in 1.21.1: a listener on it fans out to the concrete events (`neoforge-abstract-events.tsv`) | same members | | ScreenEvent$CharacterTyped$Post | ScreenEvent$CharacterTyped$Post | game bus | package move | same members | | ScreenEvent$CharacterTyped$Pre | ScreenEvent$CharacterTyped$Pre | game bus | package move | same members | | ScreenEvent$Closing | ScreenEvent$Closing | game bus | package move | same members | | ScreenEvent$Init | ScreenEvent$Init | game bus | package move | same members | | ScreenEvent$Init$Post | ScreenEvent$Init$Post | game bus | package move | same members | | ScreenEvent$Init$Pre | ScreenEvent$Init$Pre | game bus | package move | same members | | ScreenEvent$KeyPressed | ScreenEvent$KeyPressed | game bus | package move | same members | | ScreenEvent$KeyPressed$Post | ScreenEvent$KeyPressed$Post | game bus | package move | same members | | ScreenEvent$KeyPressed$Pre | ScreenEvent$KeyPressed$Pre | game bus | package move | same members | | ScreenEvent$KeyReleased | ScreenEvent$KeyReleased | game bus | package move | same members | | ScreenEvent$KeyReleased$Post | ScreenEvent$KeyReleased$Post | game bus | package move | same members | | ScreenEvent$KeyReleased$Pre | ScreenEvent$KeyReleased$Pre | game bus | package move | same members | | ScreenEvent$MouseButtonPressed | ScreenEvent$MouseButtonPressed | game bus | package move | same members | | ScreenEvent$MouseButtonPressed$Post | ScreenEvent$MouseButtonPressed$Post | game bus | package move | members: `wasHandled()Z` gone -> call rewrite row | | ScreenEvent$MouseButtonPressed$Pre | ScreenEvent$MouseButtonPressed$Pre | game bus | package move | same members | | ScreenEvent$MouseButtonReleased | ScreenEvent$MouseButtonReleased | game bus | package move | same members | | ScreenEvent$MouseButtonReleased$Post | ScreenEvent$MouseButtonReleased$Post | game bus | package move | members: `wasHandled()Z` gone -> call rewrite row | | ScreenEvent$MouseButtonReleased$Pre | ScreenEvent$MouseButtonReleased$Pre | game bus | package move | same members | | ScreenEvent$MouseDragged | ScreenEvent$MouseDragged | game bus | package move | same members | | ScreenEvent$MouseDragged$Post | ScreenEvent$MouseDragged$Post | game bus | package move | same members | | ScreenEvent$MouseDragged$Pre | ScreenEvent$MouseDragged$Pre | game bus | package move | same members | | ScreenEvent$MouseScrolled | ScreenEvent$MouseScrolled | game bus | package move | members: `getScrollDelta()D` gone -> call rewrite row | | ScreenEvent$MouseScrolled$Post | ScreenEvent$MouseScrolled$Post | game bus | package move | members: `getScrollDelta()D` gone -> call rewrite row (existed) | | ScreenEvent$MouseScrolled$Pre | ScreenEvent$MouseScrolled$Pre | game bus | package move | members: `getScrollDelta()D` gone -> call rewrite row (existed) | | ScreenEvent$Opening | ScreenEvent$Opening | game bus | package move | same members | | ScreenEvent$Render | ScreenEvent$Render | game bus | package move | same members | | ScreenEvent$Render$Post | ScreenEvent$Render$Post | game bus | package move | same members | | ScreenEvent$Render$Pre | ScreenEvent$Render$Pre | game bus | package move | same members | | ScreenEvent$RenderInventoryMobEffects | ScreenEvent$RenderInventoryMobEffects | game bus | package move | same members | | ScreenshotEvent | ScreenshotEvent | game bus | package move | same members | | TextureStitchEvent | - | mod bus | no 1.21.1 class; `TextureAtlasStitchedEvent` (the `$Post` row exists); base class mapped on branch worktree-agent-a715b2d3204d130d2 | | | TextureStitchEvent$Post | TextureAtlasStitchedEvent | mod bus | renamed to `TextureAtlasStitchedEvent` (curated row) | same members | | ToastAddEvent | ToastAddEvent | game bus | package move | same members | | ViewportEvent | ViewportEvent | game bus | package move | same members | | ViewportEvent$ComputeCameraAngles | ViewportEvent$ComputeCameraAngles | game bus | package move | same members | | ViewportEvent$ComputeFogColor | ViewportEvent$ComputeFogColor | game bus | package move | same members | | ViewportEvent$ComputeFov | ViewportEvent$ComputeFov | game bus | package move | same members | | ViewportEvent$RenderFog | ViewportEvent$RenderFog | game bus | package move | same members | | sound/PlaySoundEvent | sound/PlaySoundEvent | game bus | package move | same members | | sound/PlaySoundSourceEvent | sound/PlaySoundSourceEvent | game bus | package move | same members | | sound/PlayStreamingSourceEvent | sound/PlayStreamingSourceEvent | game bus | package move | same members | | sound/SoundEngineLoadEvent | sound/SoundEngineLoadEvent | mod bus | package move | same members | | sound/SoundEvent | sound/SoundEvent | game bus | package move | same members | | sound/SoundEvent$SoundSourceEvent | sound/SoundEvent$SoundSourceEvent | game bus | package move | same members | ## Model locations (`ModelResourceLocation`) In Forge 1.20.1 `ModelResourceLocation extends ResourceLocation` (path plus variant); in 1.21.1 it is an unrelated record (`id`, `variant`). Translated code keeps the 1.20.1 shape: the loader maps the class name to `LegacyModelResourceLocation` (a `ResourceLocation` subclass with the variant; the layer's access transformer opens `ResourceLocation`: `public-f` and the `(String, String)` constructor), so a model location passed as a `ResourceLocation`, stored in generic containers or cast back needs no conversion. Conversion happens only where the legacy code calls into the modern game (rows in `mc-calls.tsv`, `mc-fields.tsv`, `forge-call-rewrites.tsv`, helpers in `ModelLocationCompat`): | 1.21.1 member | what legacy code gets or passes | |---|---| | `ModelEvent.ModifyBakingResult/BakingCompleted.getModels()` | a live `Map` view (`LegacyModelMap`): iteration yields `LegacyModelResourceLocation` keys (plain `ResourceLocation` for standalone models), `get`/`containsKey`/`remove` take legacy keys, plain ids or records, writes go through | | `ModelEvent.RegisterAdditional.register(ResourceLocation)` | plain id -> `ModelResourceLocation.standalone(id)`; a legacy location -> `(id, variant)` | | `ModelManager.getModel(ModelResourceLocation)` / Forge's `getModel(ResourceLocation)` | converted; a plain id looks up the standalone model, then the `inventory` variant | | `BlockModelShaper.stateToModelLocation` (both overloads) | returns `LegacyModelResourceLocation` | | `ItemModelShaper.register(Item, ModelResourceLocation)` | converted | | `ItemRenderer.TRIDENT_IN_HAND_MODEL`, `SPYGLASS_IN_HAND_MODEL`, `ModelBakery.MISSING_MODEL_LOCATION` (now `MISSING_MODEL_VARIANT`) | field rows return the legacy class | Key mapping: legacy key with a variant `ns:path#variant` is the record `(ns:path, variant)`; a plain `ResourceLocation` is the record `(id, "standalone")` (1.21.1 registers additional models as standalone; in 1.20.1 they were plain keys in the same map). Not routed (no mod in the ATM 9 set uses them; add a row when one does): `ItemModelShaper.shapes`, `RegistryAwareItemModelShaper.getLocation`, `BakedModelRenderable.of(ModelResourceLocation)`, `ModelBaker.getTopLevelModel`.