Every server.properties setting in Java 26.3
server.properties holds a Java Edition server's settings. It sits in the server folder next to the server .jar, and the server writes it the first time it starts, with every setting at its default. Each default below is what the 26.3 server itself wrote to a new file.
The server reads the file only when it starts: stop it, change a value, then start it again. To make a file without editing it by hand, or to see the defaults of another version, use the Server.properties Generator.
Server basics
Who can join, how many, and the default game mode and difficulty.
| Setting | Default | What it does |
|---|---|---|
| motd | A Minecraft Server | The text under the server name in the multiplayer list. Use the MOTD Generator for colors and two lines. Open the MOTD Generator. |
| max-players | 20 | How many players can be online at once. Operators cannot join a full server either, unless ops.json lets them bypass the limit. |
| online-mode | true | Checks every player against Mojang's account servers. Turn it off only behind a proxy that checks accounts itself: without it anyone can join under any name. |
| white-list | true | Only players in whitelist.json can join. Operators can always join. |
| enforce-whitelist | false | Kicks online players who are not in whitelist.json, operators included, when the whitelist is turned on, reloaded or someone is removed from it. From 1.21.9 it does nothing while the whitelist is off; before 1.21.9 it kicks even then. |
| difficulty | easy | The world's difficulty. Old number values (0 to 3) are still read and turned into these names. |
| gamemode | survival | The game mode new players start in. |
| force-gamemode | false | Puts players back in the default game mode every time they join, instead of the mode they left in. |
| hardcore | false | Locks the difficulty to Hard, and players who die become spectators. |
World
Used when the world is first created. Changing them later does not regenerate existing chunks.
| Setting | Default | What it does |
|---|---|---|
| level-name | world | The world folder the server loads, or creates if it is missing. |
| level-seed | (empty) | The seed for a new world. Leave it empty for a random one. |
| level-type | minecraft:normal | The world preset for a new world. |
| generator-settings | {} | JSON settings for a Superflat world (its layers, biome and structures). Every other world type ignores it. |
| generate-structures | true | Villages, temples and other structures in new chunks. Dungeons still generate when it is off. |
| max-world-size | 29999984 | The largest radius, in blocks, the world border can be set to. |
| spawn-protection | 16 | Non-operators cannot build within this many blocks of the Overworld spawn (a square 2 × this + 1 wide). Operators ignore it, and it only applies while the server has at least one operator. The Nether and the End are never protected. 0 turns it off. |
Players and chat
Permissions, idle kicks, chat signing and what the server announces.
| Setting | Default | What it does |
|---|---|---|
| allow-flight | false | Stops the server kicking Survival players who hover for over 4 seconds (80 ticks). Turn it on if players use flight mods or plugins. Creative flying is never affected. |
| op-permission-level | 4 | What /op gives: 1 bypasses spawn protection, 2 adds cheat commands and command blocks, 3 adds player management (kick, ban, op), 4 adds server management (stop, save). |
| function-permission-level | 2 | The permission level functions in data packs run with. |
| player-idle-timeout | 0 | Kicks players who have not moved for this many minutes. 0 never kicks. |
| enforce-secure-profile | true | Players need a Mojang-signed chat key to join. Turn it off only if players without one (some launchers) cannot get in. Added in 1.19. |
| hide-online-players | false | Leaves the player list out of the server list status, so nobody can see who is online. Added in 1.18. |
| prevent-proxy-connections | false | Kicks players whose connection comes from a different network than the one Mojang's login saw (a VPN or proxy). |
| log-ips | true | Writes players' IP addresses to the log when they join. Added in 1.20.2. |
| broadcast-console-to-ops | true | Online operators see the output of commands typed in the console. |
| broadcast-rcon-to-ops | true | Online operators see the output of commands sent over RCON. |
| text-filtering-config | (empty) | Settings for an external chat filter service. Used by Mojang's Realms; leave empty. Added in 1.16.4. |
| text-filtering-version | 0 | Which version of the external chat filter service the server talks to. Only matters with a text filtering config; leave it at 0. Added in 1.21.2. |
| accepts-transfers | false | Lets another server send players here with /transfer. Added in 1.20.5. |
| bug-report-link | (empty) | A web page where players can report bugs on your server. The server sends it to players, who can open it from the game. Added in 1.21. |
| enable-code-of-conduct | false | Shows players a code of conduct to accept when they join, from text files in a codeofconduct folder beside server.properties, named by language (en_us.txt). The server will not start with it on and no codeofconduct folder. Added in 1.21.9. |
| chat-spam-threshold-seconds | 10 | How quickly a player may keep sending chat messages before being kicked for spam. Higher is more lenient. 0 turns the chat spam kick off. Operators are never kicked for spam. Added in 26.2. |
| command-spam-threshold-seconds | 10 | The same for commands players type. 0 turns the command spam kick off. Operators are never kicked for spam. Added in 26.2. |
Performance
How far the server loads and simulates, and how it saves and sends data.
| Setting | Default | What it does |
|---|---|---|
| view-distance | 10 | How many chunks around each player the server sends, as a radius. The server keeps it between 2 and 32. Lower is lighter on the server. |
| simulation-distance | 10 | How many chunks around each player keep ticking: mobs move, crops grow, redstone runs. Lower is lighter on the server. Added in 1.18. |
| entity-broadcast-range-percentage | 100 | How far away entities are sent to players, as a percentage of the normal distance. Higher shows mobs from further off but costs more. |
| max-tick-time | 60000 | If one tick takes longer than this, the server decides it has frozen and stops. 0 or -1 turns the watchdog off. |
| network-compression-threshold | 256 | Packets this many bytes or larger are compressed. -1 turns compression off, 0 compresses everything. |
| rate-limit | 0 | Kicks a player who sends more packets than this per second. 0 turns the limit off. Added in 1.16.2. |
| sync-chunk-writes | true | Waits for each chunk to be written to disk. Safer if the server crashes; turning it off can speed up saving. |
| use-native-transport | true | Uses the faster native network code: epoll on Linux, and from 1.21.11 kqueue on macOS. Other systems ignore it. |
| max-chained-neighbor-updates | 1000000 | Limits how many block updates can chain in a row before the rest are skipped. A negative number removes the limit; 0 stops chained updates, so redstone stops working. Added in 1.19. |
| enable-jmx-monitoring | false | Publishes tick times for Java monitoring tools (JMX). Also needs JVM flags. |
| region-file-compression | deflate | How newly saved chunks are compressed. Changing it does not recompress chunks already saved. Added in 1.20.5. |
| pause-when-empty-seconds | 60 | Pauses the world once nobody has been online for this many seconds, so an empty server uses almost no CPU. 0 or less never pauses. Added in 1.21.2. |
Resource pack and data packs
A pack players download on join, and the data packs a new world starts with.
| Setting | Default | What it does |
|---|---|---|
| initial-enabled-packs | vanilla | Data packs a NEW world starts with, comma separated. Experimental feature packs must be listed here to be on. Added in 1.19.3. |
| initial-disabled-packs | (empty) | Data packs a NEW world does not turn on automatically, comma separated. Added in 1.19.3. |
| resource-pack | (empty) | A direct download link to a .zip players are offered on join. |
| resource-pack-sha1 | (empty) | The SHA-1 hash of the .zip, as 40 hex characters. Lets players reuse a cached copy and catches a wrong download. |
| require-resource-pack | false | Players who decline the pack are disconnected. Added in 1.17. |
| resource-pack-prompt | (empty) | A custom message on the download prompt, as a JSON text component. Added in 1.17. |
| resource-pack-id | (empty) | A UUID that names the pack, so players keep one cached copy across URL changes. Left empty, it is made from the URL. A value that is not a UUID means no pack is sent at all. Added in 1.20.3. |
Network and remote access
Ports, RCON, query and status replies.
| Setting | Default | What it does |
|---|---|---|
| server-port | 25565 | The port players connect to. Forward it on your router if you host from home. |
| server-ip | (empty) | Listen on one IP address only. Leave it empty unless you know you need it. |
| enable-status | true | When off, the server shows as offline in the multiplayer list but players can still join. |
| enable-query | false | Answers GameSpy4 query requests (player lists for server sites and bots). |
| query.port | 25565 | The UDP port for query. |
| enable-rcon | false | Remote console: run commands from another program. It is not encrypted, so never open its port to the internet. |
| rcon.port | 25575 | The TCP port for RCON. |
| rcon.password | (empty) | RCON does not start without one. |
Management server
The server management protocol for remote tools. Off by default.
| Setting | Default | What it does |
|---|---|---|
| status-heartbeat-interval | 0 | How often, in seconds, the management server sends connected tools a status notification. 0 sends none. Added in 1.21.9. |
| management-server-enabled | false | Starts the server management protocol (JSON-RPC over WebSocket) for remote admin tools. Added in 1.21.9. |
| management-server-host | localhost | The address it listens on. Keep localhost unless a tool on another machine needs it. Added in 1.21.9. |
| management-server-port | 0 | Its port. 0 picks a free port each time the server starts. Added in 1.21.9. |
| management-server-secret | random | The token tools sign in with: exactly 40 letters and digits. Left out, the server makes a random one and writes it to the file. Any other value stops the server starting while the management server is on. Added in 1.21.9. |
| management-server-tls-enabled | true | Encrypts the connection. The server will not start with TLS on and no keystore. Added in 1.21.9. |
| management-server-tls-keystore | (empty) | Path to a PKCS12 keystore with the TLS certificate. Added in 1.21.9. |
| management-server-tls-keystore-password | (empty) | The keystore's password. The environment variable MINECRAFT_MANAGEMENT_TLS_KEYSTORE_PASSWORD wins over this if set. Added in 1.21.9. |
| management-server-allowed-origins | (empty) | Web pages allowed to sign in from a browser, comma separated. Empty blocks browser sign-in. Added in 1.21.11. |
Settings that were removed
Older files still have these. The 26.3 server ignores them; the ones that became game rules are set with /gamerule while the server runs.
| Setting | Removed in | On 26.3 |
|---|---|---|
| allow-nether | 1.21.9 | Now a game rule. Use /gamerule allow_entering_nether_using_portals. |
| enable-command-block | 1.21.9 | Now a game rule, and command blocks work by default. Use /gamerule command_blocks_work. |
| pvp | 1.21.9 | Now a game rule. Use /gamerule pvp. |
| spawn-monsters | 1.21.9 | Now a game rule. Use /gamerule spawn_monsters. |
| spawn-animals | 1.21.2 | Removed with no replacement. |
| spawn-npcs | 1.21.2 | Removed with no replacement. |
| previews-chat | 1.19.3 | Removed. |
| snooper-enabled | 1.18 | Removed in 1.18 (it sent usage data to Mojang). |
| max-build-height | 1.17 | Removed in 1.17. |
What changed in each version
Every version from 1.16 on that added or removed a setting, or changed a default, newest first. Versions not listed write the same file as the one before them.
26.4 (snapshot, read from 26.4-snapshot-8: may still change before release)
allowed-connection-idsadded (empty by default).enable-legacy-statusadded (defaulttrue).status-contact-detailsadded (empty by default).
26.3
- Default of white-list changed from
falsetotrue.
- Default of white-list changed from
26.2
- chat-spam-threshold-seconds added (default
10). - command-spam-threshold-seconds added (default
10).
- chat-spam-threshold-seconds added (default
1.21.11
- management-server-allowed-origins added (empty by default).
1.21.9
- enable-code-of-conduct added (default
false). - management-server-enabled added (default
false). - management-server-host added (default
localhost). - management-server-port added (default
0). - management-server-secret added (a random value by default).
- management-server-tls-enabled added (default
true). - management-server-tls-keystore added (empty by default).
- management-server-tls-keystore-password added (empty by default).
- status-heartbeat-interval added (default
0). allow-netherremoved: it became the game ruleallowEnteringNetherUsingPortals.enable-command-blockremoved: it became the game rulecommandBlocksEnabled.pvpremoved: it became the game rulepvp.spawn-monstersremoved: it became the game rulespawnMonsters.
- enable-code-of-conduct added (default
1.21.2
- pause-when-empty-seconds added (default
60). - text-filtering-version added (default
0). spawn-animalsremoved.spawn-npcsremoved.
- pause-when-empty-seconds added (default
1.21
- bug-report-link added (empty by default).
1.20.5
- accepts-transfers added (default
false). - region-file-compression added (default
deflate).
- accepts-transfers added (default
1.20.3
- resource-pack-id added (empty by default).
1.20.2
- log-ips added (default
true).
- log-ips added (default
1.19.3
- initial-disabled-packs added (empty by default).
- initial-enabled-packs added (default
vanilla). previews-chatremoved.
1.19.1
- Default of enforce-secure-profile changed from
falsetotrue.
- Default of enforce-secure-profile changed from
1.19
- enforce-secure-profile added (default
false). - max-chained-neighbor-updates added (default
1000000). previews-chatadded (defaultfalse).- Default of level-type changed from
defaulttominecraft:normal.
- enforce-secure-profile added (default
1.18.2
- Default of generator-settings changed from
(empty)to{}.
- Default of generator-settings changed from
1.18
- hide-online-players added (default
false). - simulation-distance added (default
10). snooper-enabledremoved.
- hide-online-players added (default
1.17
- require-resource-pack added (default
false). - resource-pack-prompt added (empty by default).
max-build-heightremoved.
- require-resource-pack added (default
1.16.4
- text-filtering-config added (empty by default).
1.16.2
- rate-limit added (default
0).
- rate-limit added (default
Questions
How do I change a server.properties setting?
Stop the server, open server.properties (in the server folder, next to the server .jar) in a text editor, change the value after the = sign, save the file and start the server again. The server reads the file only when it starts, so a change made while it runs does nothing until a restart.
Which server.properties settings became game rules?
In 1.21.9, allow-nether, enable-command-block, pvp and spawn-monsters were removed from server.properties and became game rules, which are changed in the world while the server runs. On 26.3 use /gamerule allow_entering_nether_using_portals, /gamerule command_blocks_work, /gamerule pvp and /gamerule spawn_monsters.
What changed in server.properties in 26.3?
In 26.3, the default of white-list changed from false to true. A new default only applies to a setting your file does not have yet: a setting already in your file keeps its value.
Where do these defaults come from?
From the servers themselves. Each version's own server jar, from 1.17 to 26.3, was started to write a fresh server.properties, and that file was read. So each default here is the value that version really writes, not one copied from a wiki or an older version.
Is a Bedrock server's server.properties the same?
No. Bedrock Dedicated Server also has a file called server.properties, but its settings are different (server-name, allow-cheats, tick-distance and server-port 19132, for example). This page lists the Java Edition settings.