Minecraft server.properties Explained (Every Setting That Matters)
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.
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
- gamemode and difficulty — see this guide.
- max-players, motd and server-port.
- view-distance and simulation-distance for performance.
- white-list, pvp and online-mode.
Common mistakes
- Editing the file but not restarting the server.
- Setting
online-mode=falsewithout meaning to — a real security risk. - Cranking
view-distancetoo 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.
Minecraft is a trademark of Mojang Synergies AB / Microsoft. ESAGAMES is an independent hosting provider, not affiliated with or endorsed by Mojang or Microsoft.
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.
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.
Go deeper on this
Guides and explainers that pair with this fix — from our guides and blog.
How to Make a Minecraft Server
Set up a Java server from scratch — version, server.properties, EULA and going live.
ReadSettings to Reduce Minecraft Lag
View distance, Paper tuning and pre-generation for a smooth 20 TPS.
ReadBest Free Minecraft Plugins
EssentialsX, LuckPerms, WorldGuard and CoreProtect — the essentials.
ReadBest Minecraft Modpacks to Host
The best packs to run, and the RAM each one needs.
ReadRelated articles
Fix Minecraft "java.lang.OutOfMemoryError: Java heap space"
Server crashing with "OutOfMemoryError: Java heap space"? Every cause and how to fix it for good.
Read fix MinecraftHow to Allocate More RAM to a Minecraft Server
Give your Minecraft server more RAM — the -Xmx/-Xms flags, doing it in a panel, and how much to allocate.
Read fix MinecraftWhy Can't My Friends Join My Minecraft Server? (Every Fix)
Friends stuck on "Can't connect to server"? Every cause — IP, port, firewall, version, whitelist — and the fix.
Read fix