Paper Config Builder

Configure key PaperMC optimization settings. Only settings that differ from Paper's defaults are included in the output — paste directly into your config files.

These settings go in config/paper-world-defaults.yml and config/paper-global.yml. Restart your server after changing them.

Presets:

Chunks

alt-item-despawn-rate.enabled

Allow custom despawn timers per item type. Reduces item entity lag.

delay-chunk-unloads-by

Delay before unloading unused chunks. Reduces reload overhead near boundaries.

entity-per-chunk-save-limit (arrows)

Max arrows saved per chunk. -1 disables. Set ~16 to reduce save lag on Arrow-heavy servers.

Mobs

despawn-ranges.monster.soft

Mobs beyond this range from a player may be randomly despawned.

despawn-ranges.monster.hard

Mobs beyond this range are immediately despawned. Default: 128.

prevent-moving-into-unloaded-chunks

Prevent entities from moving into unloaded chunks (avoids crashes).

zombie-aggressive-towards-villager-when-lagging

Zombies chase villagers only when the server isn't lagging. Disable for a small perf gain.

Performance

tick-rates.sensor.villager.secondarypoisensor

Reduce from 40 to 80+ to greatly lower villager CPU usage on busy servers.

fix-clamped-controlled-falling

Fix a vanilla bug where players fall through blocks when riding. Recommended on.

Anti-Xray

anticheat.anti-xray.enabled

Enable server-side ore obfuscation to block X-ray resource packs and clients.

Global (paper-global.yml)

packet-limiter.max-packet-rate

Max packets per second per player before throttling kicks in. Default: 500.

velocity-support.enabled

Enable if your server is behind a Velocity proxy. Requires a forwarding secret.

proxy-protocol

Enable HAProxy PROXY protocol support. Only enable if your network layer requires it.

paper-world-defaults.yml

config/paper-world-defaults.yml

No world settings differ from defaults.

paper-global.yml

config/paper-global.yml

No global settings differ from defaults.

Only settings that differ from Paper's defaults are shown. Merge the blocks into your existing config files — do not replace the entire file.

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.