Model Change Preservation for Game Creator 2

<aside> 🧩

Preserve animation, equipment, IK, footsteps, and GC2 runtime context when a Character changes model.

Model Change Preservation for Game Creator 2 is a standalone Unity 6+ compatibility module that wraps Game Creator 2's normal model-change lifecycle without modifying official GC2 source.

</aside>

Package snapshot

Item	Details
Module version	1.9.1
Unity target	Unity 6+
Required GC2 dependency	Game Creator 2 Core
Optional integrations	Shooter, Melee, Traversal, Inventory, Dialogue, plus other Core-based modules
Runtime assembly dependency	`GameCreator.Runtime.Core` only
Editor assembly dependencies	This module Runtime + `GameCreator.Runtime.Core` • `GameCreator.Editor.Core`
Official GC2 source changes	None

What this module solves

Game Creator 2 rebuilds a Character's animation PlayableGraph when its model changes. That rebuild can interrupt active State layers and temporary Gestures, invalidate model-bound IK caches, and leave equipment or module-specific references pointing at the previous model instance.

Model Change Preservation captures the relevant runtime state before the swap, lets Game Creator Core perform its normal Character.ChangeModel() flow, then restores animation state and repairs references against the replacement Animator and skeleton.

Capability summary

Surface	Count	Purpose
MonoBehaviour component	1	Model Change Preservation — central capture, restore, diagnostics, IK and prop repair
Visual Scripting Instructions	1	Change Model (Seamless) — visual hold + safe replacement reveal around Core's official model change
Footstep Detector types	1	Model-Safe Footstep Detector — rebinds foot bones after Animator/model replacement
Visual Scripting Conditions	0	Not required by the current feature set
Visual Scripting Properties	0	Runtime diagnostics are exposed through the component and C# API
Visual Scripting Triggers / Events	0	The component exposes C# restore lifecycle events instead

What is preserved

Animator culling safety on both outgoing and incoming Animators by forcing AnimatorCullingMode.AlwaysAnimate when enabled.
Base Animator Controller pose including layer state, normalized time, layer weights, and Float/Int/Bool parameters.
Persistent GC2 State layers including controller progress and the active outer blend weight.
Active GC2 Gestures such as reloads, jump spins, dodges, reactions, attacks, and Traversal entry/exit clips.
Awaited Gesture completion so code already awaiting Gestures.CrossFade can continue correctly after the old graph is destroyed.
Animation phase binding to the replacement Animator.
Character IK model caches, including Lean with Momentum repair and Humanoid rig checks.
Core Combat prop references and Shooter weapon context.
Inventory equipped RuntimeItem prop references, including refreshed Prop.Setup(runtimeItem) socket context when Inventory is installed.
Footstep detector bone bindings when the Model-Safe Footstep Detector is selected.

Package snapshot

What this module solves

Capability summary

What is preserved

Safety boundaries