Guide Minecraft

Minecraft Java server.properties Reference for 26.3

Configure Minecraft Java server.properties: ports, whitelist, world settings, view distance, RCON, resource packs, server management API and removed properties.

Minecraft properties illustration
Source: coop-legends.de

Overview

server.properties controls the central settings of a Minecraft Java dedicated server: the connection port, player cap, allowlist, view distance, world generation, resource packs, RCON and—since newer releases—the Minecraft Server Management Protocol.

This guide explains the configuration list for Java Edition 26.2 based on the PaperMC reference and Mojang release notes. Paper implements Vanilla settings but has differences for several options, indicated below.

Technical table baseline: 26.2, checked September 3, 2026. Latest version in source review: Java Edition 26.3, published September 15 and checked October 13, 2026. This is not a fully re-tested 26.3 default-value table. In newly generated 26.3 files, white-list defaults to true instead of the earlier false. For any other setting, the file generated by your own server JAR is the authoritative baseline.

If you are creating a Java server from scratch, start with our Minecraft Java 26.3 self-hosting guide. Java's server.properties is different from Bedrock server configuration.

How to edit server.properties

  1. Shut the server down completely.
  2. Back up the configuration, especially before large changes.
  3. Open server.properties in a text editor.
  4. Modify only the values after their equals sign.
  5. Save and restart the server.
  6. Read the console for unsupported values and network binding failures.

Most values are loaded when the server starts. Several gameplay properties from older releases have moved into Game Rules and can be changed during play instead.

If using a commercial host, verify it supports your Java release and grants either direct server.properties editing or corresponding settings in its panel.

Access, players and server browser

PropertyDefaultMeaning
max-players20Maximum concurrent player connections
online-modetrueAuthenticates accounts with Minecraft. Disabling it removes account verification and should not be a general connection fix
white-listtrue in 26.3; false in 26.2Only listed players can join
enforce-whitelistfalseRemoves connected players who do not meet an enforced allowlist
player-idle-timeout0Minutes until idle players are kicked; 0 disables the timer
motdA Minecraft ServerMessage in the server browser
enable-statustrueEnables browser status queries; disabling it can make a reachable server appear offline
hide-online-playersfalseHides the player list in status responses
enforce-secure-profiletrueRequires a Mojang-signed public profile key pair
prevent-proxy-connectionsfalseAttempts to reject mismatches between network origin and Mojang authentication
accept-transfersfalseAccepts players transferred from another server using the transfer protocol

Network, ports and data transmission

PropertyDefaultMeaning
server-ipemptyAddress to bind; empty means appropriate local interfaces. Do not unnecessarily enter your public IP
server-port25565Normal player connection port
network-compression-threshold256Minimum packet size in bytes before compression; negative disables it
rate-limit0Packet-rate limit; 0 disables it
use-native-transporttrueNative networking on supported Linux installations
entity-broadcast-range-percentage100Percentage factor for entity update range; Paper lists 10–1000

World, game mode and generation

PropertyDefaultMeaning
difficultyeasypeaceful, easy, normal or hard
gamemodesurvivalDefault player game mode
force-gamemodefalseReset rejoining players to the configured default
hardcorefalseEnables hardcore behavior; deceased players become spectators
level-nameworldWorld/folder name
level-seedemptySeed for newly generated worlds; empty means random
level-typeminecraft:normalWorld generator type; check valid values for your version
generator-settings{}JSON for custom world generation
generate-structurestrueEnable generated structures such as villages
max-world-size29999984Maximum initial world generation radius; not a substitute for the World Border
spawn-protection16Spawn protection; 0 disables it. Paper says at least one operator must exist for it to work

View distance, simulation and ticks

PropertyDefaultMeaning
view-distance10Server-side client view distance in chunks; Paper lists 3–32
simulation-distance10Chunk radius for simulated entities and game logic; Paper lists 3–32
pause-when-empty-seconds-1 on PaperDelay before pausing an empty server; Paper disables it by default to avoid unexpected plugin behavior. Vanilla originally used a different default
max-tick-time60000Watchdog threshold in ms; -1 disables it
max-chained-neighbor-updates1000000Limit for cascading block updates; negative disables it
sync-chunk-writestrueSynchronous chunk writes; Paper says this does not take effect there by default without an extra system property
region-file-compressiondeflatedeflate, lz4 or none; Paper also supports Paper-specific gzip

Operators, commands and debugging

