Troubleshooting Mac OS X

For generic, non operating system specific troubleshooting information, check the Troubleshooting page.

I can't install WorldPainter

• There are occasional download problems. Try downloading the installer again.

• If you have Mac OS X Mountain Lion or later it may refuse to install WorldPainter because, while it is digitally signed, it is not signed by Apple (for which they charge $99 a year). Follow the instructions on ​this page to turn off the requirement for applications to be signed by Apple. You can turn it back on again after WorldPainter is installed.

If you continue to have problems installing WorldPainter using one of the installers, you can try one of the installerless archives. You can find links to those on the same page where you downloaded the installer.

WorldPainter just shows a light blue screen instead of the map

If you have a Mac with a Retina screen and Max OS X Mountain Lion, try following the instructions on ​this page to turn on the "Open in Low Resolution" setting for WorldPainter.

Unresponsive and incomplete windows which cannot be dismissed

This is probably caused by a known bug in the Java for OS X 2013-004 Java update from Apple. You need to download and install a fix from Apple. See ​this page for links and instructions.

WorldPainter won't start

• If you made a change (such as installing custom brushes or a plugin, or changing a preference) and now WorldPainter won't start any more, try using WorldPainter Safe Mode. It will allow WorldPainter to start again, allowing you to undo the change you made, or confirm that the change was what caused the problem so you know to undo it.
• It is possible you made some kind of modification to the preferences that cause it to no longer start, for instance setting the default size larger than you have memory for. Try resetting the preferences by deleting the WorldPainter configuration file (~/Library/Application Support/WorldPainter/config).
• You may have so many custom brushes installed that WorldPainter runs out of memory. The custom brushes are in ~/Library/Application Support/WorldPainter/brushes, so if you have very many brushes in there, try culling them.

WorldPainter is not usable