spine_build_animation_from_existing_project
Adds simple keyframe animations to existing Spine skeletons by interpreting a natural-language goal and using learned presets, outputting a playable .spine project.
Instructions
Build simple animation keyframes on an existing Spine JSON or .spine project. Writes to outputDir, imports into .spine, exports, and can open the result. Requires sourceJsonPath or spineProjectPath. Not for mesh, IK, weights, or UI automation.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| userGoal | Yes | Natural-language animation goal. The tool uses this with learned corpus presets to choose simple keyframes for the existing skeleton. | |
| imagesDir | No | Optional folder containing images referenced by sourceJsonPath. When provided, it is copied to outputDir/images and the generated JSON uses that images folder. | |
| outputDir | Yes | Directory where the modified JSON, imported .spine project, copied images, and exported files should be written. | |
| overwrite | No | When false, stop if outputDir already exists. When true, overwrite generated files inside outputDir without deleting files outside it. | |
| exportMode | No | Deprecated alias for exportSettingsPath. Must be a Spine export settings .json file path. Mode strings like "json" or "json+pack" are not accepted by Spine 3.8.75. | |
| projectName | Yes | Project file base name to generate inside outputDir, without path separators. | |
| knowledgeDir | No | Directory containing learned knowledge files. Defaults to G:\spine-mcp\knowledge. If missing, built-in fallback presets are used. | G:\spine-mcp\knowledge |
| characterType | No | Character category used to choose default layout and animation presets. | |
| openAfterBuild | No | When true, open the generated .spine project after import/export without waiting for Spine to exit. | |
| sourceJsonPath | No | Optional existing Spine JSON file, for example a Photoshop to Spine exported skeleton JSON. When provided, this takes precedence over spineProjectPath. | |
| spineProjectPath | No | Optional existing .spine project. When sourceJsonPath is not provided, the tool exports this project to temporary JSON first using the Spine CLI. | |
| exportSettingsPath | No | Path to a Spine export settings .json file used with -e. If omitted, tools that can build a .spine project skip the final export step. | |
| sourceExportSettingsPath | No | Path to a Spine export settings .json file used to export spineProjectPath to JSON before analysis. Required when using spineProjectPath unless exportSettingsPath/exportMode also points to a JSON export setting. |