PropertyDefaultMeaning
op-permission-level4Default operator permission level
function-permission-level2Function permission level; Paper documents 1–4
broadcast-console-to-opstrueBroadcast console command output to online operators
broadcast-rcon-to-opstrueBroadcast RCON output to online operators
debugfalseServer debug mode
log-ipstrueLog player IPs; plugins may also log addresses independently
bug-report-linkemptyURL for the client bug-report button
enable-code-of-conductfalseEnable Code of Conduct files in codeofconduct, supported since 1.21.9

Query, RCON and JMX

PropertyDefaultMeaning
enable-queryfalseEnable the GameSpy4-style server-query listener
query.port25565Query service port
enable-rconfalseEnable remote console; only with a strong password and access restrictions
rcon.port25575RCON port
rcon.passwordemptyRCON password; never leave empty or weak when enabled
enable-jmx-monitoringfalseExpose Minecraft server tick-time MBean; also requires Java/JMX startup arguments

Resource packs and data packs

PropertyDefaultMeaning
resource-packemptyURL for the server resource pack
resource-pack-idemptyUUID for the resource pack
resource-pack-sha1emptySHA-1 hash for integrity checking; recommended by Paper
resource-pack-promptemptyText shown when the client is offered the resource pack
require-resource-packfalseKick players who refuse the pack when true
initial-enabled-packsvanillaComma-separated data packs initially enabled when generating the world
initial-disabled-packsemptyData packs not enabled by default at generation

Spam and text-filter controls

PropertyDefaultMeaning
chat-spam-threshold-seconds10Separate chat spam threshold since 26.2; 0 disables corresponding automatic kicks
command-spam-threshold-seconds10Separate command spam threshold since 26.2; 0 disables corresponding automatic kicks
text-filtering-configemptyPath to text-filter config; empty disables it
text-filtering-version0Text filter format; Paper documents 0 and 1

Mojang introduced the separate chat and command spam counters in 26.2, each with the original documented threshold of 10.

Minecraft Server Management Protocol

Mojang introduced a JSON-RPC management interface over WebSocket in Java 1.21.9. It defaults to disabled and should not be publicly exposed without authentication and properly configured TLS.

PropertyDefaultMeaning
management-server-enabledfalseEnable the management interface
management-server-hostlocalhostNetwork interface to bind the service
management-server-port0Management listener port; 0 picks an available port
management-server-secretemptyAuthentication secret: Mojang documents 40 alphanumeric characters and generates one when omitted
management-server-tls-enabledtrueEnable TLS
management-server-tls-keystoreemptyTLS keystore path; without the required keystore, a TLS-enabled service cannot start correctly
management-server-tls-keystore-passwordemptyTLS keystore password; can alternatively be provided via environment or JVM argument
status-heartbeat-interval0Management heartbeat interval; 0 disables notifications

Properties removed from newer Minecraft releases

Many old tutorials list properties that are no longer valid in 26.2:

Removed propertyCurrent replacement or status
allow-netherGame Rule allowEnteringNetherUsingPortals
spawn-monstersGame Rule spawnMonsters
enable-command-blockGame Rule commandBlocksEnabled
pvpGame Rule pvp
spawn-animalsAlready removed from server.properties since 1.21.2
spawn-npcsAlready removed from server.properties since 1.21.2

The first four were moved to Game Rules in 1.21.9 so they can be changed during a live session. Do not copy them back into a modern configuration from an outdated example.

Secure starting configuration for a friends-only world

For a small private group, basic access controls are usually more important than experimental performance tweaks:

online-mode=true white-list=true enforce-whitelist=true max-players=8 server-port=25565 view-distance=10 simulation-distance=10 enable-rcon=false management-server-enabled=false

Eight players is only an example, not a capacity guarantee. Keep authentication enabled and leave administrative remote interfaces disabled unless you have a specific properly secured reason to use them.

Minecraft server.properties FAQ

server-port defaults to 25565. The Query service also defaults to 25565, while RCON defaults to 25575.

Set white-list=true. Set enforce-whitelist=true to enforce removal of players not on the list when appropriate.

No. Mojang removed them in 1.21.9 and moved the settings to Game Rules.

The separate properties chat-spam-threshold-seconds and command-spam-threshold-seconds have default values of 10.

view-distance determines how far the server sends world data to a client; simulation-distance sets the area where world and entity logic is actively simulated.

Not for an ordinary private or public internet server. This disables Minecraft account authentication and is not a general connection troubleshooting method.

For multiplayer features, see the Minecraft game profile.

Sources

Default-table baseline: Java 26.2/Paper, reviewed September 3, 2026. Source release update checked October 13, 2026.