跳至正文
OpenAgentSkill
浏览已开放 · 目录记录日期 2026-11-21 · 自动更新和账户服务暂时关闭。
视频与音频

godot-animation-player

Expert patterns for AnimationPlayer including track types (Value, Method, Audio, Bezier), root motion extraction, animation callbacks, procedural animation generation, call mode optimization, and RESET tracks. Use for timeline-based animations, cutscenes, or UI transitions. Trigger keywords: AnimationPlayer, Animation, track_insert_key, root_motion, animation_finished, RESET_track, call_mode, animation_set_next, queue, blend_times.

thedivergentai · 已有 AI 审核记录

安装与使用

运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。

npx skills add thedivergentai/GD-Agentic-Skills --skill godot-animation-player

技能说明


name: godot-animation-player description: "Expert patterns for AnimationPlayer including track types (Value, Method, Audio, Bezier), root motion extraction, animation callbacks, procedural animation generation, call mode optimization, and RESET tracks. Use for timeline-based animations, cutscenes, or UI transitions. Trigger keywords: AnimationPlayer, Animation, track_insert_key, root_motion, animation_finished, RESET_track, call_mode, animation_set_next, queue, blend_times."

AnimationPlayer

Timeline-based keyframe animation: track choice, RESET, root motion, libraries — scripts own recipes.

NEVER Do

  • NEVER forget RESET tracks — Animated properties otherwise stick across scene changes.
  • NEVER use Animation.CALL_MODE_CONTINUOUS for one-shot logic — Use CALL_MODE_DISCRETE.
  • NEVER animate embedded resource properties directly — Prefer instance uniforms / owned materials.
  • NEVER use animation_finished for looping clips — Use animation_looped or poll current_animation.
  • NEVER hardcode animation name strings at scale — Constants / StringName.
  • NEVER seek() without update=true when same-frame reads matter.
  • NEVER leave off-screen visual-only players active — Cull with notifiers.
  • NEVER mutate a playing AnimationLibrary — Stop / wait for finished first.
  • NEVER rely on speed_scale for long sync — Prefer seek() against a shared clock.

Available Scripts (MANDATORY triggers)

Open the matching script before implementing that pattern. Deep recipes: track-authoring.md, root-motion-and-sequences.md, edge-cases.md.

NeedScript
Method-track hit/state keysmethod_track_logic.gd
Stance/weapon library swapruntime_anim_lib_swapper.gd
Shader uniform timelinesdynamic_shader_animation.gd
Runtime track tweakprocedural_track_modifier.gd
Forced RESET orchestrationreset_track_orchestrator.gd
Bezier → procedural drivebezier_curve_extraction.gd
Off-screen active cullactive_animation_culler.gd
Root motion ↔ physicsroot_motion_physics_sync.gd
Part/equipment trackscharacter_part_swapper_tracks.gd
TYPE_AUDIO footstep syncprecise_audio_sync.gd
Queue/branch sequencesanimation_sequencer.gd
Code-built Animation resourcesprogrammatic_anim.gd
Alt audio-track setup notesaudio_sync_tracks.gd

Critical WHY (keep in body)

  • CALL_MODE_CONTINUOUS invokes the method every frame across the key span — one-shot hitboxes/VFX need CALL_MODE_DISCRETE.
  • Animating embedded sub-resource properties (e.g. material.albedo_color) duplicates resources into the scene — use instanced materials / shader_parameter/* tracks.
  • animation_finished does not fire on looping clips — use animation_looped or poll current_animation.
  • Mutating a playing AnimationLibrary crashes or leaves bad transforms — stop or await finished before swap.
  • speed_scale drifts for rhythm/multiplayer — shared-clock seek(t, true) for long sync.

Track decision matrix

TrackUse whenAvoid when
ValueAnimate properties (pos, modulate, uniforms)One-off runtime juice → Tween
MethodHitboxes, SFX hooks, state flips at timestampsCONTINUOUS call mode / missing method on path
AudioFootsteps / VO locked to framesLoose AudioStreamPlayer.play() drift
BezierCustom easing curves sampled at runtimeSimple linear fades

Track authoring samples → track-authoring.md.

Root motion (physics)

CharacterBody3D + Skeleton3D + AnimationPlayer: extract with get_root_motion_position() / rotation on the physics tick — root_motion_physics_sync.gd. Walk cycles that only move bones leave the body collider behind.

Sequences, blends, RESET

  • Chain: animation_set_next / queue / animation_sequencer.gd.
  • Blend times for walk↔run polish; play("run", -1, 1.0, 0.5) or set_default_blend_time.
  • Always author a RESET clip with defaults; enable Reset on Save when editing.
  • Reverse playback: play("clip", -1, -1.0) for doors/cinematic rewind.

Full recipes → root-motion-and-sequences.md.

AnimationPlayer vs Tween

NeedPrefer
Timeline / many properties / reusableAnimationPlayer
One-shot runtime / interruptibleTween (godot-tweening)

Expert architecture (scripts)

PatternScriptWHY
Shared humanoid librariesruntime_anim_lib_swapper.gdOne library, many models — play lib/clip
Decoupled timeline eventsmethod_track_logic.gdMethod track → signaler → gameplay listeners
Off-screen CPU budgetactive_animation_culler.gdactive = false or manual advance()
Code-built clipsprogrammatic_anim.gdDynamic targets not in FBX

Reference

Progressive disclosure: open Official Documentation links only when researching a specific API; load Related Skills when routing work to a peer domain — do not pr

阅读完整来源 ↗