animated-texture-vfx-workflow

name	animated-texture-vfx-workflow
description	Operational workflow for selecting and integrating SpriteFrames, flipbooks, and lightweight animated texture effects without custom timer-heavy systems.
tier	operational
godot_version	4.6+
doc_anchors	["godot-docs/classes/class_animatedsprite2d.rst","godot-docs/classes/class_spriteframes.rst","godot-docs/tutorials/2d/particle_systems_2d.rst","godot-docs/classes/class_atlastexture.rst","godot-docs/tutorials/performance/general_optimization.rst"]
tags	["vfx","textures","animation"]
depends_on	["godot-skills/godot-secondary/domain-rendering-visuals/SKILL.md","godot-skills/godot-tertiary/presentation-event-pipeline-contract/SKILL.md"]

Animated Texture VFX Workflow

Use When

• Building 2D visual effects from atlas/flipbook resources.
• Replacing ad hoc frame-timer scripts for UI or character effects.
• Optimizing repeated short-lived VFX bursts.

Outcomes

• Visual effect technique selection is explicit per effect category.
• Animated texture resources are reusable and memory-efficient.
• Runtime effect spawning avoids avoidable instancing churn.

Required Rules

• Use SpriteFrames/AnimatedSprite2D for named clip-style animation surfaces.
• Use particle flipbook paths for dense ambient/burst effects where suitable.
• Keep event-driven effect triggering separate from gameplay mutation.
• Reuse shared animation resources; avoid duplicate per-prefab frame sets.

Workflow

1. Classify target effect as clip, particle flipbook, or shader-driven exception.
2. Author or import texture resources with correct atlas/flipbook settings.
3. Bind effect triggers to presentation events instead of per-frame polling.
4. Pool high-frequency burst effects and tune emission/instance caps.
5. Validate visual quality and runtime overhead under stress scenes.

Validation

• Reused animation resources are shared across instances where intended.
• Burst effect scenario stays inside performance budget.
• Disabling presentation effects does not alter gameplay outcomes.

Failure Modes

• Per-instance duplicated SpriteFrames inflate memory unexpectedly.
• Flipbook import settings produce blur/shimmer artifacts.
• UI/VFX animation relies on broad _process() polling and scales poorly.

Local Doc Anchors

• godot-docs/classes/class_animatedsprite2d.rst
• godot-docs/classes/class_spriteframes.rst
• godot-docs/tutorials/2d/particle_systems_2d.rst
• godot-docs/classes/class_atlastexture.rst
• godot-docs/tutorials/performance/general_optimization.rst