Skip to content

Legacy 1.20.1 Client Events

github-actions[bot] edited this page Nov 17, 2026 · 2 revisions

Legacy 1.20.1: client events

Part of the 1.20.1 pipeline notes (Legacy-1.20.1-Estimate, 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)ret<TAB>helper; 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 ITextureAtlasSpriteLoaders for atlas entries) has no 1.21.1 class: texture loading moved to data-driven SpriteSources. 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: <init> 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 SpriteSourceTypes 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<ResourceLocation, BakedModel> 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.

Clone this wiki locally