spritecook-use-assets-in-godot

SpriteCook Use Assets In Godot

Use this skill when moving existing SpriteCook assets into Godot. Pair it with spritecook-workflow-essentials for safe downloads and asset manifests. Pair it with spritecook-animate-assets only when animations still need to be generated first.

Prefer the manual path first: most agents can create the Godot animation resource directly from SpriteCook spritesheets, which gives more freedom and avoids extra MCP server work. Use the MCP export endpoint second when the user wants SpriteCook to return a packaged set of files.

Choose A Path

1. Manual Godot setup, preferred: Use SpriteCook animation spritesheets plus metadata to create a Godot SpriteFrames resource and an AnimatedSprite2D node yourself.
2. MCP packaged export: Call export_godot_character_package to get prebuilt text files and asset downloads, then materialize the returned manifest.

Manual AnimatedSprite2D Setup

Use this path when the agent has downloaded SpriteCook animation outputs, has explicit animation asset IDs, or can access spritesheet URLs and frame metadata. The goal is only to make the spritesheets usable as a Godot animation component, not to build gameplay, controllers, playground scenes, or complete demo levels unless the user explicitly asks for those.

Required per animation:

• PNG spritesheet URL or local file.
• Animation name such as idle, walk, attack, jump, fall, hurt, or death.
• Frame width, frame height, frame count, and fps.
• Loop behavior. Loop locomotion/idles; usually do not loop attack, hurt, or death.

Important: use the output spritesheet frame size, not the original source asset size. Detailed animations may return larger frames because SpriteCook adds margin, for example a 512x512 source can produce 640x640 frames.

File Layout

For a new package inside an existing Godot project, use a contained folder and avoid overwriting the user's existing scenes:

SpriteCook/
  assets/
    player_idle.png
    player_walk.png
    player_attack.png
    player_frames.tres