Memory, heap & Java flags

Updated 4 Nov 2026

Plan RAM is not all for the game

Java needs extra memory on top of the game. So a 2 GB plan cannot give the game all 2 GB. If it tries, the server is stopped from outside with no error.

Check your setting

On the Startup tab, look for -Xmx or MaxRAMPercentage. A safe choice:

PlanHeap
2 GB plan-Xmx1400M
4 GB plan-Xmx3G
8 GB plan-Xmx7G
16 GB plan-Xmx14G

Or use MaxRAMPercentage=70, which fits any plan.

Leave the other flags alone

Your server already has tuned flags. Do not add flags from forum posts, such as ZGC. They usually make things worse.

Before buying more RAM

Most memory goes to loaded chunks and mobs, not players. Lowering simulation-distance to 6 often helps more than a bigger plan.

Problems

The server stops with no error

The heap is too close to the plan limit. Lower -Xmx.

I upgraded and nothing changed

Raise -Xmx to match the new plan, then restart.

My changes did nothing

Stop and start the server. Flags are read only at start.

Still stuck? Open a ticket and we will take a look.
Open a ticket

More guides