Spine JSON / SKEL 版本转换指南

项目里的 Spine 资源版本或骨骼格式不一致时,可以用 SpineSlim 的「资源处理」统一转换。默认模式快速升级 JSON 到 4.2.11;高级模式支持 JSON / SKEL 升级、降级和输出格式转换。

操作步骤

1. 1

   准备素材目录

   把需要转换的 Spine 资源(JSON / SKEL、Atlas、贴图)放在同一个源目录里。SpineSlim 会递归处理并保留相对层级,同时按处理选项复制或转换 Atlas 与贴图。

2. 2

   准备外部工具

   版本转换依赖 SpineSkeletonDataConverter。完整安装包提供该工具;也可在 SpineSlim 设置中检测或指定路径。如果同时转换纹理,按所选格式准备 ImageMagick 等工具。

3. 3

   进入「资源处理」,选择目录

   选择 Spine 源目录,再选一个独立的目标目录。不要把目标目录指向正在使用的工程目录,因为成功提交后会替换旧的输出。

4. 4

   选择转换方式

   只需统一 JSON 时,使用默认的「升级至 4.2.11」。需要处理 SKEL、降级或指定补丁版本时,选择「指定目标版本(高级)」。

5. 5

   设置目标版本与格式

   高级模式接受 3.5–3.8、4.0–4.2 范围内的完整 x.y.z 版本号。输出格式可以保持源文件格式,也可以统一为 JSON 或 SKEL。

6. 6

   开始处理并查看日志

   处理时会校验目标版本和输出重名,显示当前文件、转换阶段进度与日志。SpineSlim 先在临时目录处理,转换成功后再提交结果。

7. 7

   检查输出

   默认升级结果位于 program/spine;高级转换写入独立的 program/spine-converted,不会覆盖源目录和现有 program/spine。务必在目标 Spine Runtime 中检查动画、Atlas 与贴图。

注意事项

• 默认模式把 Spine JSON 升级至 4.2.11;高级模式可处理 JSON 与 SKEL。
• 高级模式接受 3.5–3.8、4.0–4.2 范围内的完整 x.y.z 目标版本,支持升级与降级。
• 高级模式可保持源骨骼格式,或统一输出 JSON / SKEL。
• 降级可能改变高版本曲线、约束和时间线,必须在目标 Spine Runtime 中验证。
• 再次运行高级模式会替换已有的 program/spine-converted 内容,请先保留需要的结果。
• 转换使用完整安装包提供的 SpineSkeletonDataConverter;第三方工具遵循各自许可。
• SpineSlim 是独立的第三方项目,与 Spine 官方无关联。Spine Runtime 的使用与分发适用其自身许可。

常见问题

SpineSlim 能转换 .skel 文件吗?

可以。请使用高级模式,指定目标版本后选择保持原格式或输出 JSON / SKEL。默认的 4.2.11 快速升级仍针对 JSON。

Spine 4.2 能降级到 3.8 吗?

高级模式支持在 3.5–3.8、4.0–4.2 范围内指定目标版本并降级,但新版本曲线、约束和时间线可能发生变化,必须在 3.8 Runtime 中验证。

转换会覆盖我的原始文件吗?

不会改写源目录。高级转换写入 program/spine-converted,但再次运行会替换该输出目录已有内容。

输出可以从 JSON 改成 SKEL 吗?

可以。高级模式可保持源格式,也可统一输出 JSON 或 SKEL。