server.properties Generator and Explanations
Explanations of every setting in Minecraft's server.properties file; pick settings and download the finished file.
Load my existing server.properties file
General
motddefault: A Minecraft ServerThe description shown in the server list. & color codes are converted to the correct format automatically.
server-portdefault: 25565The TCP port the server listens on. If you change it, players must add :port to the address, or you should add an SRV record.
max-playersdefault: 20The maximum number of players that can be on at the same time.
online-modedefault: truetrue: only premium (Mojang/Microsoft) accounts can join. false: cracked players can join. Must be false on servers behind a proxy.
white-listdefault: falseIf on, only players in whitelist.json can join.
enforce-whitelistdefault: falseWhen the whitelist is reloaded, kicks online players who are not on the list.
difficultydefault: easyDifficulty: peaceful, easy, normal, hard.
gamemodedefault: survivalThe default game mode for new players.
force-gamemodedefault: falseIf on, players are reset to the default game mode on every join.
hardcoredefault: falseIf on, a dying player switches to spectator mode and the difficulty becomes hard.
pvpdefault: trueWhether players can damage each other.
World
level-namedefault: worldThe name of the world folder. To load a different world, type its folder name.
level-seeddefault: (empty)The world seed. If empty, it is generated randomly. Only effective when a new world is created.
level-typedefault: minecraft:normalWorld type: normal, flat, large_biomes, amplified.
generate-structuresdefault: trueWhether structures such as villages and temples will generate.
allow-netherdefault: trueWhether the Nether dimension can be entered.
spawn-protectiondefault: 16The radius around the spawn point where non-OPs cannot break blocks. 0 = off.
max-world-sizedefault: 29999984The maximum radius of the world border (blocks).
Performance
view-distancedefault: 10The chunk distance sent to players (3-32). Lowering it reduces bandwidth and RAM.
simulation-distancedefault: 10The distance within which mobs, plants and redstone run (3-32). The setting that affects lag the most; 6-8 is recommended.
entity-broadcast-range-percentagedefault: 100The distance from which entities are shown to players (10%-1000%).
network-compression-thresholddefault: 256Packets larger than this size (bytes) are compressed. Can be set to -1 behind a proxy.
max-tick-timedefault: 60000If a single tick exceeds this many milliseconds, the server shuts itself down. -1 = off.
sync-chunk-writesdefault: trueWrites chunks synchronously; turning it off improves performance but risks data loss in a crash.
Players and commands
allow-flightdefault: falseTurns off the fly-hack check. Recommended true on servers that use a fly plugin or elytra.
player-idle-timeoutdefault: 0A player who stays idle for this many minutes is kicked. 0 = off.
op-permission-leveldefault: 4The permission level of OPs (1-4). 4 is all commands.
function-permission-leveldefault: 2The permission level of function files (datapacks).
enable-command-blockdefault: falseWhether command blocks will run.
hide-online-playersdefault: falseIf on, player names are not shown in the server list.
enforce-secure-profiledefault: trueBlocks players without chat signatures. Must be false on cracked servers.
prevent-proxy-connectionsdefault: falseTries to block players joining via VPN / proxy (premium servers only).
Network and remote access
server-ipdefault: (empty)The IP the server binds to. Leave empty (all interfaces); fill it in only if you have multiple IPs.
enable-statusdefault: trueIf off, the server appears offline in the server list (player count and MOTD are not sent).
enable-querydefault: falseEnables the GameSpy4 query protocol (used by some lists and bots).
query.portdefault: 25565Query port (UDP).
enable-rcondefault: falseRemote console (RCON). If you enable it, set a strong password and close the port to the outside.
rcon.portdefault: 25575RCON port (TCP).
rcon.passworddefault: (empty)RCON password. If empty, RCON doesn't work.
resource-packdefault: (empty)Direct download link of the resource pack (zip).
resource-pack-sha1default: (empty)SHA-1 hash of the resource pack; recommended to avoid re-downloading on updates.
require-resource-packdefault: falseIf on, a player who rejects the resource pack can't join the server.
How to edit server.properties?
- Stop the server first; changes made while it is running may be erased on shutdown.
- Paste your existing file into the "Load my existing file" box above and change settings here, or choose from scratch.
- Download the generated file, replace the
server.propertiesin the server's main folder with it, and start the server.
server.properties is the basic settings file of a vanilla Minecraft server; Paper, Purpur and Spigot use the same file and add their own settings files on top (like paper-global.yml and spigot.yml). The two most effective settings for performance are view-distance and simulation-distance. If you run a cracked server, you need to set online-mode and enforce-secure-profile to false.
To color the MOTD use MOTD Generator, and to start the server with the right Java settings use Start Command Generator.
Guides related to this tool
Frequently Asked Questions
Where is server.properties located?
In the server's main folder, in the same place as server.jar. The server creates the file automatically on first start.
What does online-mode do?
If true, players are verified with a Mojang/Microsoft account (premium). If false, no verification is done (cracked). It must be false on servers behind a proxy (BungeeCord/Velocity); the proxy does the verification.
What's the difference between view-distance and simulation-distance?
view-distance is the chunk distance sent to the player; simulation-distance is the distance within which mobs, plants and redstone run. Lowering simulation-distance reduces lag a lot.
When do changes take effect?
When the server restarts. If you edit the file while the server is running, it may be overwritten on shutdown; stop the server first.
Other Minecraft Server Tools
Is your server ready? Add your server to the list, collect votes and automatically reward your players. All tools →