Minecraft
Minecraft server.properties
Complete and compact explanation of all default Minecraft server.properties options with a full example.
This page explains all default options found in the server.properties file.
Keep in mind that all changes require a full server restart.
Monitoring & remote access
| Key | Example | Explanation |
|---|---|---|
enable-jmx-monitoring | false | Enables JMX monitoring for external monitoring tools. |
enable-rcon | false | Enables remote console access (RCON). |
rcon.port | 25575 | Port used for RCON connections. |
rcon.password | (empty) | Password required for RCON authentication. |
broadcast-rcon-to-ops | true | Broadcasts RCON commands to server operators. |
broadcast-console-to-ops | true | Broadcasts console commands to server operators. |
RCON should not be exposed to the public internet. The protocol transmits all data unencrypted, meaning credentials and commands can be intercepted by anyone monitoring the connection.
We strongly advise against enabling RCON on public networks.
Core server access & identity
| Key | Example | Explanation |
|---|---|---|
server-ip | (empty) | IP address the server binds to. Do not change in hosted environments. |
server-port | 25565 | Main TCP port the server listens on. |
online-mode | true | Requires Mojang authentication. |
prevent-proxy-connections | false | Attempts to block proxy/VPN connections. |
hide-online-players | false | Hides player count from server list ping. |
enable-status | true | Allows server list status ping. |
motd | A Minecraft Server | Message shown in the multiplayer server list. |
Do not edit
server-ip. Only change server-port if you understand the implications.Query & status
| Key | Example | Explanation |
|---|---|---|
enable-query | false | Enables GameSpy4 query protocol. |
query.port | 25565 | Port used for query connections. |
Player access & permissions
| Key | Example | Explanation |
|---|---|---|
max-players | 20 | Maximum number of concurrent players. |
white-list | false | Only allows whitelisted players. |
enforce-whitelist | false | Forces whitelist even for operators. |
player-idle-timeout | 0 | Kicks idle players after X minutes (0 = disabled). |
op-permission-level | 4 | Operator permission level (1–4). |
function-permission-level | 2 | Permission level for functions. |
Gameplay rules
| Key | Example | Explanation |
|---|---|---|
gamemode | survival | Default game mode for new players. |
force-gamemode | false | Forces players into the default gamemode on join. |
difficulty | easy | World difficulty. |
hardcore | false | Hardcore mode (ban on death). |
pvp | true | Enables player-versus-player combat. |
allow-flight | false | Allows flight (useful for modded servers). |
allow-nether | true | Enables the Nether dimension. |
enable-command-block | false | Allows usage of command blocks. |
World generation & size
| Key | Example | Explanation |
|---|---|---|
level-name | world | Main world folder name. |
level-seed | (empty) | Seed for world generation. |
level-type | minecraft:normal | World generator type. |
generator-settings | {} | Advanced generator settings (JSON). |
generate-structures | true | Enables villages, temples, etc. |
max-world-size | 29999984 | Maximum world border size (blocks). |
Performance & simulation
| Key | Example | Explanation |
|---|---|---|
view-distance | 10 | Chunks sent to players. |
simulation-distance | 10 | Chunks actively simulated. |
entity-broadcast-range-percentage | 100 | Entity tracking distance scaling. |
max-tick-time | 60000 | Max tick time before server shuts down. |
max-chained-neighbor-updates | 1000000 | Limits redstone update chains. |
sync-chunk-writes | true | Forces synchronous chunk writes. |
use-native-transport | true | Uses OS-native networking for performance. |
rate-limit | 0 | Packet rate limiting (0 = disabled). |
network-compression-threshold | 256 | Packet compression threshold. |
Resource packs & data packs
| Key | Example | Explanation |
|---|---|---|
resource-pack | (empty) | URL of a resource pack. |
resource-pack-sha1 | (empty) | SHA1 hash of the resource pack. |
resource-pack-prompt | (empty) | Custom prompt shown to players. |
require-resource-pack | false | Forces resource pack download. |
initial-enabled-packs | vanilla | Packs enabled on world creation. |
initial-disabled-packs | (empty) | Packs disabled on world creation. |
Chat & security
| Key | Example | Explanation |
|---|---|---|
enforce-secure-profile | true | Enforces signed chat messages (1.19+). |
text-filtering-config | (empty) | Chat filtering configuration. |
log-ips | true | Logs player IP addresses. |
Mobs & spawning
| Key | Example | Explanation |
|---|---|---|
spawn-monsters | true | Allows hostile mobs to spawn. |
spawn-animals | true | Allows animals to spawn. |
spawn-npcs | true | Allows villagers and NPCs. |
spawn-protection | 16 | Spawn protection radius for non-OP players. |
Complete example server.properties
server.properties
enable-jmx-monitoring=false
rcon.port=25575
level-seed=
gamemode=survival
enable-command-block=false
enable-query=false
generator-settings={}
enforce-secure-profile=true
level-name=world
motd=A Minecraft Server
query.port=25565
pvp=true
generate-structures=true
max-chained-neighbor-updates=1000000
difficulty=easy
network-compression-threshold=256
max-tick-time=60000
require-resource-pack=false
use-native-transport=true
max-players=20
online-mode=true
enable-status=true
allow-flight=false
initial-disabled-packs=
broadcast-rcon-to-ops=true
broadcast-console-to-ops=true
view-distance=10
server-ip=
resource-pack-prompt=
allow-nether=true
server-port=25565
enable-rcon=false
sync-chunk-writes=true
op-permission-level=4
prevent-proxy-connections=false
hide-online-players=false
resource-pack=
entity-broadcast-range-percentage=100
simulation-distance=10
rcon.password=
player-idle-timeout=0
force-gamemode=false
rate-limit=0
hardcore=false
white-list=false
spawn-npcs=true
spawn-animals=true
log-ips=true
function-permission-level=2
initial-enabled-packs=vanilla
level-type=minecraft:normal
text-filtering-config=
spawn-monsters=true
enforce-whitelist=false
spawn-protection=16
resource-pack-sha1=
max-world-size=29999984