Error Unpacking Atlas – OutOfMemoryError (Spine 3.8.99)

DaDava

Hello everyone,
I'm encountering a persistent issue when trying to work with exported Spine assets. Here's the situation:

I lost the original .spine project files, but I still have the exported *.json, *.atlas, and texture image files (PNG). I’m attempting to reconstruct or import the data into Spine 3.8.99 Professional using the legacy launcher (Spine Launcher 4.3.01-legacy), but I keep running into an error when trying to unpack the atlas.

this is the error`

Spine Launcher 4.3.01
Esoteric Software LLC (C) 2013-2025 | http://esotericsoftware.com
Windows 10 Pro amd64 10.0
NVIDIA Corporation, NVIDIA GeForce RTX 4080 SUPER/PCIe/SSE2, 4.6.0 NVIDIA 572.16
Launching: Spine 3.8.99 Professional
Spine Launcher 4.3.01-legacy
Starting: Spine 3.8.99
Spine 3.8.99 Professional
WARNING: Welcome data download failed, server error: 410
NVIDIA Corporation, NVIDIA GeForce RTX 4080 SUPER/PCIe/SSE2, 4.6.0 NVIDIA 572.16
Started.
OpenAL 1.1, Default audio device
ERROR: Unable to unpack atlas:
java.lang.RuntimeException: javax.imageio.IIOException: Caught exception during read:
at FB.D(SourceFile:98)
at Aw.run(SourceFile:156)
at ur.D(SourceFile:1188)
at dY.D(SourceFile:65)
at dz.D(SourceFile:98)
at dC.D(SourceFile:46)
at wc.D(SourceFile:128)
at dC.D(SourceFile:49)
at dH.D(SourceFile:222)
at com.esotericsoftware.spine.editor.Editor.B(SourceFile:12186)
at nuL.run(SourceFile:265)
at java.desktop/java.awt.event.InvocationEvent.dispatch(Unknown Source)
at java.desktop/java.awt.EventQueue.dispatchEventImpl(Unknown Source)
at java.desktop/java.awt.EventQueue.access$600(Unknown Source)
at java.desktop/java.awt.EventQueue$4.run(Unknown Source)
at java.desktop/java.awt.EventQueue$4.run(Unknown Source)
at java.base/java.security.AccessController.doPrivileged(Native Method)
at java.base/java.security.ProtectionDomain$JavaSecurityAccessImpl.doIntersectionPrivilege(Unknown Source)
at java.desktop/java.awt.EventQueue.dispatchEvent(Unknown Source)
at java.desktop/java.awt.EventDispatchThread.pumpOneEventForFilters(Unknown Source)
at java.desktop/java.awt.EventDispatchThread.pumpEventsForFilter(Unknown Source)
at java.desktop/java.awt.EventDispatchThread.pumpEventsForHierarchy(Unknown Source)
at java.desktop/java.awt.EventDispatchThread.pumpEvents(Unknown Source)
at java.desktop/java.awt.EventDispatchThread.pumpEvents(Unknown Source)
at java.desktop/java.awt.EventDispatchThread.run(Unknown Source)
Caused by: javax.imageio.IIOException: Caught exception during read:
at java.desktop/com.sun.imageio.plugins.png.PNGImageReader.read(Unknown Source)
at java.desktop/javax.imageio.ImageIO.read(Unknown Source)
at java.desktop/javax.imageio.ImageIO.read(Unknown Source)
at FB.D(SourceFile:96)
... 24 more
Caused by: java.lang.OutOfMemoryError: Java heap space
at java.desktop/java.awt.image.DataBufferByte.<init>(Unknown Source)
at java.desktop/java.awt.image.ComponentSampleModel.createDataBuffer(Unknown Source)
at java.desktop/java.awt.image.Raster.createWritableRaster(Unknown Source)
at java.desktop/javax.imageio.ImageTypeSpecifier.createBufferedImage(Unknown Source)
at java.desktop/javax.imageio.ImageReader.getDestination(Unknown Source)
at java.desktop/com.sun.imageio.plugins.png.PNGImageReader.readImage(Unknown Source)
at java.desktop/com.sun.imageio.plugins.png.PNGImageReader.read(Unknown Source)
at java.desktop/javax.imageio.ImageIO.read(Unknown Source)
at java.desktop/javax.imageio.ImageIO.read(Unknown Source)
at FB.D(SourceFile:96)
at java.base/java.lang.invoke.LambdaForm$DMH/2972398.invokeSpecial(LambdaForm$DMH)
at java.base/java.lang.invoke.LambdaForm$MH/25975259.invoke(LambdaForm$MH)
at java.base/java.lang.invoke.LambdaForm$MH/16605240.linkToTargetMethod(LambdaForm$MH)
at Aw.run(SourceFile:156)
at ur.D(SourceFile:1188)
at dY.D(SourceFile:65)
at dz.D(SourceFile:98)
at dC.D(SourceFile:46)
at wc.D(SourceFile:128)
at dC.D(SourceFile:49)
at dH.D(SourceFile:222)
at java.base/java.lang.invoke.LambdaForm$DMH/18399597.invokeSpecial(LambdaForm$DMH)
at java.base/java.lang.invoke.LambdaForm$MH/4827222.invoke(LambdaForm$MH)
at java.base/java.lang.invoke.LambdaForm$MH/16973851.linkToTargetMethod(LambdaForm$MH)
at com.esotericsoftware.spine.editor.Editor.B(SourceFile:12186)
at nuL.run(SourceFile:265)
at java.desktop/java.awt.event.InvocationEvent.dispatch(Unknown Source)
at java.desktop/java.awt.EventQueue.dispatchEventImpl(Unknown Source)
at java.desktop/java.awt.EventQueue.access$600(Unknown Source)
at java.desktop/java.awt.EventQueue$4.run(Unknown Source)
at java.desktop/java.awt.EventQueue$4.run(Unknown Source)
at java.base/java.security.AccessController.doPrivileged(Native Method)
WARNING: Welcome data download failed, server error: 410
WARNING: Welcome data download failed, server error: 410
WARNING: Welcome data download failed, server error: 410
WARNING: Welcome data download failed, server error: 410
WARNING: Welcome data download failed, server error: 410
WARNING: Welcome data download failed, server error: 410
WARNING: Welcome data download failed, server error: 410
WARNING: Welcome data download failed, server error: 410
ERROR: Unable to unpack atlas:
java.lang.RuntimeException: javax.imageio.IIOException: Caught exception during read:
at FB.D(SourceFile:98)
at Aw.run(SourceFile:156)
at ur.D(SourceFile:1188)
at dY.D(SourceFile:65)
at dz.D(SourceFile:98)
at dC.D(SourceFile:46)
at wc.D(SourceFile:128)
at dC.D(SourceFile:49)
at dH.D(SourceFile:222)
at com.esotericsoftware.spine.editor.Editor.B(SourceFile:12186)
at nuL.run(SourceFile:265)
at java.desktop/java.awt.event.InvocationEvent.dispatch(Unknown Source)
at java.desktop/java.awt.EventQueue.dispatchEventImpl(Unknown Source)
at java.desktop/java.awt.EventQueue.access$600(Unknown Source)
at java.desktop/java.awt.EventQueue$4.run(Unknown Source)
at java.desktop/java.awt.EventQueue$4.run(Unknown Source)
at java.base/java.security.AccessController.doPrivileged(Native Method)
at java.base/java.security.ProtectionDomain$JavaSecurityAccessImpl.doIntersectionPrivilege(Unknown Source)
at java.desktop/java.awt.EventQueue.dispatchEvent(Unknown Source)
at java.desktop/java.awt.EventDispatchThread.pumpOneEventForFilters(Unknown Source)
at java.desktop/java.awt.EventDispatchThread.pumpEventsForFilter(Unknown Source)
at java.desktop/java.awt.EventDispatchThread.pumpEventsForHierarchy(Unknown Source)
at java.desktop/java.awt.EventDispatchThread.pumpEvents(Unknown Source)
at java.desktop/java.awt.EventDispatchThread.pumpEvents(Unknown Source)
at java.desktop/java.awt.EventDispatchThread.run(Unknown Source)
Caused by: javax.imageio.IIOException: Caught exception during read:
at java.desktop/com.sun.imageio.plugins.png.PNGImageReader.read(Unknown Source)
at java.desktop/javax.imageio.ImageIO.read(Unknown Source)
at java.desktop/javax.imageio.ImageIO.read(Unknown Source)
at FB.D(SourceFile:96)
... 24 more
Caused by: java.lang.OutOfMemoryError: Java heap space
at java.desktop/java.awt.image.DataBufferByte.<init>(Unknown Source)
at java.desktop/java.awt.image.ComponentSampleModel.createDataBuffer(Unknown Source)
at java.desktop/java.awt.image.Raster.createWritableRaster(Unknown Source)
at java.desktop/javax.imageio.ImageTypeSpecifier.createBufferedImage(Unknown Source)
at java.desktop/javax.imageio.ImageReader.getDestination(Unknown Source)
at java.desktop/com.sun.imageio.plugins.png.PNGImageReader.readImage(Unknown Source)
at java.desktop/com.sun.imageio.plugins.png.PNGImageReader.read(Unknown Source)
at java.desktop/javax.imageio.ImageIO.read(Unknown Source)
at java.desktop/javax.imageio.ImageIO.read(Unknown Source)
at FB.D(SourceFile:96)
at java.base/java.lang.invoke.LambdaForm$DMH/2972398.invokeSpecial(LambdaForm$DMH)
at java.base/java.lang.invoke.LambdaForm$MH/25975259.invoke(LambdaForm$MH)
at java.base/java.lang.invoke.LambdaForm$MH/16605240.linkToTargetMethod(LambdaForm$MH)
at Aw.run(SourceFile:156)
at ur.D(SourceFile:1188)
at dY.D(SourceFile:65)
at dz.D(SourceFile:98)
at dC.D(SourceFile:46)
at wc.D(SourceFile:128)
at dC.D(SourceFile:49)
at dH.D(SourceFile:222)
at java.base/java.lang.invoke.LambdaForm$DMH/18399597.invokeSpecial(LambdaForm$DMH)
at java.base/java.lang.invoke.LambdaForm$MH/4827222.invoke(LambdaForm$MH)
at java.base/java.lang.invoke.LambdaForm$MH/16973851.linkToTargetMethod(LambdaForm$MH)
at com.esotericsoftware.spine.editor.Editor.B(SourceFile:12186)
at nuL.run(SourceFile:265)
at java.desktop/java.awt.event.InvocationEvent.dispatch(Unknown Source)
at java.desktop/java.awt.EventQueue.dispatchEventImpl(Unknown Source)
at java.desktop/java.awt.EventQueue.access$600(Unknown Source)
at java.desktop/java.awt.EventQueue$4.run(Unknown Source)
at java.desktop/java.awt.EventQueue$4.run(Unknown Source)
at java.base/java.security.AccessController.doPrivileged(Native Method)
WARNING: Welcome data download failed, server error: 410
WARNING: Welcome data download failed, server error: 410
ERROR: Unable to unpack atlas:
java.lang.RuntimeException: javax.imageio.IIOException: Caught exception during read:
at FB.D(SourceFile:98)
at Aw.run(SourceFile:156)
at ur.D(SourceFile:1188)
at dY.D(SourceFile:65)
at dz.D(SourceFile:98)
at dC.D(SourceFile:46)
at wc.D(SourceFile:128)
at dC.D(SourceFile:49)
at dH.D(SourceFile:222)
at com.esotericsoftware.spine.editor.Editor.B(SourceFile:12186)
at nuL.run(SourceFile:265)
at java.desktop/java.awt.event.InvocationEvent.dispatch(Unknown Source)
at java.desktop/java.awt.EventQueue.dispatchEventImpl(Unknown Source)
at java.desktop/java.awt.EventQueue.access$600(Unknown Source)
at java.desktop/java.awt.EventQueue$4.run(Unknown Source)
at java.desktop/java.awt.EventQueue$4.run(Unknown Source)
at java.base/java.security.AccessController.doPrivileged(Native Method)
at java.base/java.security.ProtectionDomain$JavaSecurityAccessImpl.doIntersectionPrivilege(Unknown Source)
at java.desktop/java.awt.EventQueue.dispatchEvent(Unknown Source)
at java.desktop/java.awt.EventDispatchThread.pumpOneEventForFilters(Unknown Source)
at java.desktop/java.awt.EventDispatchThread.pumpEventsForFilter(Unknown Source)
at java.desktop/java.awt.EventDispatchThread.pumpEventsForHierarchy(Unknown Source)
at java.desktop/java.awt.EventDispatchThread.pumpEvents(Unknown Source)
at java.desktop/java.awt.EventDispatchThread.pumpEvents(Unknown Source)
at java.desktop/java.awt.EventDispatchThread.run(Unknown Source)
Caused by: javax.imageio.IIOException: Caught exception during read:
at java.desktop/com.sun.imageio.plugins.png.PNGImageReader.read(Unknown Source)
at java.desktop/javax.imageio.ImageIO.read(Unknown Source)
at java.desktop/javax.imageio.ImageIO.read(Unknown Source)
at FB.D(SourceFile:96)
... 24 more
Caused by: java.lang.OutOfMemoryError: Java heap space
ERROR: Unable to unpack atlas:
java.lang.RuntimeException: javax.imageio.IIOException: Caught exception during read:
at FB.D(SourceFile:98)
at Aw.run(SourceFile:156)
at ur.D(SourceFile:1188)
at dY.D(SourceFile:65)
at dz.D(SourceFile:98)
at dC.D(SourceFile:46)
at wc.D(SourceFile:128)
at dC.D(SourceFile:49)
at dH.D(SourceFile:222)
at com.esotericsoftware.spine.editor.Editor.B(SourceFile:12186)
at nuL.run(SourceFile:265)
at java.desktop/java.awt.event.InvocationEvent.dispatch(Unknown Source)
at java.desktop/java.awt.EventQueue.dispatchEventImpl(Unknown Source)
at java.desktop/java.awt.EventQueue.access$600(Unknown Source)
at java.desktop/java.awt.EventQueue$4.run(Unknown Source)
at java.desktop/java.awt.EventQueue$4.run(Unknown Source)
at java.base/java.security.AccessController.doPrivileged(Native Method)
at java.base/java.security.ProtectionDomain$JavaSecurityAccessImpl.doIntersectionPrivilege(Unknown Source)
at java.desktop/java.awt.EventQueue.dispatchEvent(Unknown Source)
at java.desktop/java.awt.EventDispatchThread.pumpOneEventForFilters(Unknown Source)
at java.desktop/java.awt.EventDispatchThread.pumpEventsForFilter(Unknown Source)
at java.desktop/java.awt.EventDispatchThread.pumpEventsForHierarchy(Unknown Source)
at java.desktop/java.awt.EventDispatchThread.pumpEvents(Unknown Source)
at java.desktop/java.awt.EventDispatchThread.pumpEvents(Unknown Source)
at java.desktop/java.awt.EventDispatchThread.run(Unknown Source)
Caused by: javax.imageio.IIOException: Caught exception during read:
at java.desktop/com.sun.imageio.plugins.png.PNGImageReader.read(Unknown Source)
at java.desktop/javax.imageio.ImageIO.read(Unknown Source)
at java.desktop/javax.imageio.ImageIO.read(Unknown Source)
at FB.D(SourceFile:96)
... 24 more
Caused by: java.lang.OutOfMemoryError: Java heap space
WARNING: Welcome data download failed, server error: 410
WARNING: Welcome data download failed, server error: 410
ERROR: Unable to unpack atlas:
java.lang.RuntimeException: javax.imageio.IIOException: Caught exception during read:
at FB.D(SourceFile:98)
at Aw.run(SourceFile:156)
at ur.D(SourceFile:1188)
at dY.D(SourceFile:65)
at dz.D(SourceFile:98)
at dC.D(SourceFile:46)
at wc.D(SourceFile:128)
at dC.D(SourceFile:49)
at dH.D(SourceFile:222)
at com.esotericsoftware.spine.editor.Editor.B(SourceFile:12186)
at nuL.run(SourceFile:265)
at java.desktop/java.awt.event.InvocationEvent.dispatch(Unknown Source)
at java.desktop/java.awt.EventQueue.dispatchEventImpl(Unknown Source)
at java.desktop/java.awt.EventQueue.access$600(Unknown Source)
at java.desktop/java.awt.EventQueue$4.run(Unknown Source)
at java.desktop/java.awt.EventQueue$4.run(Unknown Source)
at java.base/java.security.AccessController.doPrivileged(Native Method)
at java.base/java.security.ProtectionDomain$JavaSecurityAccessImpl.doIntersectionPrivilege(Unknown Source)
at java.desktop/java.awt.EventQueue.dispatchEvent(Unknown Source)
at java.desktop/java.awt.EventDispatchThread.pumpOneEventForFilters(Unknown Source)
at java.desktop/java.awt.EventDispatchThread.pumpEventsForFilter(Unknown Source)
at java.desktop/java.awt.EventDispatchThread.pumpEventsForHierarchy(Unknown Source)
at java.desktop/java.awt.EventDispatchThread.pumpEvents(Unknown Source)
at java.desktop/java.awt.EventDispatchThread.pumpEvents(Unknown Source)
at java.desktop/java.awt.EventDispatchThread.run(Unknown Source)
Caused by: javax.imageio.IIOException: Caught exception during read:
at java.desktop/com.sun.imageio.plugins.png.PNGImageReader.read(Unknown Source)
at java.desktop/javax.imageio.ImageIO.read(Unknown Source)
at java.desktop/javax.imageio.ImageIO.read(Unknown Source)
at FB.D(SourceFile:96)
... 24 more
Caused by: java.lang.OutOfMemoryError: Java heap space
ERROR: Unable to unpack atlas:
java.lang.RuntimeException: javax.imageio.IIOException: Caught exception during read:
at FB.D(SourceFile:98)
at Aw.run(SourceFile:156)
at ur.D(SourceFile:1188)
at dY.D(SourceFile:65)
at dz.D(SourceFile:98)
at dC.D(SourceFile:46)
at wc.D(SourceFile:128)
at dC.D(SourceFile:49)
at dH.D(SourceFile:222)
at com.esotericsoftware.spine.editor.Editor.B(SourceFile:12186)
at nuL.run(SourceFile:265)
at java.desktop/java.awt.event.InvocationEvent.dispatch(Unknown Source)
at java.desktop/java.awt.EventQueue.dispatchEventImpl(Unknown Source)
at java.desktop/java.awt.EventQueue.access$600(Unknown Source)
at java.desktop/java.awt.EventQueue$4.run(Unknown Source)
at java.desktop/java.awt.EventQueue$4.run(Unknown Source)
at java.base/java.security.AccessController.doPrivileged(Native Method)
at java.base/java.security.ProtectionDomain$JavaSecurityAccessImpl.doIntersectionPrivilege(Unknown Source)
at java.desktop/java.awt.EventQueue.dispatchEvent(Unknown Source)
at java.desktop/java.awt.EventDispatchThread.pumpOneEventForFilters(Unknown Source)
at java.desktop/java.awt.EventDispatchThread.pumpEventsForFilter(Unknown Source)
at java.desktop/java.awt.EventDispatchThread.pumpEventsForHierarchy(Unknown Source)
at java.desktop/java.awt.EventDispatchThread.pumpEvents(Unknown Source)
at java.desktop/java.awt.EventDispatchThread.pumpEvents(Unknown Source)
at java.desktop/java.awt.EventDispatchThread.run(Unknown Source)
Caused by: javax.imageio.IIOException: Caught exception during read:
at java.desktop/com.sun.imageio.plugins.png.PNGImageReader.read(Unknown Source)
at java.desktop/javax.imageio.ImageIO.read(Unknown Source)
at java.desktop/javax.imageio.ImageIO.read(Unknown Source)
at FB.D(SourceFile:96)
... 24 more
Caused by: java.lang.OutOfMemoryError: Java heap space

Spinebot

The error you're encountering, java.lang.OutOfMemoryError: Java heap space, suggests that the Java Virtual Machine (JVM) is running out of memory while trying to unpack the atlas. This can happen if the images are too large or if there are too many images being processed at once. To resolve this, you can try increasing the memory allocated to the JVM. You can do this by running Spine with -Xmx to allocate more memory, for example, -Xmx2048M to allocate 2GB of memory. Additionally, ensure that your system has enough available RAM to support the increased allocation. Note that Spine < 4.0 is 32-bit, so Windows will likely prevent Spine from running with more than around 1.4GB of memory (-Xmx1400M).

DaDava

I’m currently experiencing a java.lang.OutOfMemoryError: Java heap space error while attempting to unpack an atlas file in Spine. I came across your recommendation to increase the Java heap size by modifying the Spine.l4j.ini file. However, I’ve searched my installation directory and system but could not locate this file.

Could you please advise:

Where exactly I can find the Spine.l4j.ini file?

If it’s not included by default, can I safely create it manually in the Spine installation folder?

Are there any specific parameters or syntax I should be aware of when doing so?

Nate

There is no Spine.l4j.ini, I've edited Spinebot's answer to be accurate.

You can use Spine 4.0+ to unpack your atlas and you are unlikely to have an out of memory problem, as Spine 4.0+ is 64-bit. If you do, you can use -Xmx4000M or similar to give Spine plenty of memory.