Minecraft server.properties generator
Build the server.properties file of your Minecraft Java server: MOTD, players, difficulty, view distance, whitelist, RCON. Free, up to date for 1.21.
Set up your Minecraft Java server in a clear form and download a complete server.properties, ready to drop into the server folder. Nothing is sent anywhere: it all runs in your browser.
What is server.properties for?
server.properties is the settings file of a Minecraft Java server. It sits at the root of the server folder, next to the .jar file, and is created on first start. Paper, Spigot and Purpur read the same file; Bedrock uses other keys.
The server only reads it at startup: a value changed while it runs has no effect, and the server rewrites the file when it stops. Always stop the server before editing it.
The settings that matter
Defaults of the vanilla server, and what each key changes.
| Key | Default | What it sets |
|---|---|---|
| motd | A Minecraft Server | Text shown under the server name in the server list |
| max-players | 20 | Number of players online at once |
| online-mode | true | Checks Minecraft accounts with Mojang |
| white-list | false | Only whitelisted players can join |
| difficulty | easy | peaceful, easy, normal or hard |
| gamemode | survival | Game mode of new players |
| view-distance | 10 | Chunks sent around each player |
| simulation-distance | 10 | Chunks where entities and redstone are active |
| spawn-protection | 16 | Radius around spawn only operators can edit |
| server-port | 25565 | TCP port of the server |
| level-seed | (empty) | World seed, random when empty |
| allow-flight | false | Stops kicking players who fly with a mod |
| enable-rcon | false | Remote console, with rcon.port and rcon.password |
Edit the file without breaking the server
- Stop the server from the console or the panel.
- Replace server.properties with the generated file, or copy only the changed lines: one key per line, as key=value.
- Start the server and read the first console lines: an invalid value is reported and replaced by its default.
- If players can no longer join, check server-port and online-mode first.
What changed in 1.21
- 1.21.2: spawn-animals and spawn-npcs are removed; pause-when-empty-seconds pauses an empty server.
- 1.21.9: pvp, allow-nether, enable-command-block and spawn-monsters become game rules (/gamerule pvp false).
- 1.21.9: new management-server-* keys for the server management API, off by default.
- The generator writes the keys of the selected version: “1.20 to 1.21.8” keeps pvp and the keys removed since.
Frequently asked questions
Where is the server.properties file?
At the root of the server folder, next to the .jar file. It is created on first start. On a hosted server, open the panel file manager: it is in the main folder.
How do I apply server.properties changes?
Stop the server, edit or replace the file, then start it again. The /reload command does not read server.properties, and the server rewrites the file when it stops: a change made while it runs is lost.
Which view-distance should I use?
The default is 10. On a small machine or with many players, 6 to 8 clearly lowers RAM and CPU use. Lower simulation-distance too (4 to 6): it is the costliest in computing.
Why is PvP no longer in server.properties?
Since 1.21.9, pvp, allow-nether, enable-command-block and spawn-monsters are game rules. Use /gamerule pvp false in the console. For an older server, pick the “1.20 to 1.21.8” version in the generator.
Should I set online-mode to false?
Only behind a proxy such as Velocity or BungeeCord, which checks accounts itself. Otherwise anyone can join with any username, an administrator’s included.