> ## Documentation Index > Fetch the complete documentation index at: https://mintlify.com/PaperMC/Paper/llms.txt > Use this file to discover all available pages before exploring further. # World Configuration > Per-world Paper configuration options in config/paper-world-defaults.yml Paper's world configuration allows you to customize settings on a per-world basis. The default configuration is stored in `config/paper-world-defaults.yml`, and you can create world-specific overrides. ## Location ``` server-root/ └── config/ ├── paper-world-defaults.yml # Default settings for all worlds └── paper-world.yml # World-specific overrides (auto-generated) ``` ## Entity Settings ### Spawning Per-world mob spawn limits for each category. -1 uses the server default from `bukkit.yml`. Categories: `monster`, `creature`, `ambient`, `axolotls`, `underground_water_creature`, `water_creature`, `water_ambient` ```yaml theme={null} spawn-limits: monster: 70 creature: 10 ambient: 15 water_creature: 5 ``` Ticks between spawn attempts for each category. Higher values reduce spawn rates. -1 uses bukkit.yml defaults. Enable per-player mob spawning for more consistent spawning near players. This creates a better single-player-like experience in multiplayer! Distance at which mobs begin to have a chance to despawn. Uses vanilla default if not set. Distance at which mobs immediately despawn. Uses vanilla default if not set. ```yaml theme={null} despawn-ranges: monster: soft: 32 hard: 128 ``` Shape used for calculating despawn ranges. Options: `ellipsoid` or `cylinder`. Ticks before arrows shot by non-players despawn. -1 disables despawning. Ticks before arrows shot by creative mode players despawn. Maximum invulnerability ticks for arrows before forced despawn. Set to -1 to disable. Make all chunks valid for slime spawning. Allow iron golems to spawn without a full solid block beneath them. Count all mobs (including those from spawners) towards spawn caps. Chance for skeleton horses to spawn during thunderstorms. Use vanilla default if not set. Maximum light level at which monsters can spawn. Vanilla default is 0. Length of a "minute" in ticks for wandering trader spawn timing. Length of a "day" in ticks for wandering trader spawn timing. Minimum spawn chance percentage for wandering traders. Maximum spawn chance percentage for wandering traders. Enable custom despawn rates for specific items. Map of items to their despawn time in ticks. ```yaml theme={null} alt-item-despawn-rate: enabled: true items: minecraft:cobblestone: 300 minecraft:dirt: 300 minecraft:gravel: 300 ``` Useful for reducing lag from common items like cobblestone! ### Behavior Speed modifier for baby zombies (0.5 = 50% faster than adults). Allow mobs from spawners to jump when nerfed. Whether zombies should pathfind to and trample turtle eggs. Whether piglins become angry when players open chests. Allow spiders to climb the world border. Remove the ender dragon after it's been defeated. Always place a dragon egg when the ender dragon dies (even on respawns). Prevent phantoms from spawning for creative mode players. Phantoms only attack players who haven't slept. Ticks before phantoms can start spawning for a player (72000 = 3 days). Minimum seconds between phantom spawn attempts. Maximum seconds between phantom spawn attempts. Completely disable pillager patrols. Chance (0.0-1.0) for patrols to spawn. Day number when patrols can start spawning. Ticks between patrol spawn attempts. Chance for villagers to become zombie villagers when killed by zombies. -1 uses vanilla behavior. Allow all zombies to pick up loot (not just those that spawn with the ability). Allow all skeletons to pick up loot. Disable critical hits for players. Prevent zombie pigmen from spawning through nether portals from dropping items. Maximum value for merged experience orbs. -1 disables limit. Prevent merging items that are not on the same y level, preventing visual artifacts. Useful for preventing items from appearing to merge through floors. ### Armor Stands & Markers Whether armor stands should tick. Disabling improves performance but breaks some functionality. Whether armor stands should perform collision lookups. Whether marker entities should tick. ## Anticheat ### Anti-Xray Enable Paper's anti-xray system. This adds CPU overhead. Test performance on your server! Anti-xray engine mode: * `hide`: Hide ores by replacing them with stone * `obfuscate`: Mix real and fake ores (more CPU intensive but more effective) Maximum Y level where anti-xray is active. Radius to update when blocks are broken (engine mode 2 only). Whether lava should obscure blocks like stone does. Require `paper.antixray.bypass` permission to bypass anti-xray. List of blocks to hide or obfuscate. ```yaml theme={null} hidden-blocks: - minecraft:copper_ore - minecraft:deepslate_copper_ore - minecraft:gold_ore - minecraft:iron_ore - minecraft:diamond_ore - minecraft:emerald_ore - minecraft:chest - minecraft:ender_chest ``` Blocks used to replace hidden blocks (engine mode 1) or fake ores (engine mode 2). ## Environment Disable thunder and lightning in this world. Prevent ice and snow from forming. Ticks between fire spread attempts. Higher values slow fire spread. Use optimized explosion algorithm (faster but may change behavior slightly). Disable knockback from explosions. Radius to search for existing nether portals. Radius within which to create a new nether portal. Use vanilla dimension scaling when searching for portals (1:8 for nether). Enable treasure map generation. Allow villager trades to give maps to already-discovered structures. Allow loot table maps to point to already-discovered structures. ## Chunks Ticks between automatic chunk saves. -1 or default uses bukkit.yml value. Maximum chunks to save per tick during auto-save. Delay before unloading chunks (supports time units: s, m, h, d). Keeping chunks loaded longer reduces repeated loading for players moving back and forth. Prevent players from moving into unloaded chunks. Limit entities saved per chunk by type. Prevents lag from entity overflow. ```yaml theme={null} entity-per-chunk-save-limit: experience_orb: 16 snowball: 16 ender_pearl: 16 arrow: 16 ``` ## Performance Options Add cooldown to hoppers when the container is full, reducing checks. Disable InventoryMoveItemEvent for hoppers (breaks plugins that use it). Only enable this if you know what you're doing! Skip checks for blocks above hoppers. Ticks between grass spread attempts. Higher = slower spread but better performance. Ticks between container updates. Ticks between mob spawner attempts. Redstone implementation to use: * `vanilla`: Standard Minecraft redstone * `eigencraft`: Eigencraft redstone implementation * `alternate_current`: Modern alternate current redstone Changing this affects redstone behavior and contraption functionality! ## Example Configuration ```yaml theme={null} entities: spawning: spawn-limits: monster: 70 creature: 10 per-player-mob-spawns: true alt-item-despawn-rate: enabled: true items: minecraft:cobblestone: 300 anticheat: anti-xray: enabled: true engine-mode: hide max-block-height: 64 chunks: auto-save-interval: -1 delay-chunk-unloads-by: 10s hopper: cooldown-when-full: true disable-move-event: false ``` ## Per-World Overrides To create world-specific settings, the server automatically generates `config/paper-world.yml` with sections for each world: ```yaml theme={null} world_list: world: # Overworld entities: spawning: spawn-limits: monster: 50 world_nether: # Nether anticheat: anti-xray: enabled: false ``` Server-wide settings Optimize these settings for performance