export_godot_spriteframes
Destructive
Export an Aseprite sprite to a Godot 4 SpriteFrames .tres resource with a packed PNG sheet, JSON metadata, and AtlasTexture animations per tag.
Instructions
Export a sprite as a Godot 4 SpriteFrames resource (.tres) + a packed sheet.
Produces three files: a packed PNG sprite sheet, its JSON frame/tag metadata, and a
``SpriteFrames`` .tres that references the sheet via ``AtlasTexture`` regions, one
Godot animation per Aseprite tag (or a single ``default`` animation if untagged), with
per-frame timing taken from Aseprite frame durations.
v1 emits ``SpriteFrames`` only (no pivot/origin/hitbox/9-slice). Aseprite tag direction
isn't represented (Godot animations only loop or not); ``default_loop`` is applied to all.
Args:
output: Destination .tres path (workspace-relative).
sheet_output: Sheet PNG path. Defaults to ``<output stem>.png`` beside the .tres.
scale: Integer upscaling factor for the sheet.
texture_res_path: The ``res://`` path of the sheet inside your Godot project (the
AtlasTexture atlas). Defaults to ``res://<sheet filename>`` (same-folder import).
default_loop: ``loop`` flag for every generated animation (default True).
overwrite: Replace existing outputs (default False = no-clobber). All three targets
are validated up front, so nothing is written if any already exists.
Returns a ``workflow_manifest.v1`` manifest (kind ``engine_preset``).
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| scale | No | Default: 1. | |
| output | Yes | ||
| filename | Yes | ||
| overwrite | No | Default: false. | |
| default_loop | No | Default: true. | |
| sheet_output | No | ||
| texture_res_path | No |