What’s actually slowing this PC down?
Pick the symptom - the matching free tool is one click away.
iTechGuides is reader-supported. When you buy through links on our site, we may earn an affiliate commission. As an Amazon Associate I earn from qualifying purchases. Learn more
Playing with friends? Godlike.Host runs hosted Minecraft Java servers from 10 data-center locations, with free DDoS protection.
To edit a Minecraft server’s settings, stop the server when possible, open the server.properties file in its working directory, change only the value after the correct = sign, save the plain-text file, and restart the server. The console or in-game /reload command can load some edits faster, but a restart is the dependable way to apply the complete file.
This guide covers Java Edition’s file format, locating the file when a host uses a separate startup directory, creating missing settings, whitelist changes, rewrite behavior, and the Java–Bedrock differences that cause many silent failures.
What server.properties is
server.properties is a plain-text configuration file read by Minecraft Java Edition server software. Each active line contains one property name, an equals sign, and its value:
key=valueThe property name (the text before =) must match exactly. You normally edit only the value on the right. Lines beginning with # are comments; they are documentation for humans and do not change gameplay.
#1 Best Overall
The file belongs to the server process’s current working directory, not necessarily the directory where you downloaded the server jar. If a startup script, control panel, service definition, or hosting panel launches the server from another directory, that launch directory is where server.properties is created and read.
Prepare before making a change
- Identify the edition. This procedure is for Java Edition. Bedrock Dedicated Server uses a different key set, so a Java property may be ignored there.
- Know how the server is launched. Check the startup script or panel for its working directory. Editing a similarly named file in a download folder will have no effect if the process starts elsewhere.
- Make a backup. Copy the existing file to a separate location before changing it. Keep your own change notes outside the file because the server can rewrite the file and remove comments.
- Plan for a restart window. A clean stop prevents the running server from writing old values back over your edits.
- Use a plain-text editor. Notepad, TextEdit in plain-text mode, Kate, nano, and Vim are suitable. Avoid word processors and editors that add rich-text formatting.
Find the correct file
When you start the jar manually
Look in the directory from which the server command is run. For example, if a terminal is opened in a folder and the server is launched there, that folder is the process’s working directory. A normal Java server installation will create or read server.properties beside the other server files in that working directory.
When a script or service starts the server
Open the startup script and look for a directory change such as cd, a service working-directory setting, or a panel field naming the server directory. The file is created relative to that location. If you find multiple copies, check the file’s modification time while starting the server and confirm which copy changes.
When the file does not exist
The server can initialise its settings without a normal game start. The Minecraft Wiki tutorial documents the --initSettings option for creating missing server.properties and eula.txt with defaults:
java -jar server.jar --initSettingsUse the actual filename of your server jar in place of server.jar. This command is useful when you want the files generated before configuring the server. It does not make Java and Bedrock property names interchangeable.
Edit the file safely, step by step
- Stop the server cleanly. Use the server console’s stop command or your hosting panel’s stop control. If you cannot stop it, take a backup and understand that the running process may later rewrite the file.
- Open the file as plain text. Do not open it in a spreadsheet or word processor. Preserve ordinary text encoding and line breaks.
- Locate the property. Use the editor’s Find function to search for the exact key. A line beginning with
#is commented out; changing text on that line will not enable the setting unless you remove the comment marker and retain valid syntax. - Change the value only. Keep the key and equals sign intact. For a Boolean setting, use the value expected by the property, such as
trueorfalse, rather than adding explanatory words. - Check for duplicate entries. Keep one active line for a key. Two lines with the same key can produce confusing results because the effective value depends on how the server parses the file.
- Save the file. Confirm that the editor did not append a document extension such as
.txt. The filename must remain exactlyserver.properties. - Start the server again. Watch the console for startup errors and verify the setting in game or through the server’s behavior.
A minimal valid edit looks like this:
# Enable the whitelist
white-list=trueThe comment is optional and has no effect. The active setting is the white-list=true line.
The Tool Desk
Outbyte Driver Updater FREEFix the driver behind crashes, sound loss and screen glitchesFind Drivers →Outbyte PC Repair FREERepair Windows errors before they cause bigger problemsFix Now →Understand the syntax before changing values
| Part of a line | What it does | Safe editing rule |
|---|---|---|
# comment |
Human-readable note; ignored by the server | Do not rely on a commented line as an active setting |
Key before = |
Identifies the property | Do not rename, re-capitalize, or translate it |
= |
Separates the key from its value | Keep the separator in place |
Value after = |
Supplies the setting | Edit this portion using the value format expected by that key |
Do not add quotation marks, commas, or spaces unless the property’s documented format calls for them. If you are unsure about a key’s allowed values, consult the documentation for the exact Java server version rather than guessing.
Restart or use /reload?
| Method | When to use it | What is established | Limitation |
|---|---|---|---|
| Full restart | Production changes, broad configuration edits, or any uncertain setting | The Minecraft Wiki identifies a restart as the reliable way for changes to take effect | Players disconnect and the server has downtime |
/reload |
Quickly loading supported changes from the console or in game | The wiki documents reloading changes without a full restart | The retrieved documentation does not establish that every property is applied by reload |
For a change that affects startup behavior, networking, world generation, or a setting that does not visibly update after reload, stop and start the server. Treat reload as a convenience, not a universal substitute for a restart.
Rank #3
- The classic UNO card game builds fun on game night with a Minecraft theme.
- UNO Minecraft features a deck and storage tin decorated with graphics from the popular video game.
- Players match colors and numbers to the card on top of the discard pile as in the classic game.
- The Creeper card unique to this deck forces other players to draw 3 cards.
- Makes a great gift for kid, teen, adult and family game nights with 2 to 10 players ages 7 years and older, especially Minecraft and video game fans.
Running the reload command
From the server console, enter:
reloadFrom in game, use:
/reloadYou need the permission required to run the command in game. Afterward, check the console and test the feature. If the old behavior remains, perform a full restart rather than repeatedly editing the same line.
Worked example: enable a whitelist
The whitelist is controlled by the white-list property. In the documented Java configuration, it is disabled with white-list=false and enabled with:
white-list=true- Stop the server and open the Java server’s
server.properties. - Find the active
white-listline. If it is absent, add a new line using the exact key spelling. - Set the value to
true, save, and either runreloador restart. - Verify the result by testing a player who is and is not on the existing whitelist, using the server’s normal whitelist-management commands as appropriate.
NamuWiki’s Java-server guidance notes that after a whitelist change, only players already on the existing whitelist can join until the modified list is reloaded. In practice, reload or restart the server after changing the property, then verify the membership list separately.
A third-party GameServerKings guide claims that the white-list default changed from false to true in version 26.3 and describes enforce-whitelist as controlling what happens to players who are already online when the whitelist is reloaded. These are version-sensitive, third-party claims; check the documentation for the release you are running before relying on them.
Rank #4
- Now Minecraft lovers can play a special version of UNO!
- Same as Basic UNO but features Minecraft characters and includes special Creeper rule card. Draw this card and the other players have to draw three more cards from the pile!
- The goal is to get rid of all the cards in your hand.
- First player or team to 500 wins.
- When you're down to one card, don't forget to yell "UNO"!
Why the server may change your file
On startup, server software can add missing properties with default values. A third-party reference also describes invalid or missing values being replaced and the file being rewritten. That rewrite can remove comments you added, so treat comments in server.properties as temporary annotations rather than durable documentation.
If a value keeps reverting:
- Stop the server before editing and start it once after saving.
- Check that you edited the file in the actual working directory.
- Confirm the key spelling and value format exactly.
- Look at the startup log for a message about an invalid value.
- Compare the rewritten line with your backup to see whether the server normalised it or restored a default.
- Keep the intended configuration in a separate note so a rewrite does not erase your record.
Java and Bedrock are not interchangeable
Java Edition and Bedrock Dedicated Server use different property names and, in some cases, different configuration models. A Bedrock Dedicated Server download includes a heavily commented server.properties file that is useful as a reference for Bedrock’s own keys.
Free tools Windows power users keep installed
One-click scans. No signup required.
According to a GameServerKings guide, Java keys pasted into a Bedrock file may be read and then silently ignored without an error or warning. This makes copying a line from a Java tutorial into Bedrock particularly risky: the file can look correct while the server behavior remains unchanged.
| Question | Java Edition | Bedrock Dedicated Server |
|---|---|---|
| Can you use this editing method? | Yes; edit the Java server’s plain-text server.properties |
Use the Bedrock file’s own documented keys and comments |
| Are the key names interchangeable? | No | No |
| What happens to an unsupported Java key in Bedrock? | Not applicable | A third-party guide reports silent ignoring, with no warning |
| Best reference in the installation | The Java file and version-specific Java documentation | The heavily commented Bedrock server.properties supplied with the download |
Before troubleshooting a setting that appears ineffective, confirm the server edition and use the property list for that edition.
Troubleshooting common failures
The edit has no effect
- You edited a different copy than the one the process reads. Recheck the working directory and startup script.
- You changed a commented line beginning with
#. - The server has not been restarted, and the setting is outside the subset handled by
/reload. - The key belongs to Java while the server is Bedrock, or vice versa.
- The server rewrote an invalid value back to a default.
The file opens as a formatted document
Close it without saving and reopen it with a plain-text editor. Rich-text formatting, hidden characters, and automatic quotation marks can make a valid-looking line unreadable to the server.
The file keeps losing comments
This is consistent with the server rewriting settings on startup. Store explanations and change history in a separate text file, version-control repository, or administration notes instead of relying on inline comments.
The server will not start after editing
- Stop the process and restore the backup.
- Start the server to confirm that the backup works.
- Reapply one change at a time, saving a copy after each successful start.
- Inspect the console output for the property that was rejected or normalised.
Players report that whitelist changes are inconsistent
Check both pieces of the configuration: the white-list Boolean in server.properties and the actual whitelist membership. Reload or restart after editing, then test with a player who is intentionally on the list and one who is intentionally absent. Do not infer that a successful file edit changed membership automatically.
A repeatable maintenance workflow
- Record the server edition, software version, and the reason for the change.
- Locate the active working directory from the launch method.
- Stop the server and copy
server.propertiesto a dated backup. - Open the file in a plain-text editor and search for the exact key.
- Edit only the value, leaving comments and key spelling intact.
- Save under the exact filename with no extra extension.
- Start the server, or use
/reloadonly when a quick reload is appropriate. - Check the console and test the affected behavior.
- After startup, inspect the file to see whether the server normalised or regenerated any lines.
- Keep the final known-good copy and your notes outside the generated file.
This process separates file-editing mistakes from edition mismatches and from settings that require a complete restart, making future changes easier to diagnose.
Quick 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.
