Minecraft Performance Optimization Checklist

The most impactful config settings across all Minecraft server files, ordered by impact. Select your server software and player count for tailored recommendations.

20

TPS & Distance Quick Reference

TPS Target: 20.0 (50ms/tick)

Below 15 TPS = noticeable lag. Below 10 = severe. Each additional view-distance ring adds (2D+1)×2 chunks where D is the ring number.

view-distance vs simulation-distance

view-distance controls what players see. simulation-distance controls what runs (entities, crops, redstone). Set view=10, simulation=5 for the best of both.

view-distance High server.properties

= 6 (small server) = 8 (medium server)

Reduces the number of chunks loaded per player. The single biggest TPS improvement — each ring added is exponentially more work.

simulation-distance High server.properties

= 4 (small) = 6 (medium)

Controls how far from players entities tick, crops grow, and redstone runs. Lower than view-distance for best performance without visible lag.

per-player-mob-spawns High paper-world-defaults.yml

= true

Distributes mob caps evenly per player instead of globally — dramatically reduces mob overcrowding on servers with uneven player spread.

redstone-implementation High paper-world-defaults.yml

= ALTERNATE_CURRENT

Alternate Current is a highly optimized redstone implementation. Fixes update order bugs AND reduces redstone lag significantly.

spawn-limits: monsters Medium bukkit.yml

= 35 (was 70)

Halving the global monster spawn cap reduces entity processing load without noticeably affecting gameplay feel for most servers.

entity-activation-range: monsters Medium spigot.yml

= 32 (was 48)

Mobs outside this range are ticked less frequently. Reduces entity AI overhead from mobs players can't even see.

max-entity-collisions Medium paper-world-defaults.yml

= 8

Caps how many entities can collide with each other at once. Stops entity pileups from tanking TPS.

anti-xray: enabled + engine-mode Medium paper-world-defaults.yml

= true = 1

Engine mode 1 hides ores behind solid blocks server-side. Very low performance cost and stops most x-ray clients.

treasure-maps: enabled Medium paper-world-defaults.yml

= false

Treasure map generation explores unloaded chunks to find structures — a well-known cause of sudden lag spikes when players craft or trade them.

alt-item-despawn-rate: enabled Medium paper-world-defaults.yml

= true

Configure specific items (like cobblestone) to despawn faster than the default 5 minutes, reducing ground entity count.

merge-radius: item Medium spigot.yml

= 2.5

Merges dropped item entities within this radius into stacks. Fewer entities = less processing every tick.

merge-radius: exp Medium spigot.yml

= 3.0

Merges nearby XP orbs into larger ones. XP orbs are surprisingly expensive — merging them is an easy win.

nerf-spawner-mobs Low spigot.yml

= true

Mobs from spawners won't pathfind when no player is nearby. Reduces CPU usage from mob farms when no one is watching.

mob-spawn-range Low spigot.yml

= 6 (was 8)

Mobs spawn closer to players — less spread-out mob processing while keeping spawn rates acceptable.

ticks-per: monster-spawns Low bukkit.yml

= 2 (was 1)

Runs mob spawn checks every 2 ticks instead of every tick. Halves spawning overhead with minimal impact on mob count.

chunk-gc: period-in-ticks Low bukkit.yml

= 300 (was 600)

Unloads unused chunks more frequently, keeping memory usage lower on servers with lots of player movement.

max-tick-time: entity Low spigot.yml

= 20

Stops entity processing if it exceeds this many milliseconds per tick, preventing a runaway entity from killing your TPS.

despawn-ranges: soft Low paper-world-defaults.yml

= 28 (hard = 96)

Mobs beyond soft range have a chance to despawn — keeps entity count from growing without bound in loaded chunks.

Optimizations applied

0 / 18

Private Minecraft hosting

Run your own Minecraft server.

Rent a private Minecraft server on real hardware — full control-panel access, your mods, your configs, your rules. It's your server; run it your way.

Rent a Minecraft server Real hardware · Full control panel · 98% SLA

Don't want to run it yourself? Our managed services & consulting team will set it up and keep it running for you — game servers, Windows, Linux, and cloud, from 10+ years of MSP work.