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 high-frequency Ryzen CPUs designed to crunch Java pathfinding calculations effortlessly.

Top