Spine-Unity 3.7 to 3.8 Upgrade Guide

Harald

The basic steps of both upgrades can be combined to a single upgrade from 3.6 to 3.8.
Of course you have to adapt to code changes that happened from 3.6 to 3.7 as well, e.g. if you were using SkeletonAnimator in code, change it to SkeletonMecanim.

Just have a look at the changes that were introduced from 3.6 to 3.7 here:
Spine-Unity 3.6 to 3.7 Upgrade Guide

PandMEntertm

Thank you Harald!

After updating to 3.8, I got a lot of errors.

Updated your Spine-Unity runtime to 3.8 according to your guide.
Most of the problems have been solved successfully, but there is one problem.

Like the attached image, there are a lot of errors in "Assets \ Spine \ Runtime \ spine-unity \ Components \ SkeletonGraphic.cs" and I can't test the game.
Do you know this issue?
How can I solve this problem?

And I'm currently using Unity version 2019.3.0a5.
If the cause is in the Unity version, is there a version you recommend?

A couse of error is that class or namespace "MaskableGraphic" does't exist in Asset.

Harald

PandMEntertm wrote
And I'm currently using Unity version 2019.3.0a5.

Sorry to hear that you are facing problems. Thanks for providing the version info, that is exactly the reason why you receive these errors: Unity 2019.3 alpha is not supported by Spine yet. That is the reason why we state Compatible with Spine 3.8.x and Unity 2017.1-2019.2 on the download page and in the changelog.

We recommend using Unity 2019.2 in your case, but in general any Unity version listed as supported will be a good choice.

PandMEntertm

Dear Harald,
As you advised, I downgraded Unity.
A large amount of Prefab data has been corrupted, but the Spine animation can now be played back safely.
Thank you for your constant support.

I hope that all versions of Unity will be supported over time.

Also, I will take care not to inadvertently update Unity.

Harald

Prefab data has been corrupted by your Unity downgrade? That sounds terrible, sorry to hear that.

In general we will always strive to support the latest non-beta (and non-alpha) Unity versions when they are released. Unfortunately alpha versions will be too unstable for us (API wise it might change) to depend our code on too early.

Vladyslav

Hello,
I'm unity3d c# programmer, but I have few spine animation, from different versions 3.7 and 3.8. How I can use it in one project without re-export. I dont have Spine, I ordered this animations. Thanks for a reply)

Nate

I'm afraid you must export from the version of Spine that matches the version of the runtime you are using. You could try using the JsonRollback tool to make 3.8 JSON compatible with 3.7 runtimes, but this is not officially supported:
Open project in an older version

Also please note that using the Spine Runtimes without a Spine license has restrictions: all users of your application will need their own Spine license. Read more here:
Spine Runtimes License Agreement

PandMEntertm

Thank you always, Harald.
My prefab was able to be restored with almost no damage the way I found it on the net.

But I still have problems.
I have a license for the latest version of Spine.
If you try to import a character created with it into Unity 2019.2.01f by drag and drop, Unity will crash.
However, deleting the imported file from Windows Explorer will no longer crash.

This problem happen only the case of Spine exported files, not other files(for example, png files).

Do you know how to solve this problem?
Did you also recognize this issue?
Please give me some advice.

P.S.
My problem is the same case of below URL:
Unity Crashes when importing spine files

Harald

Sorry to hear that. Unfortunately I could not reproduce this problem, using the latest unitypackage (spine-unity-3.8-2019-08-15.unitypackage) and data exported from Spine 3.8.60.
Which version of Spine did you use to export your files, was it also 3.8.60?

My problem is the same case of below URL:
Unity Crashes when importing spine files

Please note that the problem in the above thread was caused by mixing Spine versions: assets exported from Spine 3.7, imported in Spine-Unity 3.8 runtime.

Does this happen every time you are importing the asset via drag and drop? If yes, could you please send us your problematic exported assets as a zip file, to contact@esotericsoftware.com? Then we can have a look at it.

PandMEntertm

Dear Harald,

Thank you for your reply.

I tried as many times as I could until I received your reply, but I couldn't solve the problem.

Some data was lost, but I found an older version of Spine data in the backup data.

I will wait for the runtime to support Unity 2019.3x.

Nikola

Hi,

I'm updating from Spine 3.6 to 3.8 and using Unity 2019.1.9f1.

