HypeServ
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

KeyExampleExplanation
enable-jmx-monitoringfalseEnables JMX monitoring for external monitoring tools.
enable-rconfalseEnables remote console access (RCON).
rcon.port25575Port used for RCON connections.
rcon.password(empty)Password required for RCON authentication.
broadcast-rcon-to-opstrueBroadcasts RCON commands to server operators.
broadcast-console-to-opstrueBroadcasts 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.
Using RCON requires a separate port. You can add a port in the panel.

Core server access & identity

KeyExampleExplanation
server-ip(empty)IP address the server binds to. Do not change in hosted environments.
server-port25565Main TCP port the server listens on.
online-modetrueRequires Mojang authentication.
prevent-proxy-connectionsfalseAttempts to block proxy/VPN connections.
hide-online-playersfalseHides player count from server list ping.
enable-statustrueAllows server list status ping.
motdA Minecraft ServerMessage shown in the multiplayer server list.
Do not edit server-ip. Only change server-port if you understand the implications.

Query & status

KeyExampleExplanation
enable-queryfalseEnables GameSpy4 query protocol.
query.port25565Port used for query connections.
Query requires a separate port. You can add one in the panel.

Player access & permissions

KeyExampleExplanation
max-players20Maximum number of concurrent players.
white-listfalseOnly allows whitelisted players.
enforce-whitelistfalseForces whitelist even for operators.
player-idle-timeout0Kicks idle players after X minutes (0 = disabled).
op-permission-level4Operator permission level (1–4).
function-permission-level2Permission level for functions.

Gameplay rules

KeyExampleExplanation
gamemodesurvivalDefault game mode for new players.
force-gamemodefalseForces players into the default gamemode on join.
difficultyeasyWorld difficulty.
hardcorefalseHardcore mode (ban on death).
pvptrueEnables player-versus-player combat.
allow-flightfalseAllows flight (useful for modded servers).
allow-nethertrueEnables the Nether dimension.
enable-command-blockfalseAllows usage of command blocks.

World generation & size

KeyExampleExplanation
level-nameworldMain world folder name.
level-seed(empty)Seed for world generation.
level-typeminecraft:normalWorld generator type.
generator-settings{}Advanced generator settings (JSON).
generate-structurestrueEnables villages, temples, etc.
max-world-size29999984Maximum world border size (blocks).

Performance & simulation

KeyExampleExplanation
view-distance10Chunks sent to players.
simulation-distance10Chunks actively simulated.
entity-broadcast-range-percentage100Entity tracking distance scaling.
max-tick-time60000Max tick time before server shuts down.
max-chained-neighbor-updates1000000Limits redstone update chains.
sync-chunk-writestrueForces synchronous chunk writes.
use-native-transporttrueUses OS-native networking for performance.
rate-limit0Packet rate limiting (0 = disabled).
network-compression-threshold256Packet compression threshold.

Resource packs & data packs

KeyExampleExplanation
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-packfalseForces resource pack download.
initial-enabled-packsvanillaPacks enabled on world creation.
initial-disabled-packs(empty)Packs disabled on world creation.

Chat & security

KeyExampleExplanation
enforce-secure-profiletrueEnforces signed chat messages (1.19+).
text-filtering-config(empty)Chat filtering configuration.
log-ipstrueLogs player IP addresses.

Mobs & spawning

KeyExampleExplanation
spawn-monsterstrueAllows hostile mobs to spawn.
spawn-animalstrueAllows animals to spawn.
spawn-npcstrueAllows villagers and NPCs.
spawn-protection16Spawn 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