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 Server

The description shown in the server list. & color codes are converted to the correct format automatically.

server-portdefault: 25565

The 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: 20

The maximum number of players that can be on at the same time.

online-modedefault: true

true: only premium (Mojang/Microsoft) accounts can join. false: cracked players can join. Must be false on servers behind a proxy.

white-listdefault: false

If on, only players in whitelist.json can join.

enforce-whitelistdefault: false

When the whitelist is reloaded, kicks online players who are not on the list.

difficultydefault: easy

Difficulty: peaceful, easy, normal, hard.

gamemodedefault: survival

The default game mode for new players.

force-gamemodedefault: false

If on, players are reset to the default game mode on every join.

hardcoredefault: false

If on, a dying player switches to spectator mode and the difficulty becomes hard.

pvpdefault: true

Whether players can damage each other.

World

level-namedefault: world

The 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:normal

World type: normal, flat, large_biomes, amplified.

generate-structuresdefault: true

Whether structures such as villages and temples will generate.

allow-netherdefault: true

Whether the Nether dimension can be entered.

spawn-protectiondefault: 16

The radius around the spawn point where non-OPs cannot break blocks. 0 = off.

max-world-sizedefault: 29999984

The maximum radius of the world border (blocks).

Performance

view-distancedefault: 10

The chunk distance sent to players (3-32). Lowering it reduces bandwidth and RAM.

simulation-distancedefault: 10

The 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: 100

The distance from which entities are shown to players (10%-1000%).

network-compression-thresholddefault: 256

Packets larger than this size (bytes) are compressed. Can be set to -1 behind a proxy.

max-tick-timedefault: 60000

If a single tick exceeds this many milliseconds, the server shuts itself down. -1 = off.

sync-chunk-writesdefault: true

Writes chunks synchronously; turning it off improves performance but risks data loss in a crash.

Players and commands

allow-flightdefault: false

Turns off the fly-hack check. Recommended true on servers that use a fly plugin or elytra.

player-idle-timeoutdefault: 0

A player who stays idle for this many minutes is kicked. 0 = off.

op-permission-leveldefault: 4

The permission level of OPs (1-4). 4 is all commands.

function-permission-leveldefault: 2

The permission level of function files (datapacks).

enable-command-blockdefault: false

Whether command blocks will run.

hide-online-playersdefault: false

If on, player names are not shown in the server list.

enforce-secure-profiledefault: true

Blocks players without chat signatures. Must be false on cracked servers.

prevent-proxy-connectionsdefault: false

Tries 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: true

If off, the server appears offline in the server list (player count and MOTD are not sent).

enable-querydefault: false

Enables the GameSpy4 query protocol (used by some lists and bots).

query.portdefault: 25565

Query port (UDP).

enable-rcondefault: false

Remote console (RCON). If you enable it, set a strong password and close the port to the outside.

rcon.portdefault: 25575

RCON 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: false

If on, a player who rejects the resource pack can't join the server.

Download server.properties

How to edit server.properties?

  1. Stop the server first; changes made while it is running may be erased on shutdown.
  2. Paste your existing file into the "Load my existing file" box above and change settings here, or choose from scratch.
  3. Download the generated file, replace the server.properties in 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 →