/godot-version-migration

Migration notes: godot-genre-sports

Incremental upgrade for topics this skill covers. Apply one hop, stabilize/test, then next. Never skip hops.

If the project is < 4.0, follow godot-version-migration era bridges (legacy → 3→4) until 4.0, then these hops. Official 3→4: Upgrading from Godot 3 to Godot 4.

4.0 → 4.1

Official: Upgrading to Godot 4.1

• Area3D.priority type is int (was float).
• PhysicsDirectSpaceState3D.collide_shape returns Array[Vector3].
• Geometry3D.segment_intersects_convex takes Array[Plane].
• AnimationNode._process requires new test_only parameter; blend_input/blend_node gain optional test_only.
• AnimationNodeStateMachinePlayback.get_travel_path returns Array[StringName].

4.1 → 4.2

Official: Upgrading to Godot 4.2

• Many AnimationPlayer/AnimationTree APIs moved to AnimationMixer base.
• method_call_mode → callback_mode_method; playback_process_mode/process_callback → callback_mode_process.
• playback_active → active on mixer; AnimationTree.tree_root typed as AnimationRootNode.
• AnimationPlayer.seek gains optional update_only.

4.2 → 4.3

Official: Upgrading to Godot 4.3

• If the genre uses TileMap, migrate to TileMapLayer nodes before relying on layer APIs.
• If the genre ships multiplayer, upgrade all peers to 4.3 together (SceneMultiplayer protocol).
• PhysicsShapeQueryParameters3D.motion is Vector3 (was Vector2).
• Animation interpolate / track_find_key gain backward/limit options.
• AnimationMixer._post_process_key_value object arg is uint64.
• Skeleton3D.bone_pose_changed → skeleton_updated; BoneAttachment3D.on_bone_pose_update → on_skeleton_update.
• Capture mode replaced; see Migrating Animations 4.0→4.3 article for blend/time semantics.

4.3 → 4.4

Official: Upgrading to Godot 4.4

• SoftBody3D.set_point_pinned gains optional insert_at.

4.4 → 4.5

Official: Upgrading to Godot 4.5

• Jolt: physics/jolt_physics_3d/simulation/areas_detect_static_bodies removed — Areas always report static overlaps; filter via layers/masks.

4.5 → 4.6

Official: Upgrading to Godot 4.6

• Retune Environment glow/fog if the genre leans on bloom-heavy looks.
• New projects default 3D physics engine to Jolt — existing projects keep prior setting; verify Jolt differences before shipping.
• AnimationPlayer assigned_animation / autoplay / current_animation are StringName (C# binary break).
• get_queue returns StringName[].

4.6 → 4.7

Official: Upgrading to Godot 4.7

• Confirm project stretch mode and AudioStreamPlayer area_mask after opening in 4.7.
• Jolt: WorldBoundaryShape3D.plane.d sign convention flipped vs 4.6 — negate if boundaries moved.
• Jolt: SoftBody3D default mass is 1 kg for the body (not 0 → per-point auto mass); retune stiffness/damping.
• Jolt: Area3D reports overlaps with SoftBody3D — adjust layers/masks if undesired.
• Animation.length uses double metadata (C# impact).
• AnimationNodeBlendSpace1D/2D.add_blend_point optional name.
• LookAtModifier3D.relative default is false (was true).