Performance

performance.yml tunes RTP for faster or slower servers. Edit case by case - misuse (e.g. high maxAttempts plus synchronous loading) can effectively DDoS your own server.

Task timing and limits

Key	Default	Purpose
maxAttempts	32	Max location search attempts before giving up. High impact - higher values cost more CPU per request.
period	20	Ticks between background cache cycles (20 ticks = 1 second). Lower refills faster but uses more CPU.
syncAllottedTime	50	Max milliseconds per tick spent on synchronous RTP tasks.
asyncAllottedTime	50	Max milliseconds per tick spent on asynchronous RTP tasks.

World loading

Key	Default	Purpose
viewDistanceSelect	0	Chunk radius pre-loaded around candidate locations during selection. High impact.
viewDistanceTeleport	0	Chunk radius pre-loaded around the destination before teleport. High impact.
syncLoading	false	Synchronous chunk loading for selection. Not recommended - can hang the server.

Throttling and queueing

Key	Default	Purpose
minTPS	19.0	Minimum server TPS (0.0-20.0) required to queue new locations.
postTeleportQueueing	false	Immediately try to refill the cache after a teleport.

Parsing and recall

Key	Default	Purpose
onEventParsing	false	Parse permissions on every event. Incompatible with *.* permissions.
effectParsing	true	Parse effect permissions on startup.
biomeRecall	true	Reuse previously found biome locations.
biomeRecallForced	false	Only use biomes already discovered and cached.
checkOnChunkLoads	false	Passively scan for safe locations in all loaded chunks in range. High impact on busy servers.

Observational mode

Key	Default	Purpose
visitorEnabled	true	Background "region data visitor" that gathers bad-location and biome data even when the cache is full, without triggering worldgen. Low impact.

version is an internal config version - do not change it.