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
- Shut the server down completely.
- Back up the configuration, especially before large changes.
- Open
server.propertiesin a text editor. - Modify only the values after their equals sign.
- Save and restart the server.
- 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
| Property | Default | Meaning |
|---|---|---|
max-players | 20 | Maximum concurrent player connections |
online-mode | true | Authenticates accounts with Minecraft. Disabling it removes account verification and should not be a general connection fix |
white-list | true in 26.3; false in 26.2 | Only listed players can join |
enforce-whitelist | false | Removes connected players who do not meet an enforced allowlist |
player-idle-timeout | 0 | Minutes until idle players are kicked; 0 disables the timer |
motd | A Minecraft Server | Message in the server browser |
enable-status | true | Enables browser status queries; disabling it can make a reachable server appear offline |
hide-online-players | false | Hides the player list in status responses |
enforce-secure-profile | true | Requires a Mojang-signed public profile key pair |
prevent-proxy-connections | false | Attempts to reject mismatches between network origin and Mojang authentication |
accept-transfers | false | Accepts players transferred from another server using the transfer protocol |
Network, ports and data transmission
| Property | Default | Meaning |
|---|---|---|
server-ip | empty | Address to bind; empty means appropriate local interfaces. Do not unnecessarily enter your public IP |
server-port | 25565 | Normal player connection port |
network-compression-threshold | 256 | Minimum packet size in bytes before compression; negative disables it |
rate-limit | 0 | Packet-rate limit; 0 disables it |
use-native-transport | true | Native networking on supported Linux installations |
entity-broadcast-range-percentage | 100 | Percentage factor for entity update range; Paper lists 10–1000 |
World, game mode and generation
| Property | Default | Meaning |
|---|---|---|
difficulty | easy | peaceful, easy, normal or hard |
gamemode | survival | Default player game mode |
force-gamemode | false | Reset rejoining players to the configured default |
hardcore | false | Enables hardcore behavior; deceased players become spectators |
level-name | world | World/folder name |
level-seed | empty | Seed for newly generated worlds; empty means random |
level-type | minecraft:normal | World generator type; check valid values for your version |
generator-settings | {} | JSON for custom world generation |
generate-structures | true | Enable generated structures such as villages |
max-world-size | 29999984 | Maximum initial world generation radius; not a substitute for the World Border |
spawn-protection | 16 | Spawn protection; 0 disables it. Paper says at least one operator must exist for it to work |
View distance, simulation and ticks
| Property | Default | Meaning |
|---|---|---|
view-distance | 10 | Server-side client view distance in chunks; Paper lists 3–32 |
simulation-distance | 10 | Chunk radius for simulated entities and game logic; Paper lists 3–32 |
pause-when-empty-seconds | -1 on Paper | Delay before pausing an empty server; Paper disables it by default to avoid unexpected plugin behavior. Vanilla originally used a different default |
max-tick-time | 60000 | Watchdog threshold in ms; -1 disables it |
max-chained-neighbor-updates | 1000000 | Limit for cascading block updates; negative disables it |
sync-chunk-writes | true | Synchronous chunk writes; Paper says this does not take effect there by default without an extra system property |
region-file-compression | deflate | deflate, lz4 or none; Paper also supports Paper-specific gzip |
Operators, commands and debugging
| Property | Default | Meaning |
|---|---|---|
op-permission-level | 4 | Default operator permission level |
function-permission-level | 2 | Function permission level; Paper documents 1–4 |
broadcast-console-to-ops | true | Broadcast console command output to online operators |
broadcast-rcon-to-ops | true | Broadcast RCON output to online operators |
debug | false | Server debug mode |
log-ips | true | Log player IPs; plugins may also log addresses independently |
bug-report-link | empty | URL for the client bug-report button |
enable-code-of-conduct | false | Enable Code of Conduct files in codeofconduct, supported since 1.21.9 |
Query, RCON and JMX
| Property | Default | Meaning |
|---|---|---|
enable-query | false | Enable the GameSpy4-style server-query listener |
query.port | 25565 | Query service port |
enable-rcon | false | Enable remote console; only with a strong password and access restrictions |
rcon.port | 25575 | RCON port |
rcon.password | empty | RCON password; never leave empty or weak when enabled |
enable-jmx-monitoring | false | Expose Minecraft server tick-time MBean; also requires Java/JMX startup arguments |
Resource packs and data packs
| Property | Default | Meaning |
|---|---|---|
resource-pack | empty | URL for the server resource pack |
resource-pack-id | empty | UUID for the resource pack |
resource-pack-sha1 | empty | SHA-1 hash for integrity checking; recommended by Paper |
resource-pack-prompt | empty | Text shown when the client is offered the resource pack |
require-resource-pack | false | Kick players who refuse the pack when true |
initial-enabled-packs | vanilla | Comma-separated data packs initially enabled when generating the world |
initial-disabled-packs | empty | Data packs not enabled by default at generation |
Spam and text-filter controls
| Property | Default | Meaning |
|---|---|---|
chat-spam-threshold-seconds | 10 | Separate chat spam threshold since 26.2; 0 disables corresponding automatic kicks |
command-spam-threshold-seconds | 10 | Separate command spam threshold since 26.2; 0 disables corresponding automatic kicks |
text-filtering-config | empty | Path to text-filter config; empty disables it |
text-filtering-version | 0 | Text 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.
| Property | Default | Meaning |
|---|---|---|
management-server-enabled | false | Enable the management interface |
management-server-host | localhost | Network interface to bind the service |
management-server-port | 0 | Management listener port; 0 picks an available port |
management-server-secret | empty | Authentication secret: Mojang documents 40 alphanumeric characters and generates one when omitted |
management-server-tls-enabled | true | Enable TLS |
management-server-tls-keystore | empty | TLS keystore path; without the required keystore, a TLS-enabled service cannot start correctly |
management-server-tls-keystore-password | empty | TLS keystore password; can alternatively be provided via environment or JVM argument |
status-heartbeat-interval | 0 | Management 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 property | Current replacement or status |
|---|---|
allow-nether | Game Rule allowEnteringNetherUsingPortals |
spawn-monsters | Game Rule spawnMonsters |
enable-command-block | Game Rule commandBlocksEnabled |
pvp | Game Rule pvp |
spawn-animals | Already removed from server.properties since 1.21.2 |
spawn-npcs | Already 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=falseEight 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
For multiplayer features, see the Minecraft game profile.
Sources
- Mojang — Minecraft Java 26.3 (new allowlist default).
- PaperMC — server.properties reference.
- Mojang — Minecraft Java 26.2.
- Mojang — Java 1.21.9 management protocol and Game Rules.
- Mojang — Java 1.21.2.
- PaperMC — Basic Troubleshooting.
Default-table baseline: Java 26.2/Paper, reviewed September 3, 2026. Source release update checked October 13, 2026.