Having trouble running Spine? Is Spine unable to start or crashes while you are using it? You have come to the right place!
While we strive for Spine to run flawlessly on all computers, sometimes things go wrong or Spine is run on configurations that we've never seen before. On this page you'll find a number of things you can check to get Spine running.
When Spine runs, the first thing it does is create a log file at this location:
<user home folder>\Spine\spine.log
If any errors occur, they will appear in this file. Sometimes the error message is mixed with what looks like unintelligible information, so read carefully. If you can't make any sense of the errors, you can it post on the forum or send it to us. Please post or email the entire log, not just part of it (the forum will automatically remove your name and email from the log). Also, it helps a great deal to tell what you were doing when the error occurred. We love to fix bugs in Spine and are very grateful if you can help us reproduce any problem you might find.
Each time Spine runs it deletes the
spine.log file and creates a new, empty one. If Spine crashes you should check the
spine.log file before running Spine again.
spine.log file is never created, it means that something went wrong Spine very early in Spine's start up process. You may need to run Spine from the command line:
Command Promptand type:
"C:\Program Files (x86)\Spine\Spine.com"
- Alternatively, on macOS you can run the
All Messages, then start Spine and watch the output in the
When you run Spine this way, Spine's logging is output in the command line window and you may see errors that give clues about why Spine is unable to start.
On macOS some other software may conflict with Spine. For example, some screen mirroring software or Finder "enhancements", such as Default Folder X, can prevent Spine from running. Also, Rescue Time needs to be closed when Spine is started.
Some antivirus or anti-malware software, such as Bit Defender or 360 Browser, will unjustifiably modify or delete Spine's files. This can cause Spine to fail to run completely, or to run only to fail later. You'll need to disable such software or whitelist Spine's folders so Spine won't get ruined. Spine's folders are:
C:\Program Files (x86)\Spine\(or the folder where you installed Spine)
<user home folder>\Spine
- The folder where you decompressed and placed Spine.
When you install Spine, you are actually installing the Spine launcher. When you run Spine, it needs to download the version of Spine you want to run. If you have a firewall on your router or other network hardware or a software firewall that blocks Spine from reaching the server, then you'll need to disable the firewall or add rules to allow Spine's communication. Spine connects to
esotericsoftware.com using ports
Spine will be unable to run if your
hosts file contains an entry that redirects network traffic for
esotericsoftware.com. You'll see an error message about it in your
spine.log file and you'll need to edit your
hosts file to remove the entry:
macOS and Linux
If you require internet connections to use a proxy server, you'll need to start Spine with a special command to specify the proxy server. If you don't know if you need to configure Spine to use your proxy server, then you probably don't need to.
Our servers are located in Japan and Europe. If you are located in China or your internet connection to our servers is very slow, you may need to try multiple times or try again later.
One of the first things to check is that you are running the latest Spine launcher. To do that, go to your Spine license page which you received when you purchased Spine, then download and reinstall Spine. If you can't find your Spine license page, please contact us.
Spine uses hardware accelerated audio and video (OpenAL and OpenGL). Any bugs in the drivers for your audio or video hardware can cause Spine to crash or be unable to run at all. Make sure you have the latest drivers by going to the manufacturer's website for both your audio and video hardware, then download and install the latest drivers provided.
If you don't need Spine's audio capabilities, you can disable Spine's use of the audio hardware by starting Spine with the
--disable-audio command line parameter. We've had reports of some bad audio drivers for gaming laptops.
Spine stores settings and other files in your user folder:
<user home folder>\Spine
You can safely delete this entire folder and everything in it, which may help with some kinds of problems. However, you may want to first save some of the files:
backupsubfolder is where Spine stores copies of your projects each time you save.
.jsonfiles are where Spine stores your settings. Delete them resets Spine to the default settings.
hotkeys.txtfile is where Spine stores the hotkeys to use for various actions. If you have customized this file, you probably want to keep it safe.
updatessubfolder is where Spine stores downloaded updates. Deleting them will cause Spine to download the updates again.
You can choose which version of Spine to run in Spine's settings. If Spine is crashing, you may want to try the latest update. Please note that if you save your projects with a newer version, older versions won't be able to open it.
To run the latest version, choose
Latest in Spine's settings. If you can't get to the settings dialog, you can delete the
version.txt file here:
<user home folder>\Spine\version.txt
If the file doesn't exist, then Spine will use the latest version. If the file does exist, Spine will use the version specified in the file.
Command Promptand type:
"C:\Program Files (x86)\Spine\Spine.com" --update 3.7.94
/Applications/Spine/Spine.app/Contents/MacOS/Spine --update 3.7.94
Spine.sh --update 3.7.94
If the latest version has problems for you, you might try going back to an older version (if you haven't yet saved your project with the newer version, or you get an older version of your project from your backups). We fix bugs very quickly, often within days (especially when users show us how to reproduce a problem!), but if you are having trouble with the latest version you may want to use an older version so you can be productive, rather than wait for a fix.