Skip to content
Minecraft

Minecraft server.properties Explained (Every Setting That Matters)

8 min read Updated 16 July 2026 ESAGAMES Team

server.properties is the main config file for a Minecraft server — one line per setting, editable in any text editor or your control panel. Here is what the settings that actually matter do, grouped by what you are trying to change.

How to edit it

Edit server.properties in the server folder (or the config editor in your panel), change one value per line, save, and restart the server. Values are case-sensitive: true/false, or plain text and numbers.

Gameplay settings

  • gamemode — the default mode (survival, creative, adventure, spectator).
  • difficulty — peaceful, easy, normal or hard.
  • hardcore — true locks difficulty to hard with permanent death.
  • pvp — whether players can damage each other.
  • force-gamemode — reset players to the default gamemode on join.
  • spawn-monsters / spawn-animals / spawn-npcs — control mob spawning.

Access & security

  • online-mode — verify players against Mojang/Microsoft. Keep this true.
  • white-list / enforce-whitelist — restrict who can join. See whitelisting.
  • max-players — the player slot limit.
  • server-port — the port players connect to (default 25565).
  • motd — the text shown for your server in the multiplayer list.

World settings

  • level-name — the world folder to load.
  • level-seed — the seed for a new world.
  • level-type — normal, flat, large biomes, amplified.
  • generate-structures — villages, temples and the rest.
  • spawn-protection — a block radius near spawn only ops can build in.

Performance settings

These two lines affect performance more than any others:

  • view-distance — how many chunks are sent to players. High values hit TPS and RAM hard.
  • simulation-distance — how far entities and ticks actually run — often the bigger lever for lag.
  • max-tick-time — the watchdog timeout before the server considers itself hung.
  • network-compression-threshold — packet compression tuning.

Lowering view-distance and simulation-distance is the quickest way to fix a laggy server — see settings to reduce lag and the "Can't keep up" fix.

The settings people change most

  1. gamemode and difficulty — see this guide.
  2. max-players, motd and server-port.
  3. view-distance and simulation-distance for performance.
  4. white-list, pvp and online-mode.

Common mistakes

  • Editing the file but not restarting the server.
  • Setting online-mode=false without meaning to — a real security risk.
  • Cranking view-distance too high and causing lag.
  • A typo or stray space breaking a line so it is ignored.
server.properties is just one setting per line. Change what you need, keep online-mode on, and restart — most of running a server comes down to these lines.

Edit settings without the hassle

Change server.properties from a clean config editor in the panel — Minecraft hosting on fast CPUs, protected and online in minutes.

Minecraft hosting
FAQ

Frequently asked questions

Where is the server.properties file?

In the root folder of your Minecraft server, next to the server jar. On a control panel it is usually under a "Config" or "Files" section, often with a friendly editor.

Do I need to restart after editing server.properties?

Yes — the file is read when the server starts, so changes only take effect after a restart. A few settings can also be changed live with commands, like /difficulty.

What does online-mode do in server.properties?

With online-mode=true the server verifies every player against Mojang/Microsoft, allowing only genuine accounts — the secure default. Setting it false allows cracked clients but removes that protection.

Which server.properties settings affect performance most?

view-distance and simulation-distance. Both control how much of the world the server keeps active; lowering them is the quickest way to improve TPS and reduce RAM use on a laggy server.

What is spawn-protection in Minecraft?

A radius of blocks around spawn that only operators can build in or break. Set spawn-protection=0 to disable it, for example on a server where players build near spawn.

Further reading

Go deeper on this

Guides and explainers that pair with this fix — from our guides and blog.

Knowledge base

Related articles

Skip the troubleshooting

Managed, protected hosting in Frankfurt — we handle the Linux, the network and the DDoS so you don't have to.

Payments Secure checkout with cards, banking apps and digital wallets.

Choose the payment flow that fits your stack and region without leaving the platform.

Pay by Zen Visa Mastercard Paysafecard PaysafeCash Skrill Trustly Bancontact UnionPay iDeal WebMoney