> ## 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. # Paper Global Configuration > Paper server-wide configuration options in config/paper-global.yml Paper's global configuration file contains server-wide settings that affect all worlds. This file is located at `config/paper-global.yml` and provides advanced features beyond vanilla Minecraft. ## Location ``` server-root/ └── config/ └── paper-global.yml ``` ## Configuration Reference ### Chunk Loading Maximum rate in chunks per second that the server will send to any individual player. Set to -1 to disable. Lower values reduce bandwidth and CPU usage for players with slow connections. Maximum rate at which chunks will load for any individual player. This affects chunk generation since a chunk load is issued first to test if a chunk exists. Set to -1 to disable. Maximum rate at which chunks will generate for any individual player. Set to -1 to disable this limit. Limiting generation can prevent lag spikes when players explore new areas. If true, the server will match the chunk send radius that clients have configured in their view distance settings if the client's setting is less than the server's send distance. Maximum amount of concurrent chunk loads per player. Set to 0 to let the server configure it automatically per player, or -1 to disable the limit. Maximum amount of concurrent chunk generations per player. Set to 0 for automatic configuration, or -1 to disable. ### Messages Message shown when authentication servers are unavailable. Message shown when a player is connecting too frequently. Message shown when a player is kicked for flying without permission. Default message shown when a player lacks permission for a command. Use player display names instead of usernames in quit messages. ### Proxies Whether BungeeCord proxy handles authentication. Ensure your server is properly firewalled when using BungeeCord mode! Enable Velocity modern forwarding support. Whether Velocity proxy handles authentication. The secret key from your Velocity configuration. Can also be set via the `PAPER_VELOCITY_SECRET` environment variable. This secret must match your Velocity proxy configuration exactly! Enable HAProxy PROXY protocol support. ### Performance Number of I/O threads for chunk operations. -1 uses the default calculated value. Let Paper auto-configure this unless you have specific performance requirements. Number of worker threads for chunk processing. -1 uses the default calculated value. How often (in ticks) player data should be saved. -1 uses Minecraft's default (6000 ticks/5 minutes). Maximum number of players to save per tick. Automatically calculated if set to -1. ### Console Enable syntax highlighting in the console for commands. Enable tab completions in the console using Brigadier. Whether the console should have all permissions by default. ### Spam Limiter Amount to increment spam counter for tab completion requests. Maximum tab completion spam counter before action is taken. Amount to increment spam counter for recipe requests. Maximum recipe spam counter before action is taken. Maximum incoming packet rate before throttling. Set to -1 to disable. ### Commands Suggest online player names when a command has no tab completions. Whether the `/time` command changes time in all worlds or just the executor's world. Allow mounting entities to a player in the vanilla `/ride` command. ### Item Validation Maximum character length for item display names. Maximum character length for each line of item lore. Maximum character length for book titles. Maximum character length for book authors. Maximum character length for book pages. Maximum number of pages in a book. Set to -1 to disable. Multiplier for total book size validation. Whether to resolve entity selectors in book text. Enabling this can have security implications! ### Watchdog Interval in milliseconds between watchdog early warnings. Delay in milliseconds before the watchdog starts issuing warnings. ### Miscellaneous Enable the built-in Spark profiler. Enable Spark immediately on server startup. Enable player-to-player collisions. Send full position updates for entities with hard collisions. Track scoreboards created by plugins in `/paper dumpplugins`. Save scoreboard teams even when they have no members. Deobfuscate stacktraces to readable Mojang mappings. This makes error messages much easier to understand! Number of region files to keep cached. Minimum value is 4. Use an alternative luck formula. See [https://luckformula.emc.gs](https://luckformula.emc.gs) for details. Load permissions.yml before plugins are enabled. Whether the nether dimension is enabled and will be loaded. ### Block Updates Disable note block updates for redstone contraptions. Disable tripwire updates. Disable chorus plant updates. Disable mushroom block updates. ## Example Configuration ```yaml theme={null} chunk-loading-basic: player-max-chunk-send-rate: 75.0 player-max-chunk-load-rate: 100.0 player-max-chunk-generate-rate: -1.0 proxies: velocity: enabled: true online-mode: true secret: "your-secret-here" chunk-system: io-threads: -1 worker-threads: -1 console: enable-brigadier-highlighting: true enable-brigadier-completions: true spark: enabled: true logging: deobfuscate-stacktraces: true ``` ## Related Configuration Per-world specific settings Optimize your server performance Changes to `paper-global.yml` require a server restart or use the `/paper reload` command. Some settings may require a full restart.