The 90% Memory Warning

by captaincomic (Updated on 2015-03-13)

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)

First, if you don't have a 64-bit Java installed already, get the latest 64-bit version from Oracle.

Then make a batch script with the following contents, changing the 1024 to something bigger until it works for you. To make the script create a text file, save it with a .bat extension, and stick it in the Stencyl directory. If you don't have permissions to create it within the Stencyl directory, you have to create it in your user directory and move it to the Stencyl directory afterwards.

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!


Found out why it wont work, insted of the line -Xms64m use -Xms128m and it will work.
My .bat file:
java -Xms128m -Xmx4096m -jar sw.jar

0 2 weeks, 3 days ago
how do i edit it (MAC version) it opens in command line.
0 1 month, 1 day 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 2 months, 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 2 months, 1 week ago
Same problem here, if I set a value >2048 stencyl wont open on my mac.
1 10 months, 2 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 2 years, 2 weeks ago

Same problem here :-(

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

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

Sign In to Comment