To edit a Minecraft server, stop it when possible, open server.properties from the server’s working directory in a plain-text editor, change only the value after an exact key=, save the file, and restart the server. The Java and Bedrock files are not interchangeable, and the server can rewrite the file when it starts.
Playing with friends? Godlike.Host runs hosted Minecraft Java servers from 10 data-center locations, with free DDoS protection.
What server.properties controls
server.properties is the text configuration file read by Minecraft server software. Each setting is written as a property name, an equals sign, and a value. For example, the whitelist setting is written as white-list=true. The property name is the key; the text after = is the value you can change.
| # | Preview | Product | Price | |
|---|---|---|---|---|
| 1 |
|
Minecraft | Java & Bedrock Deluxe Collection | Windows Digital Code | $39.99 | Buy on Amazon |
| 2 |
|
Minecraft | Java & Bedrock Ultimate Collection | Windows Digital Code | $49.99 | Buy on Amazon |
| 3 |
|
Minecraft | Standard Edition | XBOX Digital Code | $19.99 | Buy on Amazon |
| 4 |
|
Minecraft | $6.99 | Buy on Amazon |
| 5 |
|
Minecraft - Bedrock Edition PS4 | $42.98 | Buy on Amazon |
As an Amazon Associate I earn from qualifying purchases.
The file is not a document with formatting, menus, or a Minecraft-specific editor. It is ordinary text. A formatting editor can insert hidden characters or change line endings, so use a plain-text editor such as Notepad, TextEdit in plain-text mode, Kate, nano, or Vim.
Find the correct file first
The file is created in the server software’s current working directory. That is the folder from which the server process was started, not necessarily the folder containing the server JAR. If a startup script, control panel, service, or container launches the server from another directory, server.properties is created there instead.
#1 Best Overall
- DELUXE COLLECTION — Includes Minecraft: Java & Bedrock Edition, three Bedrock add-ons, three exclusive Character Creator items, and 700 Minecoins.
- CREATE YOUR WORLD — Build whatever you imagine in an infinite world that’s unique in every playthrough.
- EXPLORE AND CRAFT — Discover biomes, resources, and mobs, then craft your way through a sandbox world filled with surprises.
- SURVIVE THE ADVENTURE — Face mysterious foes, travel across exciting landscapes, and venture into perilous dimensions.
- PLAY TOGETHER — Play cross-platform with friends in Bedrock Edition on console, mobile, and PC, or join community servers in Java Edition on PC, Mac, and Linux. Online console multiplayer requires a platform-specific subscription (sold separately).
Use the launch folder, not a similarly named copy
Stop and identify the directory used by the command that starts the server. If you find several Minecraft folders, check which one contains the world and other files used by the running instance. Editing a copy elsewhere has no effect because the server never reads it.
If the file does not exist
The Minecraft Wiki tutorial documents an --initSettings option that initializes server.properties and eula.txt without starting the server. Run the same Java server command you normally use, adding the option after the server JAR, for example:
java -jar server.jar --initSettingsReplace server.jar with the filename used by your installation. The option creates missing files with default values; it does not mean that an unrelated directory will be used. Run it from the directory in which you want those files to live.
Rank #2
- ULTIMATE COLLECTION — Includes Minecraft: Java & Bedrock Edition, five Bedrock add-ons, five exclusive Character Creator items, and 1000 Minecoins.
- CREATE YOUR WORLD — Build whatever you imagine in an infinite world that’s unique in every playthrough.
- EXPLORE AND CRAFT — Discover biomes, resources, and mobs, then craft your way through a sandbox world filled with surprises.
- SURVIVE THE ADVENTURE — Face mysterious foes, travel across exciting landscapes, and venture into perilous dimensions.
- PLAY TOGETHER — Play cross-platform with friends in Bedrock Edition on console, mobile, and PC, or join community servers in Java Edition on PC, Mac, and Linux. Online console multiplayer requires a platform-specific subscription (sold separately).
Prepare safely before editing
- Stop the server if you can. A running process may save its own version of the file while you are editing it.
- Keep a backup. Copy the original file before changing it so you can restore a known working configuration.
- Use plain text. Do not open the file in a word processor or a rich-text editor.
- Record your changes elsewhere. Startup can rewrite the file and remove comments you added.
- Confirm the edition. Java and Bedrock use different property keys; a Java key in a Bedrock file can be silently ignored.
Open and edit the file
- Stop the Minecraft server, preferably through its normal console or service controls.
- Open the server’s working directory in your file manager or terminal.
- Make a backup copy of
server.properties. - Open the original file in a plain-text editor.
- Find the property you need. A line that begins with
#is a comment and does not affect the game. - Leave the key exactly as written and edit only the value to the right of the first equals sign.
- Save as plain text, preserving the filename
server.properties. Do not let the editor add a second extension such as.txt. - Start the server again, or use the documented reload path when the particular setting supports it.
The required line format
A normal active line has this form:
key=valueDo not rename the key, add quotation marks, or turn the line into a comment. For a Boolean setting, use the value expected by the property, such as true or false. Keep the spelling and punctuation of the key exact; a near match is a different property and may be ignored or replaced.
Comments and blank lines
Lines beginning with # are comments. They are useful for notes while the file remains readable, but they are not settings. The server may remove comments when it rewrites the file, so keep permanent documentation in a separate text file or version-controlled note.
Example: change the whitelist setting
Whitelist behavior illustrates the complete workflow. To enable the setting in a Java server file, change the active line to:
Rank #3
- CREATE YOUR WORLD — Build whatever you imagine in an infinite world that is unique in every playthrough.
- EXPLORE AND CRAFT — Discover biomes, resources, and mobs, then craft your way through a sandbox world full of surprises.
- SURVIVAL ADVENTURES — Face mysterious foes, travel across varied landscapes, and venture into perilous dimensions.
- PLAY TOGETHER — Play solo or join friends in local split-screen and cross-platform play across console, mobile, and PC. Online multiplayer supports up to 8 players.
- COMMUNITY PLAY — Connect with players on community servers, or subscribe to Realms Plus (sold separately) to play with up to 10 friends on a private server.
white-list=trueSave the file and restart the server. The setting is described as disabled by default in the general Java documentation, but a GameServerKings guide claims that the default changed from false to true in version 26.3. That is a version-sensitive, third-party claim, so inspect the value generated in your own release rather than assuming one universal default.
Reloading a changed whitelist
NamuWiki notes that after a whitelist change, only players already present on the existing whitelist can join until /reload loads the modified list. The /reload command can be entered in the server console or in game by an authorized operator.
The same GameServerKings guide describes enforce-whitelist as controlling what happens to players who are already online when the whitelist is reloaded. Because that behavior and the claimed 26.3 default are third-party, version-dependent details, check the documentation for the exact server release before relying on them for moderation or access control.
Rank #4
- Skins! We have biome settlers, city folk, town folk, and more!
- The Nether and all its inhabitants. Fight Ghasts and make friends with Pigmen
- Cross platform play for up to five players between Pocket Edition and Windows 10
- Revamped touch controls, controller support, and a controller mapping screen
- Enhanced Weather effects! Accumulating snow and more
Apply changes: restart or /reload?
| Method | How to use it | What it is appropriate for | Important qualification |
|---|---|---|---|
| Full restart | Stop the server cleanly, then start it again from its normal working directory. | The reliable way to apply the complete file. | The Minecraft Wiki states that restarting applies changes; it also gives no guarantee that every property is handled by a reload. |
/reload |
Run /reload from the console or in game with the required permission. |
A faster way to load changes when the affected feature supports it, including the documented whitelist workflow. | The scope of /reload for every server.properties key is not fully established in the available documentation. |
If the change affects how the server starts, networking, or another setting for which reload behavior is not explicitly documented, choose a clean restart. A reload is not a substitute for correcting a malformed line or editing the wrong file.
Why a server can change the file after you save it
On startup, Minecraft can add properties that are missing and supply defaults. A third-party reference also reports that missing or invalid values are replaced and that the file is rewritten. This rewrite can strip comments you inserted and can make a hand-edited file look different after the next launch.
How to work with rewrites
- Make one deliberate change at a time when diagnosing a problem.
- Start the server and reopen the file to see the value that was accepted.
- If your value disappeared, check the key spelling, value format, and whether you edited the active server directory.
- Keep explanations, change history, and rollback instructions outside the file.
- Do not treat the absence of a property as proof that the server ignored it; the software may have regenerated it with a default.
Java and Bedrock are different configuration targets
| Question | Java Edition server | Bedrock Dedicated Server |
|---|---|---|
| Can you copy keys between files? | Use the Java key set supplied for the Java server release. | Use the Bedrock key set supplied with the Bedrock server release. |
| What happens to an incompatible Java key pasted into Bedrock? | Not applicable. | A GameServerKings guide says it is read but silently ignored, without an error or warning. |
| Where is a useful reference? | The Java server’s generated file and Java-specific documentation. | The Bedrock Dedicated Server download includes a heavily commented server.properties that can be kept open as a reference. |
Before troubleshooting a setting that appears ineffective, verify the edition. A syntactically perfect line can still do nothing when it belongs to the other edition’s property set. Silent ignoring makes copy-pasting between Java and Bedrock a particularly common failure.
Best Value
- Play and share with friends on console, mobile and Windows 10
- discover community creations in the new in-game store
- access new mini games and game modes through servers
Troubleshoot an edit that did not work
The server starts, but behavior is unchanged
- Confirm that you edited the file in the server’s current working directory.
- Check that the line is active and does not begin with
#. - Check the key character by character and make sure the value is after the equals sign.
- Perform a clean restart. A reload may not apply every property.
- Reopen the file after startup. If the server rewrote the line, investigate whether the value was invalid or unsupported for that release.
- Verify that the file belongs to the correct edition, especially if it came from a shared hosting panel or a copied server folder.
The setting reverted or a comment vanished
The server may have regenerated missing or invalid values and rewritten the file. Restore the backup, correct the key or value, and test again. Store explanatory notes outside server.properties because comments are not guaranteed to survive startup.
Free tools Windows power users keep installed
One-click scans. No signup required.
The file looks unchanged even after saving
Check for a hidden extension such as server.properties.txt, a read-only copy, or an editor that saved in rich text. Compare the full filename and location with the command that launches the server. A second file with the same visible name is often the one being edited by mistake.
Players still cannot join after a whitelist edit
Confirm that white-list=true is active, then use /reload or restart the server. The documented whitelist behavior requires the modified list to be loaded; players not present on the existing whitelist remain blocked. If players already online are affected by the reload, consult the release-specific meaning of enforce-whitelist rather than assuming it behaves identically across versions.
A Bedrock server ignores the line without an error
Remove the Java-only key and consult the commented Bedrock configuration file shipped with the Bedrock Dedicated Server. Silent ignoring is expected for incompatible keys according to the cited third-party guide, so the lack of a warning does not validate the setting.
A repeatable editing workflow
- Identify the process. Determine which server command, service, panel, or script starts the instance.
- Identify its working directory. Use that directory as the authoritative location for
server.properties. - Stop cleanly. Avoid competing writes while you edit.
- Back up the file. Give the copy a date or purpose so it cannot be confused with the active file.
- Open as plain text. Keep the original encoding and line-oriented format.
- Change only the needed value. Preserve the exact key and leave unrelated properties untouched.
- Save and verify the filename. Ensure the editor did not append an extension or save in another folder.
- Apply the change. Restart for the broadest reliability; use
/reloadonly where its scope is appropriate. - Check the resulting file. Look for regenerated defaults, invalid-value replacements, or removed comments.
- Record the final value externally. This gives you a durable change history even if startup rewrites the file.
Decision checklist before you change a property
- Edition: Is this Java or Bedrock?
- Location: Is this the working directory used by the running server?
- Syntax: Is the line exactly
key=valuewith no comment marker before it? - Value: Does the value use the spelling and form expected by this server release?
- Application: Will you restart, or is
/reloadexplicitly suitable? - Persistence: Have you saved a backup and put notes somewhere the server cannot erase?
Following these checks prevents the three failures that look most alike to an administrator: editing the wrong file, using the wrong edition’s key, and changing a value without reloading the configuration.
Do these 3 things before closing this tab:
1Scan for outdated or missing drivers - takes under a minute2Clear out junk files and repair common Windows errors3Fix the driver behind crashes, sound loss and screen glitchesQuick Recap
Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.
