@galacean/engine-spine is the Spine runtime module for the Galacean engine, providing efficient support for Spine animations. This package enables developers to seamlessly integrate and use Spine animations, delivering smooth skeletal animation effects optimized for both web and mobile platforms.
Install @galacean/engine-spine via npm:
npm install @galacean/engine-spineHere's a simple example to get started with @galacean/engine-spine:
import { SpineAnimationRenderer } from '@galacean/engine-spine';
// First setup for galacean engine, get scene and create root entity.
// Find setup code here:
// And then load spine resource and instantiate a spine entity with the resource.
const spineResource = await engine.resourceManager.load({
url: 'https://mdn.alipayobjects.com/huamei_kz4wfo/uri/file/as/2/kz4wfo/4/mp/yKbdfgijyLGzQDyQ/spineboy/spineboy.json',
type: 'spine',
});
const spineEntity = spineResource.instantiate();
rootEntity.addChild(spineEntity);For a detailed overview of the API, including all classes, methods, and properties, please refer to the Full API Documentation.
| Package Version | Spine Version |
|---|---|
| Below 4.0 | Spine 3.8 |
| 4.0 | Spine 4.0 |
| 4.1 | Spine 4.1 |
| 4.2 | Spine 4.2 |
| 4.x (e.g., 4.0, 4.1) | Corresponds to Spine x.x |
4.x.y (minor version y) |
Independent from Spine |
Note: Ensure that the package version aligns with the corresponding Spine editor version for compatibility.
| Package Version | Galacean Engine Version |
|---|---|
| 4.0 and above | 1.3 and above |
| Below 4.0 (e.g., 1.2.0) | 1.2 |
Note: Please verify that the versions of both the package and the Galacean Engine are compatible, as mismatched versions may cause unexpected issues.
To set up the project for development and build it for production, follow these steps:
- Install dependencies:
npm install- Start development environment:
npm run dev- Build for production:
npm run build- Run examples:
npm run example- Examples - View usage examples for common scenarios.
- User Guide - Comprehensive guide for using this package within the Galacean editor and in scripts.
- API Reference - Complete API documentation for all available classes, methods, and properties.
The Galacean Engine is released under the MIT license. See LICENSE file.