Menu
 

Performance Optimization - Necesse Wiki

Necesse: Server Performance & Lag Fixes

As your colony grows, so does the CPU strain. 50 settlers calculating pathfinding simultaneously can bring even a strong server to its knees. Here represents the best known methods to reclaim your TPS (Ticks Per Second).

1. Java Heap (RAM)

The #1 cause of stutter. Default Java limits are often too low. You must explicitly set `-Xmx` flags.

2. Unload Settlements

A crucial config setting. If `unloadSettlements=false`, the server simulates every island 24/7. Set it to `true`.

3. Pathfinding

Settlers getting stuck in doors or complex mazes consume massive CPU cycles trying to find a route. Build wide, open pathways.

Allocating More RAM

Necesse runs on Java. You need to pass start-up arguments to give it more room to breathe.

  • **Standard:** 2GB (`-Xmx2G`). Good for small play.
  • **Recommended:** 4GB (`-Xmx4G`) or 6GB (`-Xmx6G`). Essential for late-game colonies with multiple islands loaded.

Supercraft User? We automatically scale your Java Heap based on your plan's memory limit. No action needed.

Configuration Tweaks (server.cfg)

Edit your `server.cfg` or `world-settings.cfg` to relieve stress:

Setting Recommendation Why?
unloadSettlements TRUE This is the most important setting. It freezes islands when no players are present. If False, your CPU simulates the entire world forever.
maxSettlersPerSettlement 30-50 Cap this if you have performance issues. 100+ settlers is extremely heavy on pathfinding.
logging FALSE Disabling verbose logging reduces Disk I/O, which can cause "stutters" during auto-saves.

In-Game Optimizations

  1. **Simplify Bases:** Avoid 1-tile wide corridors. Settlers pathfind better in open spaces.
  2. **Limit Raiders:** Frequent raids force combat AI calculations. You can reduce `raidFrequency` in config.
  3. **Restart Daily:** Java's Garbage Collector can get inefficient over 48+ hours. A daily server restart clears the memory overhead.

Smooth colony life. Host your Necesse server with Supercraft on AMD EPYC server hardware designed to crunch Java pathfinding calculations.

Tired of fighting this issue every patch?

Run a managed Necesse server with us. We handle the patches, mod-version pinning, save backups, and DDoS protection. Set up in 3 minutes, 5 datacenter regions, no contract.

See Necesse hosting plans →
Top