Skip to content
Java Edition

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.

SettingDefaultWhat it does
motdA Minecraft ServerThe text under the server name in the multiplayer list. Use the MOTD Generator for colors and two lines. Open the MOTD Generator.
max-players20How many players can be online at once. Operators cannot join a full server either, unless ops.json lets them bypass the limit.
online-modetrueChecks 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-listtrueOnly players in whitelist.json can join. Operators can always join.
enforce-whitelistfalseKicks 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.
difficultyeasyThe world's difficulty. Old number values (0 to 3) are still read and turned into these names.
gamemodesurvivalThe game mode new players start in.
force-gamemodefalsePuts players back in the default game mode every time they join, instead of the mode they left in.
hardcorefalseLocks 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.

SettingDefaultWhat it does
level-nameworldThe 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-typeminecraft:normalThe 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-structurestrueVillages, temples and other structures in new chunks. Dungeons still generate when it is off.
max-world-size29999984The largest radius, in blocks, the world border can be set to.
spawn-protection16Non-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.

SettingDefaultWhat it does
allow-flightfalseStops 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-level4What /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-level2The permission level functions in data packs run with.
player-idle-timeout0Kicks players who have not moved for this many minutes. 0 never kicks.
enforce-secure-profiletruePlayers 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-playersfalseLeaves the player list out of the server list status, so nobody can see who is online. Added in 1.18.
prevent-proxy-connectionsfalseKicks players whose connection comes from a different network than the one Mojang's login saw (a VPN or proxy).
log-ipstrueWrites players' IP addresses to the log when they join. Added in 1.20.2.
broadcast-console-to-opstrueOnline operators see the output of commands typed in the console.
broadcast-rcon-to-opstrueOnline 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-version0Which 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-transfersfalseLets another server send players here with /transfer. Added in 1.20.5.
enable-code-of-conductfalseShows 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-seconds10How 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-seconds10The 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.

SettingDefaultWhat it does
view-distance10How 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-distance10How 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-percentage100How 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-time60000If one tick takes longer than this, the server decides it has frozen and stops. 0 or -1 turns the watchdog off.
network-compression-threshold256Packets this many bytes or larger are compressed. -1 turns compression off, 0 compresses everything.
rate-limit0Kicks a player who sends more packets than this per second. 0 turns the limit off. Added in 1.16.2.
sync-chunk-writestrueWaits for each chunk to be written to disk. Safer if the server crashes; turning it off can speed up saving.
use-native-transporttrueUses the faster native network code: epoll on Linux, and from 1.21.11 kqueue on macOS. Other systems ignore it.
max-chained-neighbor-updates1000000Limits 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-monitoringfalsePublishes tick times for Java monitoring tools (JMX). Also needs JVM flags.
region-file-compressiondeflateHow newly saved chunks are compressed. Changing it does not recompress chunks already saved. Added in 1.20.5.
pause-when-empty-seconds60Pauses 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.

SettingDefaultWhat it does
initial-enabled-packsvanillaData 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-packfalsePlayers 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.

SettingDefaultWhat it does
server-port25565The 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-statustrueWhen off, the server shows as offline in the multiplayer list but players can still join.
enable-queryfalseAnswers GameSpy4 query requests (player lists for server sites and bots).
query.port25565The UDP port for query.
enable-rconfalseRemote console: run commands from another program. It is not encrypted, so never open its port to the internet.
rcon.port25575The 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.

SettingDefaultWhat it does
status-heartbeat-interval0How often, in seconds, the management server sends connected tools a status notification. 0 sends none. Added in 1.21.9.
management-server-enabledfalseStarts the server management protocol (JSON-RPC over WebSocket) for remote admin tools. Added in 1.21.9.
management-server-hostlocalhostThe address it listens on. Keep localhost unless a tool on another machine needs it. Added in 1.21.9.
management-server-port0Its port. 0 picks a free port each time the server starts. Added in 1.21.9.
management-server-secretrandomThe 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-enabledtrueEncrypts 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.

SettingRemoved inOn 26.3
allow-nether1.21.9Now a game rule. Use /gamerule allow_entering_nether_using_portals.
enable-command-block1.21.9Now a game rule, and command blocks work by default. Use /gamerule command_blocks_work.
pvp1.21.9Now a game rule. Use /gamerule pvp.
spawn-monsters1.21.9Now a game rule. Use /gamerule spawn_monsters.
spawn-animals1.21.2Removed with no replacement.
spawn-npcs1.21.2Removed with no replacement.
previews-chat1.19.3Removed.
snooper-enabled1.18Removed in 1.18 (it sent usage data to Mojang).
max-build-height1.17Removed 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.

  1. 26.4 (snapshot, read from 26.4-snapshot-8: may still change before release)

    • allowed-connection-ids added (empty by default).
    • enable-legacy-status added (default true).
    • status-contact-details added (empty by default).
  2. 26.3

  3. 26.2

  4. 1.21.11

  5. 1.21.9

  6. 1.21.2

  7. 1.21

  8. 1.20.5

  9. 1.20.3

  10. 1.20.2

  11. 1.19.3

  12. 1.19.1

  13. 1.19

  14. 1.18.2

  15. 1.18

  16. 1.17

  17. 1.16.4

  18. 1.16.2

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.

Make your server.properties filePick your version, start from a preset or your own file, change what you need and download it. Defaults for every version from 1.17 to 26.3.