I have a custom implementation of the mix and match script and I get the following error:

'AtlasAssetBase' does not contain a definition for 'materials' and no accessible extension method 'materials' accepting a first argument of type 'AtlasAssetBase' could be found (are you missing a using directive or an assembly reference?)

referring to the following code in Start():

skeletonAnimation = GetComponent<SkeletonAnimation>();
         if (sourceMaterial == null) 
         {
            if (skeletonAnimation != null)
               sourceMaterial = skeletonAnimation.SkeletonDataAsset.atlasAssets[0].Materials[0];
         }

What could be the issue?

Harald

Sorry for the trouble.

For some reason the error message does not completely fit the code (uppercase M vs lowercase m), however I assume that the problem is as follows:
The SkeletonDataAsset.atlasAssets array now holds an array of the base class AtlasAssetBase instead of SpineAtlasAsset, which provides an IEnumerable<> Materials instead of a List<> materials. Therefore the error should be resolved by replacing the access materials[0] with Materials.First() as follows:

// Add this using statement at the top of your file:
using System.Linq;
...
// replace this line:
// sourceMaterial = skeletonAnimation.SkeletonDataAsset.atlasAssets[0].Materials[0];
// with this line:
sourceMaterial = skeletonAnimation.SkeletonDataAsset.atlasAssets[0].Materials.First();

Thanks for reporting this problem, I have added an entry to the changelog and the list at the top.

Nikola

Hi Harald,

No worries. Thanks!

mcolombo

Hi Harald,

Im having an issue for some days i cannot resolve.
I updated to spine 3.8, using Unity 2019.2. Re exported all spines.

and i keep getting this error:
InvalidCastException: Specified cast is not valid.
Spine.Unity.Editor.SpineEditorUtilities.IssueWarningsForUnrecommendedTextureSettings (System.String texturePath) (at Assets/Spine/Editor/spine-unity/Editor/Utility/SpineEditorUtilities.cs:172)

And cannot edit the spine object (the skeleton animation component is broken).

Am i missing something here?

thanks a lot

Harald

We are sorry that you are having trouble!

Which version of the Spine-Unity runtime (name of the unitypackage as downloaded from here) are you using, and which version of the Spine Editor?
If using git, please note that the 3.8-beta branch has been replaced by the non-beta 3.8 branch in the meantime.

If both are latest available version (runtime spine-unity-3.8-2019-08-28.unitypackage and Spine 3.8.68), please send us a minimal Unity project that still shows the problem as a zip file. You can send it to contact@esotericsoftware.com.

mcolombo

Hi Herald!

Thanks for responding.

I exported the file using Spine 3.8.68, and using the unity package "spine-unity-3.8-2019-08-23".
I will send you a zip file.

Thanks again

Harald

Thanks for the reproduction package - there was indeed a different bug involved that triggered when it found a file with extension ".atlas1.txt".

This issue has been fixed now, new unitypackages have been uploaded.

You can download it here as usual:
Spine Unity Download

Thanks again for reporting and sorry for the trouble!

decoamorim

Hello,

We are updating to spine 3.8 - was the Ragdoll and the Kinematics Shadow Modules removed from the integration completely?
Got error in scripts using those two, since they no longer exist. Is there a substitute in the pkg?

Mario

It seems their namespace has been changed, see the notes on SkeletonRagdoll2D etc. in the CHANGELOG spine-runtimes/CHANGELOG.md at 3.8

Harald

A short note on a change committed today regarding SkeletonMecanim:

SkeletonMecanim's Layer Mix Mode enum name MixMode.SpineStyle has been renamed to MixMode.Hard. This is most likely not set via code and thus unlikely to be a problem. Serialized scenes and prefabs are unaffected.
SkeletonMecanim's Layer Mix Mode now defaults to MixMode.MixNext. Note: for a short time, the default value was changed to MixMode.SpineStyle (MixMode.Hard). This was unfortunately less intuitive in behaviour and has thus been changed.

I have also added extensive documentation of the MixMode parameters to the spine-unity documentation pages here:
spine-unity Runtime Documentation: SkeletonMecanim Component

The respective sections have been added in the top-most posting as well.
We hope that these changes make SkeletonMecanim more intuitive and easier to use 🙂.

Sljedeća stranica »