Hardware FixRecommendedDevice not working? Your driver may be the problemCheck updates for common hardware issues.Fix DriversHalloween DealsAmazon USHalloween week deals: useful picks before month-endAmazon US: current deals, useful picks and tech finds.Check DealsWindows FixRecommendedWindows errors stealing your time? Find the fix fastScan stability, cleanup and performance issues.Fix Now×
FREEDOM251

Freedom251 › Blog › Bedrock Dedicated Server

How to Edit server.properties on a Minecraft Server (Java and Bedrock)

By Freedom251 Team · · 9 min read

Free tools Windows power users keep installed

One-click scans. No signup required.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

To edit a Minecraft server’s settings, stop the server, open server.properties from the server’s working directory in a plain-text editor, change only the value after the correct = sign, save the file, and restart the server. Java and Bedrock use different property sets, and a Java setting can be silently ignored by Bedrock.

What server.properties is and where to find it

server.properties is the text configuration file read by Minecraft server software. Each active setting uses one line in the form key=value. For example, the whitelist setting is written as white-list=true. The text before the equals sign is the key; the text after it is the value.

As an Amazon Associate I earn from qualifying purchases.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

The file is created in the server software’s current working directory. In a normal installation, that is the folder containing the server files. However, the folder from which the server process is launched matters more than the location of the server JAR itself. If a startup script changes directory first, or if a hosting panel launches the process from another directory, server.properties is created or read there instead.

If you see more than one copy, identify the copy used by the running process rather than editing the one that merely looks familiar. A reliable check is to stop the server, note the directory containing the files it uses, and start it from that same directory. Hosting panels may expose this as the server’s working directory or installation path.

#1 Best Overall
Minecraft | Java & Bedrock Deluxe Collection | Windows Digital Code
  • 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).

Identify the edition before changing anything

Java Edition and Bedrock Dedicated Server do not share the same configuration keys. A property copied from a Java file into a Bedrock file may be read and silently ignored, according to a GameServerKings reference, without an error or warning. That makes choosing the correct file more important than the edit itself.

Signs that you are editing a Java server

  • The server is launched with a Java command such as java -jar minecraft_server.jar.
  • The directory contains a Java server JAR and files such as eula.txt and server.properties.
  • The file’s keys match the Java Edition documentation on the community-maintained Minecraft Wiki.

Signs that you are editing Bedrock Dedicated Server

  • The server is the separately distributed Bedrock Dedicated Server software rather than a Java JAR.
  • The supplied server.properties is heavily commented and uses Bedrock-specific keys.
  • Java property names pasted into it do not produce the expected behavior, even though the file saves normally.

Do not “translate” a Java key by changing punctuation or capitalization. Use the key set generated for your edition. The Bedrock file’s comments are useful as a reference, so keep an untouched copy before making changes.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Prepare the server and editor

Stop the server first

Stopping the server before editing is the safest procedure. A running server can still write configuration data, and a clean shutdown gives it a chance to finish its own file operations. If your panel has a Stop button, use it and wait until the console reports that the process has ended. From a terminal, use the server’s normal shutdown command or close the process only after it has stopped cleanly.

If you cannot stop the server immediately, make a backup copy and schedule the edit for the next restart. Editing while the process is active can leave you unsure whether the final file contains your changes or a later write from the server.

Rank #2
Minecraft | Java & Bedrock Ultimate Collection | Windows Digital Code
  • 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).

Use a plain-text editor

Open the file with an editor that saves unformatted text. Notepad on Windows, TextEdit in plain-text mode on macOS, Kate on Linux, and terminal editors such as nano or vim are suitable. Avoid word processors and rich-text modes: they can add formatting characters that the server does not understand.

