Skip to main content
The server.properties file contains the standard Minecraft server configuration options. This file is located in your server’s root directory and is shared across all server implementations.

​
Location

​
Core Settings

​
integer
default:"25565"
The port number the server listens on for incoming connections.
​
string
default:""
The IP address the server should bind to. Leave empty to bind to all available interfaces.
​
integer
default:"20"
Maximum number of players that can connect simultaneously.
​
integer
default:"256"
Packets larger than this size (in bytes) will be compressed. Set to -1 to disable compression.
Lower values increase CPU usage but reduce bandwidth. Higher values do the opposite.
​
boolean
default:"true"
Whether to authenticate players with Mojang’s authentication servers.
Only disable this if you’re using a proxy with its own authentication (BungeeCord/Velocity).
​
string
default:"world"
The name of the world folder. The server will create this folder if it doesn’t exist.
​
string
default:""
The seed for world generation. Leave empty for a random seed.
​
string
default:"minecraft:normal"
The type of world to generate. Options:
  • minecraft:normal - Standard world generation
  • minecraft:flat - Superflat world
  • minecraft:large_biomes - Larger biome sizes
  • minecraft:amplified - Extreme terrain generation
​
string
default:""
JSON settings for custom world generation. Used with custom world types.
​
boolean
default:"true"
Whether the Nether dimension is enabled.
Paper also provides a global configuration option misc.enable-nether for this setting.
​
integer
default:"16"
Radius in blocks around spawn where only operators can place/break blocks. Set to 0 to disable.
​
string
default:"easy"
The world difficulty level: peaceful, easy, normal, or hard.
​
boolean
default:"false"
If true, players are banned upon death and the difficulty is locked to hard.
​
boolean
default:"true"
Enable player versus player combat.
​
string
default:"survival"
Default gamemode for new players: survival, creative, adventure, or spectator.
​
boolean
default:"false"
Force players to join in the default gamemode.
​
integer
default:"29999984"
Maximum radius of the world border in blocks. The diameter will be 2x this value.
​
integer
default:"10"
The number of chunks sent to players (radius around the player). Higher values increase server load.
For better performance, use values between 6-10. Players can set lower values in their client.
​
integer
default:"10"
The number of chunks around players where mobs spawn and entities tick. Cannot exceed view-distance.
​
integer
default:"100"
Percentage to scale entity tracking range. Lower values reduce bandwidth but may cause entities to disappear.
​
string
default:""
URL to a resource pack. Players will be prompted to download it.
​
string
default:""
SHA-1 hash of the resource pack for verification.
​
string
default:""
Custom message shown to players when prompted to download the resource pack.
​
boolean
default:"false"
If true, players must accept the resource pack to join the server.
​
integer
default:"60000"
Maximum time (in milliseconds) a single tick can take before the server watchdog triggers.
Set to -1 to disable the watchdog. Only do this if you understand the implications.
​
boolean
default:"true"
Whether chunk writes should be synchronous. Disabling may improve performance but risks data loss.
​
boolean
default:"false"
Enable command blocks on the server.
​
integer
default:"2"
Permission level for functions. Levels: 1-4 (1=bypass spawn protection, 2=use command blocks, 3=operator commands, 4=all commands).
​
string
default:"A Minecraft Server"
Message of the day displayed in the server list. Supports color codes with §.
​
string
default:"Unknown Server"
The name of the server shown in various contexts.
​
boolean
default:"true"
Whether the server appears in the server list and responds to status requests.
​
boolean
default:"false"
Hide player list from server queries.
​
boolean
default:"true"
Require players to have signed chat messages (1.19.1+).
​
boolean
default:"false"
Block players connecting through proxies.
Do not enable if using BungeeCord or Velocity!
​
boolean
default:"false"
Kick players not on the whitelist immediately.
​
boolean
default:"false"
Enable the whitelist system.
​
boolean
default:"false"
Enable JMX monitoring for advanced server metrics.
​
boolean
default:"false"
Enable remote console (RCON) for server management.
​
integer
default:"25575"
Port for RCON connections.
​
string
default:""
Password for RCON authentication.
Use a strong password and restrict access to trusted IPs only!
​
boolean
default:"true"
Send RCON output to online operators.
​
boolean
default:"true"
Send console command output to online operators.

​
Example Configuration

Paper Global Config

Server-wide Paper-specific settings

World Configuration

Per-world Paper configuration
Changes to server.properties require a server restart to take effect, except for certain settings that can be changed with commands (like difficulty).