The 90% Memory Warning

by captaincomic (Updated on 2015-02-04)

Why does this happen?

Java operates by allocating a chunk of memory for the application to use before the app launches - it can't be set at runtime.

There is an upper limit to this memory. If you go too high, the application stops operating properly.

So why not just set the limit very high? It causes weaker machines with less memory to fail to open the app at all.

Although we are working to reduce memory usage and plug leaks, there are large games for which having the higher memory usage will be useful.

Common Misconception: The 90% memory warning has nothing to do with how much RAM your computer has. You could have 128 GB of RAM and still hit this since Java's upper cap sits around 4 GB and on some systems, may be as low as 2 GB.


How to Safely Suppress This Warning (Windows)

Make a batch script (create a text file, save it with a .bat extension, stick it in the Stencyl directory) with the following contents, changing the 1024 to something bigger until it works for you.

java -Xms64m -Xmx1024m -jar sw.jar

Double click the script to start Stencyl from now on.

Note: The -Xmx setting may be overridden by the _JAVA_OPTIONS environment variable. See this tutorial for how to delete the variable.


How to Safely Suppress This Warning (Linux)

1) Edit the Stencyl shell script.

2) Change the thing that looks like "-Xmx1024m" to a higher number - the 1024 represents MB.


How to Safely Suppress This Warning (Mac)

1) Right-click the Stencyl.app bundle and "Show Package Contents".

2) Edit Contents/MacOS/Stencyl.

3) Find the line that starts with -Xmx1536m and change the number to a higher number - the 1536 represents MB.


Disclaimer: All articles are geared towards Stencyl 3.0 and above. Use comments to provide feedback and point out issues with the article (typo, wrong info, etc.). If you're seeking help for your game, please ask a question on the forums. Thanks!


how do i edit it (MAC version) it opens in command line.
0 6 days, 10 hours ago
What am I supposed to name it ??.bat If it doesn't matter I set the limit to 20480 and it seems to still not work. I am pretty sure the game is not that big. Just want some specifics.
0 1 month, 1 week ago
Soo.. my problem is that the plist don't show up a Java node.. Only some Informations about the property list.. Any help? I still can not work more on this Project till it's fixed :( Running on MBP
1 1 month, 2 weeks ago
Same problem here, if I set a value >2048 stencyl wont open on my mac.
1 9 months, 3 weeks ago
I've stuck in a few more solutions that were reported to be successful.
0 1 year, 1 month ago
I have 2.2 but still have this problem very often... usually every 15 to 30 mins
0 1 year, 11 months ago

Same problem here :-(

It seems like it. When I set it to something higher on my Mac then Stencyl won't open.

0 1 year, 11 months ago
It seems like it. When I set it to something higher on my Mac then Stencyl won't open.
2 2 years, 4 months ago
what is the limit ? 2048 Mb ?
0 2 years, 4 months ago

Sign In to Comment