ACLClouds
ACLClouds

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

  1. Stop the server from the console or the panel.
  2. Replace server.properties with the generated file, or copy only the changed lines: one key per line, as key=value.
  3. Start the server and read the first console lines: an invalid value is reported and replaced by its default.
  4. 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.