Spine upgrade to AnimationState.cs freezes editor and build

abuki

Hi,

We were updating our project to Unity 6 and, after update to Unity 6 we also tried upgrading spine (C#) runtime from 4.2.31 to 4.2.34 (The issue might not be related to Unity 6)

This spine upgrade is causing the editor and build to freeze after a while without giving any specific error.
I don't have an isolated project, but I isolated the code change that is causing the issue. Maybe you could guess what is wrong just from the code?

This is the change that is causing the issue.

Spinebot

It seems like the issue you're experiencing with the Spine upgrade causing the Unity editor and build to freeze might be related to a specific change in the AnimationState.cs file. Unfortunately, without more detailed information or an isolated project, it's challenging to pinpoint the exact cause of the problem. However, based on similar issues discussed in the forums, it could be related to a bug or an incompatibility introduced in the newer version of the Spine runtime. You might want to check if there are any known issues or updates related to the version you are using on the Spine GitHub issues page. Additionally, ensure that all other dependencies and configurations in your project are compatible with the new Spine runtime version.

Harald

@abuki Sorry to hear you're having troubles. Note that if you are using the spine-unity runtime, you need to update the spine-csharp core and spine-unity runtimes at the same time. Which version of the spine-unity runtime were you using before and after the update?

This spine upgrade is causing the editor and build to freeze after a while without giving any specific error.

What do you mean by "after a while"? When building (to what platform?), or when opening your project after the update, or when having the project open and after updating the runtime? Please always provide as much information as possible.

In general we need a reproduction project to fix such issues unfortunately.

abuki

Spine-csharp: 4.2.31 -> 4.2.34
Spine-unity: 4.2.87 -> 4.2.95
(as stated in package.json)

Old Package version: spine-unity-4.2-2024-09-23.unitypackage
New Package version: spine-unity-4.2-2025-02-05.unitypackage

I am always upgrading using this package https://esotericsoftware.com/spine-unity-download, I assume it updates both spine-csharp and spine-unity, right?

After a while means you start the game, the game runs for a while and then freezes. I guess there is some infinite loop because no errors, no crash. It could be a problem with our scripts somehow, but was working OK before the upgrade. Extracting reproduction project would probably be very time-consuming in this case. That is why I was asking if there is any possible visible change in the code above that could be causing the problem. But I barely understand what this piece of code should do.

Harald

abuki I am always upgrading using this package https://esotericsoftware.com/spine-unity-download, I assume it updates both spine-csharp and spine-unity, right?

Yes, you assume correctly. The unitypackage is released manually with compatible combinations of spine-csharp and spine-unity only.

After a while means you start the game, the game runs for a while and then freezes.

So I assume you mean your game freezes both in the Unity Editor after entering play mode after some time as well as in the built executable, right?

Extracting reproduction project would probably be very time-consuming in this case.
That is why I was asking if there is any possible visible change in the code above that could be causing the problem.

Showing us the code changes that trigger your issue helps a bit, but the changes are there for a reason. In this case to fix issues when adding animations without advancing time but still triggering an update call (AnimationState.Update). Previously this could lead to a stack overflow, which is fixed by the above changes.

Unfortunately the relevant other part is your project setup and code which triggers your issue. I'm afraid we can't fix the issue without being able to reproduce it or understand what you are doing. We would love to fix any hidden issues or prevent potential problems, so if you could sometime in the future try to strip your problematic project down to just the problematic parts, that would be a great help.

abuki

No rush, we can stay on the old runtime for a while. Just want to be sure we are future-proof 🙂

Harald

abuki No rush, we can stay on the old runtime for a while. Just want to be sure we are future-proof 🙂

That's good to hear. Nevertheless, if you could in the future find the time to strip the project down to a minimal reproduction project, please do send it to us as a zip file via email to contact@esotericsoftware.com (briefly mentioning this forum thread so that we know the context).

abuki

Harald So I assume you mean your game freezes both in the Unity Editor after entering play mode after some time as well as in the built executable, right?

Yes.

I will try to look at it more deeply or to isolate the problem next week. Thanks for pointing out what the changes do, that might help.

abuki

Harald In this case to fix issues when adding animations without advancing time but still triggering an update call (AnimationState.Update). Previously this could lead to a stack overflow, which is fixed by the above changes.

Strange, I fixed the issue by replacing SkeletonAnimation.Update(0); with SkeletonAnimation.AnimationState.Update(0); in one of our scripts.

Can you tell me the design difference between these methods? Which one should I be using?

In my specific case, I am subscribed to animation start event and starting another animation on a different track but can see one frame missing attachment. The Update(0) did the trick to see the change immediately, the same frame - that's why I am calling it. I see I am using the SkeletonAnimation.Update(0); in many other scripts without problem (probably? not checked all), but now I am unsure if it's safe, and what is the correct use case?

Harald

abuki Strange, I fixed the issue by replacing SkeletonAnimation.Update(0); with SkeletonAnimation.AnimationState.Update(0); in one of our scripts.

Can you tell me the design difference between these methods? Which one should I be using?

There is quite a big difference. SkeletonAnimation.Update includes AnimationState.Update, but many more things.

AnimationState.Update(0) just updates the core AnimationState and triggers animation-driven callback events, but does not appy the updated animation state to the Skeleton, does not issue callbacks like UpdateLocal, UpdateWorld, UpdateComplete and does not adjust Unity-specific things like updating the Mesh.

You can also check out the SkeletonAnimation.Update(float deltaTime) source code here.

abuki I see I am using the SkeletonAnimation.Update(0); in many other scripts without problem (probably? not checked all), but now I am unsure if it's safe, and what is the correct use case?

It is in general "safe" and normal to call SkeletonAnimation.Update(0). It can however become problematic if you e.g. create hidden infinite loops through circular callbacks (A calling B calling C calling A again) or something like that. I would recommend to attach a debugger and pause in the debugger when the editor is getting stuck. Also you could have a try removing your own custom components bit by bit until the issue no longer occurs, to get a clue how the issue is triggered.

abuki

Hi Harald,

Thanks for the detailed info. I found the issue in our codebase and fixed it, unifying the calls to Update(0) across the whole project.

The strange thing is that the runtime update revealed the problem, even though it had been working for a long time before. But now I see the issue clearly—I was just misled into thinking it was caused by the Spine runtime update.

Harald

Glad to hear you've figured it out, thanks for letting us know!