Before editing, copy server.properties to a backup with a date in its name. A backup lets you restore the previous configuration if the server refuses a value or if you lose track of several changes.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Step-by-step: edit a property safely

  1. Open the server’s active directory. Use the directory from which the server software runs, not an unrelated download or backup folder.
  2. Stop the server. Confirm that the process has ended before opening the file for editing.
  3. Make a backup. Duplicate server.properties before changing it.
  4. Open the file as plain text. Keep the existing line endings and ordinary text encoding if the editor asks.
  5. Find the exact key. Use the editor’s search function. Keys are spelling- and punctuation-sensitive; do not rename them.
  6. Change only the value. Leave the key and equals sign intact. For a Boolean setting, use the form expected by the file, such as true or false. For a numeric or text value, enter only the value, without explanatory words.
  7. Leave comments alone. A line beginning with # is a comment and does not affect the game. You can read it for context, but changing a comment does not change a setting.
  8. Save the file. Check that the editor did not append a second extension such as .txt or convert the file to a rich-text format.
  9. Start the server again. A restart is the dependable way to make configuration changes active.
  10. Verify in the console or in game. Test the particular behavior you changed instead of assuming that a successful save means the value was accepted.

Do not add spaces, quotes, or a second equals sign unless the existing property format specifically calls for them. The safest edit is a replacement of the value on an existing line.

Restart versus /reload

The Minecraft Wiki states that restarting the server applies changes made to server.properties. It also documents /reload, issued from the console or in game, as a way to reload changes without a full process restart. The exact scope of /reload is not fully established for every property, so use a complete restart when a setting does not respond or when you need predictable behavior.

Rank #3
Minecraft | Standard Edition | XBOX Digital Code
  • 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.
Method How to use it When it is appropriate Limitation
Full restart Stop the server, then start it again Applying all edited properties; troubleshooting a change that did not take effect Players lose access while the process is stopped
/reload Run /reload in the console or in game Quickly loading supported changes without restarting The retrieved documentation does not establish that every property is reloaded

For whitelist edits, NamuWiki reports that the modified list is loaded after /reload; until then, the server continues using the existing whitelist. If the result is not what you expect, stop the server and restart it rather than repeatedly issuing reload commands.

If the file does not exist: initialize default settings

The Minecraft Wiki’s server tutorial documents an initialization option that creates the initial settings files without running the server. If server.properties or eula.txt is missing, run the server JAR with --initSettings from the directory where you want those files created:

What’s actually slowing this PC down?

Pick the symptom - the matching free tool is one click away.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
java -jar minecraft_server.jar --initSettings

The filename in the command must match your server JAR. Running the command from the wrong directory creates the files there, so change to the intended server folder first. The option writes default files; it does not apply a custom configuration for you. After initialization, open the generated server.properties, make the required edits, and start the server normally.

If a hosting panel manages the server, use its file manager or documented startup option instead of adding command-line arguments blindly. The panel may already provide an initialization action and a fixed working directory.

Rank #4
Minecraft
  • 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

Worked example: enable the Java whitelist

The Java whitelist is controlled by the white-list property. A value of true enables it:

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
white-list=true
  1. Stop the server and open the active Java server.properties.
  2. Find the line beginning with white-list=. Keep the key exactly as written.
  3. Replace only the value with true, then save.
  4. Run /reload if you need to load the changed list without a full restart, or restart the server for the most reliable result.
  5. Confirm that the intended players are on the server’s whitelist using the server’s normal whitelist-management commands, then test a connection.

GameServerKings reports that the default for white-list changed from false to true in version 26.3. That is a version-sensitive, third-party claim rather than a universal rule for every release. Inspect the generated file on your version instead of assuming a default.

Players already online

The same third-party guide describes enforce-whitelist as controlling what happens to players who are already online when the whitelist is reloaded. Because behavior can depend on the server version and reload method, treat that key as a separate decision: changing white-list determines whether the whitelist is enabled, while enforce-whitelist determines the handling of players present during a reload according to that guide.

If a player can still join after an edit, check three things in order: that you changed the active file, that the value is exactly true, and that the server was restarted or reloaded after saving. Then verify that you are testing the Java server whose file you edited, not a Bedrock instance or a second installation.

Best Value
Minecraft - Bedrock Edition PS4
  • 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
Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

