Skip to content

usage_basic.md

Latest commit

 

History

History
73 lines (53 loc) · 4.64 KB

usage_basic.md

File metadata and controls

73 lines (53 loc) · 4.64 KB

Basic Usage

This page explains the basic workflow for placing and playing SpriteStudio animations in your Godot scene.

Note

This page assumes that an .ssab file has already been imported into your Godot project. If you do not have an .ssab yet, first see Asset Import and Editor Integration (editor-based import) or CLI Conversion and Automation (CLI-based import).

Fastest Setup: Auto Node Creation via Drag & Drop

Taking advantage of Godot's powerful editor, you can set up an animation with the shortest possible workflow.

  1. Find the imported .ssab file in the FileSystem dock.
  2. Drag and drop the file into the 2D workspace (Scene view).

This action automatically creates a SpriteStudioPlayer2D node and assigns the resource to it.

Tip

*(※ Short video showing node creation by dragging and dropping an .ssab file will be placed here)*

Manual Node Addition and Attachment

If you want to place the node in a specific location within an existing node hierarchy, you can add it manually and assign the resource.

  1. Add a SpriteStudioPlayer2D node to your scene tree using the "+" button in the Scene dock.
  2. Select the added node and open the Inspector.
  3. Drag and drop the .ssab file from the FileSystem dock into the SSAB Resource property box in the Inspector to attach it.

Inspector Settings and Preview

Once the node is selected, you can adjust various settings from Godot's Inspector.

  1. Select an Animation Open the dropdown for the Animation property in the Inspector. You will see a list of animations contained in the .ssab. Select the name of the animation you want to play.

  2. In-Editor Preview With the node selected, the SpriteStudio bottom panel appears. Use its transport controls (play from start / play from current / stop and the frame scrubber) to play the animation directly in the editor without running the game. Keyboard shortcuts mirror the AnimationPlayer editor: D play from current, Shift+D play from start, S stop (active while the panel is visible). Changes to parameters like Frame, Speed, and Loop Count are reflected in the preview in real-time, enabling quick adjustments.

Tip

*(※ Video showing the animation preview via the SpriteStudio bottom panel will be placed here)*

Main Inspector Properties

Property Type Description
SSAB Resource Resource The target SSABResource (.ssab file) to play
Animation String The name of the currently selected animation
Autoplay bool Whether to play automatically when the game starts
Offset Vector2 Drawing offset. Useful to shift visuals without changing the Node Transform
Flip H / Flip V bool Horizontal / Vertical flip of the animation
Frame float The current frame position
Speed Scale float Playback speed multiplier (Default: 1.0)
Frame Rate int FPS
Loop Count int Number of loops (-1 for infinite loop)
Animation Section Start int Start frame for partial playback
Animation Section End int End frame for partial playback
Playback Direction int Playback direction
Playback Style int Playback style (e.g., One-way, Ping-pong)
Frame Skip Enabled bool Whether to skip frames when the draw interval exceeds the frame interval
Sub Frame Enabled bool Whether to enable sub-frame interpolation
Animation Process Mode int Whether to sync with _physics_process (Physics) or _process (Idle)