Spine

Using in the Editor

This section introduces how to import Spine animation assets into the Galacean editor.

For details on Spine and engine version compatibility, see: Version/Performance Section

1. Export Assets from Spine Editor

The first step is to export your Spine animation assets from the Spine editor. Complete steps can be found in the Spine User Guide:

  1. Export skeleton and animation data
  2. Export texture atlases containing skeleton images

Below is a brief workflow for exporting Spine assets:

  1. After completing your animation, click Spine Menu > Export to open the export window.

    Export panel in Spine editor
  2. Select Binary in the top-left corner of the export window (Recommended: Binary format reduces file size and improves loading speed compared to JSON).

    Export window in Spine editor
  3. Check the Texture Atlas Packing checkbox.

    Click packing texture atlas button in Export window
  4. Click Pack Settings.
    This refers to texture packing settings. For configuration details, refer to the official documentation. After configuring, click OK.

    Texture pack window in Spine Editor
  5. Return to the export window, select an export folder, then click Export.

    Click export button in texture pack window
  6. After exporting, you will get three files:

    Spine assets in folder
    • spineboy.skel: Contains skeleton structure and animation data, the core information for binding animations to bones.
    • spineboy.atlas: Stores texture atlas information, including position and size details for each texture in the atlas.
    • Texture images: May include multiple pages of images representing the atlas for rendering the character’s visual content.

2. Import Assets into Galacean Editor

After opening the editor, drag the exported files directly into the Asset Panel to complete the upload, as shown in the following animation:

Drag spine assets into Galacean editor

After uploading, the asset panel will display the uploaded Spine assets, including: SpineSkeletonData asset, SpineAtlas asset, and texture assets.

SpineSkeletonData Asset

Spine skeleton data asset icon

The SpineSkeletonData asset stores skeleton data and references the generated SpineAtlas asset.
Clicking the asset allows you to preview the Spine animation in the inspector, where you can switch between skins and animation clips:

Spine skeleton data preview

SpineAtlas Asset

Spine atlas asset

The SpineAtlas asset stores the texture atlas file and references required Texture assets.
Clicking the asset allows you to view its referenced textures and Spine atlas information in the inspector:

Spine atlas preview

Asset Updates

To update your Spine assets, re-export them from the Spine editor and re-import into the Galacean editor to overwrite existing files.

Next Section: Adding and Using

Was this page helpful?