Java and Bedrock properties are not interchangeable

Question Java Edition server Bedrock Dedicated Server
Configuration file server.properties generated and read by the Java server software A separate server.properties with a different key set
Can Java keys be pasted into it? Use the Java keys documented for that server GameServerKings says Java keys may be read but silently ignored, with no warning
Reference material The Java-oriented Minecraft Wiki documentation The heavily commented file included with the Bedrock Dedicated Server download
Best verification Restart or reload, then test the Java behavior you changed Use the Bedrock key and test in the Bedrock server process

There is no safe copy-and-paste conversion between editions. Even when a key looks familiar, its spelling, available values, or effect may differ. Keep separate backups and notes for each server.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Why the server may rewrite your file

On startup, the server 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. Rewriting can remove comments you added yourself. Treat comments as temporary documentation, not as permanent storage for operating notes.

Keep custom notes in a separate text file or in your administration documentation. After every restart, reopen server.properties if you need to confirm that the server retained a value. If the line has been restored to a default, compare the value with the format expected by your edition and restore from the backup only after correcting the input.

Troubleshooting by symptom

The edit has no effect

  • Confirm that the file is in the server’s working directory. A second copy elsewhere is a common source of confusion.
  • Check that the key text was not changed and that the value appears after the first equals sign.
  • Restart the server. Use /reload only when the property’s reload behavior is known to be adequate.
  • Make sure the server process you restarted is the same edition and installation whose file you edited.

The file changed back after startup

  • Look for a missing or invalid value that the server replaced with a default.
  • Check the spelling and capitalization of the key, then compare the value with the format already used in the generated file.
  • Use the backup to identify what changed, but do not restore a Java property file over a Bedrock installation or the reverse.

Your comments disappeared

The server’s rewrite behavior can strip comments when it regenerates the file. Store explanations outside server.properties and regard the generated file as machine-maintained configuration.

Whitelist behavior is unexpected

  • Verify white-list=true in the active Java file.
  • Reload or restart after saving; an unsaved edit is not visible to the running process.
  • Check whether the test player was already online and whether your version uses enforce-whitelist for reload handling.
  • Do not apply Java whitelist keys to a Bedrock file.

The file is missing

Run the initialization command from the intended working directory, or start the server normally once so it can create its defaults. If a panel controls the process, use the panel’s file manager and startup settings to identify where it writes configuration.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

A repeatable maintenance routine

  • Record the edition, server version, and working directory before changing settings.
  • Stop the process and make a dated backup of server.properties.
  • Edit one logical group of settings at a time so a later problem has a clear cause.
  • Preserve every key exactly and alter only its value.
  • Save as plain text, restart, and test the behavior that motivated the change.
  • Keep operational notes outside the file because startup rewrites can remove comments.
  • When a value is ignored, check edition and file location before experimenting with different syntax.

Following this routine avoids the two most damaging mistakes: editing a file that the server never reads and using a valid-looking key from the other Minecraft edition.

Quick Recap

Bestseller No. 4
Minecraft
Minecraft
Skins! We have biome settlers, city folk, town folk, and more!; The Nether and all its inhabitants. Fight Ghasts and make friends with Pigmen
$6.99
Bestseller No. 5
Minecraft - Bedrock Edition PS4
Minecraft - Bedrock Edition PS4
Play and share with friends on console, mobile and Windows 10; discover community creations in the new in-game store
$42.98

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.

Bedrock Dedicated ServerJava EditionMinecraftserver administrationserver.propertieswhitelist

Leave a Reply

Your email address will not be published. Required fields are marked *

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Recommended PC Tool
Recommended PC Tool
Crashes, No Sound, or Screen Glitches?Free driver scan
PC Slower Than It Used to Be?Free scan - under a minute

Two free Windows tools

One Free Minute Could Fix That PC

Before you go - each of these free tools takes about a minute and tackles what quietly slows a Windows PC down.

Special offer. View Outbyte info, uninstall instructions, EULA, and Privacy Policy.