paper-world-defaults.yml Explained
Understand paper-world-defaults.yml, Paper per-world inheritance, world overrides, entity and spawning settings, and how to avoid broken config copies.
paper-world-defaults.yml is one of the most important Paper files for performance tuning. It defines default world behavior, and worlds can inherit those defaults unless you override specific values.
Inheritance Model
| Location | Purpose |
| --- | --- |
| config/paper-world-defaults.yml | Defaults for worlds |
| world/dimensions/minecraft/overworld/paper-world.yml | Overworld overrides |
| world/dimensions/minecraft/the_nether/paper-world.yml | Nether overrides |
| world/dimensions/minecraft/the_end/paper-world.yml | End overrides |
Paper docs emphasize that per-world files do not need full copies of the defaults. Add only the exact setting you want to override.
Why This Matters
A survival overworld, nether roof, lobby, event world, and resource world may need different behavior.
Examples:
- Lower monster limits in a resource world.
- Different despawn behavior for an event world.
- Stricter entity settings in a lobby.
- Different feature choices in custom worlds.
Do not force one global value if only one world has the problem.
Performance Areas
Common areas to investigate:
| Area | Related guide | | --- | --- | | Entity activation and ticking | Entity lag | | Mob spawning | Optimize mob spawning | | Villager behavior | Villager lag | | Chunk behavior | Chunk lag | | Redstone and farms | Redstone lag |
Use a profile before editing. World config is powerful because it can fix the right world; it is risky because it can change gameplay quietly.
Safe Editing Workflow
- Stop the server or schedule a maintenance window.
- Back up the config and affected world.
- Change one setting group.
- Restart cleanly.
- Test the world where the change matters.
- Capture another profile during similar activity.
If you need server-wide Paper behavior instead, read paper-global.yml explained.
FAQ
What does paper-world-defaults.yml control?
It controls default Paper world settings that apply to worlds unless a specific world overrides them.
Should I copy the full defaults into each paper-world.yml?
No. Only copy the specific values you want to override for that world.
Can different worlds have different settings?
Yes. Paper supports per-world overrides through paper-world.yml files inside world dimension folders.
Related Tools
server.properties Generator
Generate a clean Minecraft server.properties baseline for online mode, max players, difficulty, view distance, simulation distance, and command blocks.
Startup Log Classifier
Paste a Minecraft startup log excerpt to classify Java mismatch, port conflicts, memory errors, plugin failures, dependency issues, and TPS overload.
Paper vs Spigot vs Purpur Comparison Tool
Compare Paper, Spigot, and Purpur for Minecraft servers based on vanilla behavior, performance tooling, customization, and plugin compatibility.
Related Articles
paper-global.yml Explained
Understand paper-global.yml on Paper servers, what belongs in global settings, what not to edit blindly, and how to document safe performance changes.
Paper Optimization Guide
Optimize Paper Minecraft servers with profiling, server.properties, paper-global.yml, paper-world-defaults.yml, entity settings, chunks, and plugin audits.
How to Optimize Mob Spawning
Optimize Minecraft mob spawning by tuning spawn limits, despawn ranges, simulation distance, farms, per-world settings, and player expectations safely.