用途:为 Godot 项目提供程序化补间动画的专家蓝图,覆盖平滑属性过渡、UI 特效、镜头运动与「手感」增强,并给出 Tween 与 AnimationPlayer/AnimationTree 的选型决策树。
主要能力:按场景给出选择依据——一次性 UI 特效、悬停、弹窗、计分、后坐力用 create_tween;可拖拽时间轴、多轨剪辑、混合树用 AnimationPlayer/AnimationTree;相机持续跟随移动目标不用 Tween,而用 Camera2D.position_smoothing 或弹簧跟随;暂停菜单在 time_scale == 0 时用 set_ignore_time_scale(true);可重复触发的属性动画需先 kill 再重建;物理体或网络校正运动使用 TWEEN_PROCESS_PHYSICS 并 reset_physics_interpolation。列出可用脚本:safe_tween_interruption.gd、time_scale_ignored_ui.gd、nested_subtween_cutscene.gd、parallel_popup_animation.gd、text_counter_method_tween.gd、custom_curve_tween.gd、camera_shake_tween_logic.gd、relative_recoil_tween.gd、staggered_inventory_entry.gd、looped_hover_vfx.gd、juice_manager.gd / tween_builder.gd,并标注每种场景的必需脚本。
使用方式:核心生命周期模式为先判断并 kill 有效 Tween,再 create_tween().bind_node(self),设置 EASE_OUT + TRANS_QUAD,再 tween_property。相机持续跟随示例:在 _ready 中开启 position_smoothing_enabled 并设速度,在 _physics_process 中直接同步 global_position。物理同步示例:先设位置、调用 reset_physics_interpolation,再 create_tween().bind_node(target),set_process_mode(Tween.TWEEN_PROCESS_PHYSICS),最后 tween_property。另有 Juice 配置资源化、Tween 事件排序、用 PathFollow2D.progress_ratio 的贝塞尔路径补间等模式。
限制与禁止事项:禁止用 Tween.new() 实例化,必须用 create_tween() 或 get_tree().create_tween();禁止复用已结束的 Tween;禁止手动实例化 PropertyTweener 或 CallbackTweener;禁止只含 0 时长动画的无限循环;禁止多个 Tween 同时动画同一属性;禁止用线性插值做 UI/手感;禁止在 _process 中无保护地创建 Tween;非全局 Tween 禁止跳过 bind_node(self);状态变化禁止用 0 时长 Tween。资料未提供具体安装命令、价格与平台信息。