The server.properties File Explained

When you run your own server, almost every rule of the world is controlled by a single text file. Understanding Minecraft server properties is what turns a default world into one that plays exactly how you want, from difficulty and player limits to whether the Nether exists at all. The file is called server.properties, and it sits in your server folder waiting to be edited. This guide explains what the file is, how to change it safely, and what the most important settings actually do, so you can configure a server with confidence instead of guessing.

What the server.properties file is

The server.properties file is a plain text file that the server reads every time it starts. It is generated automatically the first time you launch a fresh server, and it holds the configuration for that world as a list of settings, each written as a name, an equals sign, and a value. You edit it with any basic text editor; there is no special software required.

Because the server only reads the file at startup, changes do not take effect while the server is running. After editing, you save the file and restart the server for the new settings to apply. If you are setting up a server for the first time, our guide on how to make a Minecraft server walks through the install process that generates this file.

How to edit it safely

Editing the file is simple, but a couple of habits prevent headaches. First, stop the server before you edit, then start it again afterward. Second, change one or two settings at a time when you are learning, so if something behaves unexpectedly you know exactly which line caused it. Third, keep a backup copy of a working file. If a typo ever stops the server from reading the file correctly, you can restore the backup and try again.

Each setting expects a particular kind of value. Some are true or false toggles, some are numbers, and some are short words like a difficulty name. Using the wrong type of value, such as a word where a number belongs, is the most common cause of a setting being ignored.

The most important settings explained

There are many lines in the file, but a core handful determine how your server feels day to day. Here are the ones worth knowing first.

Gameplay settings worth knowing

gamemode and difficulty are the two that change the feel of the world most. Together they decide whether players are crafting and surviving against tough mobs or building freely in a relaxed creative space. Setting difficulty to peaceful removes hostile mobs entirely, which is useful for build-focused servers but breaks any progression that relies on monster drops.

pvp determines whether players can hurt each other. Turn it off for cooperative servers where friends build together, and leave it on for competitive play. spawn-protection sets a radius around the world spawn where non-operators cannot place or break blocks, which protects a shared hub from being damaged.

allow-nether and similar toggles let you enable or disable whole dimensions and features. These are handy when you want a deliberately limited world, such as a challenge server that bans certain content.

Network and access settings

A second group of settings controls who can connect and how. max-players caps the number of simultaneous players, which matters both for the experience and for the load on your hardware. The server-port setting defines which network port the server listens on, relevant when you want others to connect from outside your home network.

online-mode controls whether the server verifies player accounts against the official service. Leaving it on is the standard, secure choice for a public server. The white-list setting, when enabled, restricts joining to a list of approved players, which is the simplest way to keep a private server private among friends.

If terms like ports and connections feel unfamiliar, our explainer on Minecraft server hosting covers the networking side in plain English and pairs naturally with this file reference.

Presentation and small touches

A few settings exist purely to shape how your server presents itself. The motd, short for message of the day, is the line of text players see beside your server in their server list, so it is your chance to give the world a name and personality. Other small toggles control things like whether the world generates structures and whether certain command behaviours are allowed. None of these change core gameplay, but together they make a server feel finished rather than generic.

The best way to learn the file is to change one setting, restart, and see what happens in game. Because every change is reversible and the file is just text, experimenting carries no real risk as long as you keep a backup of a known-good version.

Frequently asked questions

Where do I find the server.properties file?

It is created in your server’s main folder the first time you launch the server. If you do not see it, run the server once and it will generate the file along with the other configuration files.

Why did my change not take effect?

The server only reads the file at startup, so you must restart it after editing. If a setting is still ignored, check that you used the right kind of value, such as a number where a number is expected or true and false for toggles.

Can I break my server by editing this file?

A typo can stop a setting from working, but it rarely causes lasting damage. Keeping a backup of a working file means you can always restore it. Changing settings is reversible, so you can experiment freely.

What is the difference between online-mode true and false?

With online-mode set to true, the server verifies player accounts against the official service, which is the secure default. Turning it off removes that verification and is generally not recommended for public servers.

Do I need to edit every setting?

No. The defaults work fine for a basic world. Most people only change a handful, such as difficulty, max-players, and the message of the day, and leave the rest at their default values.