Profiles

Profiles

One line in paperstream.yml sets many values at once:

profile: medium

Profile	For
low	close to Paper, only changes nobody notices in game
medium	balanced, the default
performance	weak servers with 2 to 4 cores. Saves the most CPU, chunks load a bit slower
custom	nothing is changed, every value comes from the file

Switch live with /paperstream profile <name>. The profile writes its values into the file once. Afterwards every value can still be changed by hand, a reload keeps your changes. Settings added by a later update get the value of your active profile.

The chunk worker threads (with worker-threads: -1 in paper-global.yml) and the worker priority follow the profile after a restart.

Values

Setting	low	medium	performance
chunks.generation-boost	2.0	2.0	1.0
chunks.send-budget-ms	0 (off)	0 (off)	2.0
chunks.fresh-chunks.enabled	false	true	true
chunks.fresh-chunks.warmup-seconds	5	5	8
chunks.unload.delay-seconds	10	30	30
chunks.unload.min-per-tick	50	50	25
chunks.unload.fraction-per-tick	0.05	0.05	0.03
chunks.worker-priority.nice	0	5	10
chunks.lag-generation-factor	1.0	0.5	0.5
entities.tick-throttle.near-distance	48	32	24
entities.tick-throttle.far-distance	80	56	40
entities.tick-throttle.lag-mspt	40	40	30
entities.pathfinding.max-per-tick	160	80	40
entities.villager-brain-interval	1 (off)	20	40
entities.activation-check-interval	1	1	2
entities.item-piles.max-per-block	128	64	48
world.lag-protection.mspt	50	45	35
world.explosions.max-per-chunk-per-tick	64	32	16
world.idle.after-seconds	60	60	30
world.redstone-clocks.max-per-second	600	400	250
world.redstone-clocks.throttled-per-second	60	40	20
chunk worker threads (auto)	cores - 2	cores - 2	about half of that

Which one?

• Plenty of free cores: medium.
• 2 to 4 cores, or MSPT goes up while players explore: performance. Measured on a 2 core server with two players flying through new terrain: 30 % less main thread time per tick, chunks reach the players about a quarter slower.
• You want Paper behaviour with only the protections: low.