/godot-version-migration

Migration notes: godot-tweening

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

• AnimationNode._process requires new test_only parameter; blend_input/blend_node gain optional test_only.
• AnimationNodeStateMachinePlayback.get_travel_path returns Array[StringName].
• PathFollow2D.lookahead removed.
• SubViewportContainer.mouse_filter must be STOP/PASS for input to reach SubViewports.
• Layered SubViewportContainers needing mouse input may need Area2D replacements.
• CodeEdit.add_code_completion_option gains location; Tree edit_selected gains force_edit.

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.
• PopupMenu shortcut helpers gain allow_echo; clear gains free_submenus.
• GraphEdit: arrange_nodes_button_hidden → show_arrange_button; snap props renamed; get_zoom_hbox → get_menu_hbox.
• GraphNode: large API move to GraphElement; connection query methods removed; comment/show_close removed.

4.2 → 4.3

Official: Upgrading to Godot 4.3

• 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.
• Default font outline color is black (was white).
• auto_translate deprecated for Node auto_translate_mode (inherit semantics).
• AcceptDialog register/remove helpers take LineEdit/Button specifically.

4.3 → 4.4

Official: Upgrading to Godot 4.4

• GraphEdit.connect_node gains keep_alive; frame_rect_changed uses Rect2.

4.4 → 4.5

Official: Upgrading to Godot 4.5

• CanvasItem/Font/TextLine draw APIs gain optional oversampling.
• TreeItem.add_button gains alt_text.

4.5 → 4.6

Official: Upgrading to Godot 4.6

• AnimationPlayer assigned_animation / autoplay / current_animation are StringName (C# binary break).
• get_queue returns StringName[].
• Control.grab_focus / has_focus gain hide-focus options.
• FileDialog.add_filter gains mime_type; SplitContainer.clamp_split_offset gains priority_index.
• EditorFileDialog file APIs moved onto FileDialog base; add_side_menu removed.
• PopupMenu.submenu_popup_delay default 0.2 (was 0.3).

4.6 → 4.7

Official: Upgrading to Godot 4.7

• Animation.length uses double metadata (C# impact).
• AnimationNodeBlendSpace1D/2D.add_blend_point optional name.
• LookAtModifier3D.relative default is false (was true).
• Control.accessibility_live uses AccessibilityServer.AccessibilityLiveMode.
• TreeItem.select gains set_as_cursor.
• CanvasItem no longer adds antialiasing feather that thickened lines — widen strokes if visuals relied on it.