Minecraft Bedrock server properties

The server.properties file controls gameplay, access, networking, performance, and scripting settings for a native Minecraft Bedrock Edition server.

Edit server.properties

Create a backup

Create a server backup before changing several settings or an unfamiliar advanced property.

Stop the server

Stop the server so it does not overwrite the file while you edit it.

Open the file

Open the file manager and select server.properties in the server’s main directory.

Change the setting

Keep one property per line in name=value format. Use an accepted value and do not add spaces around =.

difficulty=normal

Save and restart

Save the file, start the server, and watch the console for an invalid-value or configuration error.

Do not change server-port, server-portv6, or other network fields unless Purpify instructs you to. The server must use its assigned network allocation.

Gameplay and world properties

Property	Accepted value or purpose
`allow-cheats`	`true` or `false`; allows commands that require cheats.
`difficulty`	`peaceful`, `easy`, `normal`, or `hard`.
`gamemode`	`survival`, `creative`, or `adventure` for new players.
`force-gamemode`	`true` forces the configured game mode instead of the world’s saved mode.
`level-name`	Selects the world folder used by the server.
`level-seed`	Sets the seed used when generating a world.
`tick-distance`	Controls how many nearby chunks continue ticking. Supported range: `4` to `12`.
`view-distance`	Limits the number of chunks sent around each player.
`texturepack-required`	`true` requires players to accept the server resource pack.

Player and access properties

Property	Accepted value or purpose
`allow-list`	`true` restricts connections to players in `allowlist.json`.
`default-player-permission-level`	`visitor`, `member`, or `operator`.
`max-players`	A positive number limiting simultaneous players.
`online-mode`	Controls Xbox Live authentication; keep enabled for an internet-facing server.
`player-idle-timeout`	Minutes before an idle player is removed; `0` disables the timeout.
`chat-restriction`	`None`, `Dropped`, or `Disabled`.
`disable-custom-skins`	`true` blocks skins created outside Minecraft’s provided assets.
`disable-player-interaction`	`true` tells clients to ignore interactions involving other players.

Performance and networking properties

Property	Accepted value or purpose
`server-name`	The name advertised by the Bedrock server; do not use a semicolon.
`max-threads`	Maximum server threads; `0` allows all available threads.
`compression-algorithm`	`zlib` or `snappy`.
`compression-threshold`	Payload size at which network compression begins.
`enable-lan-visibility`	Controls whether the server responds to LAN discovery.
`client-side-chunk-generation-enabled`	Allows supported clients to generate visual chunks beyond interaction distance.
`player-position-acceptance-threshold`	Controls tolerance for client and server position differences.
`server-authoritative-movement-strict`	Enables stricter correction of player movement differences.
`server-authoritative-entity-interactions-strict`	Enables stricter validation of entity interactions.
`server-authoritative-dismount-strict`	Enables stricter validation of dismount positions.

Scripting and diagnostics properties

Property	Accepted value or purpose
`content-log-file-enabled`	Writes content errors to a log file when enabled.
`allow-inbound-script-debugging`	Allows the script debugger to listen for a connection.
`allow-outbound-script-debugging`	Allows the script debugger to connect outward.
`script-debugger-auto-attach`	`disabled`, `connect`, or `listen`.
`script-debugger-passcode`	Passcode used by a permitted debugger connection. Keep it private.
`script-watchdog-enable`	Enables monitoring for scripts that hang or exceed limits.
`script-watchdog-memory-limit`	Script memory limit in megabytes; `0` disables the limit.
`script-watchdog-memory-warning`	Combined script memory usage that produces a warning.

Leave advanced debugging, movement-validation, compression, and watchdog settings unchanged unless an add-on author or Purpify support gives you a specific value.

Common configuration tasks

Enable cheats

Set allow-cheats safely and restart the server.

Change difficulty

Choose Peaceful, Easy, Normal, or Hard.

Manage the allowlist

Restrict the server to approved Xbox Gamertags.

Manage files

Edit configuration files and keep safe copies.

Bedrock Edition

Manage players

Configure Bedrock

Worlds and add-ons

Troubleshooting

Minecraft Bedrock server properties

Edit server.properties

Gameplay and world properties

Player and access properties

Performance and networking properties

Scripting and diagnostics properties

Common configuration tasks

Enable cheats

Change difficulty

Manage the allowlist

Manage files

​Edit server.properties

​Gameplay and world properties

​Player and access properties

​Performance and networking properties

​Scripting and diagnostics properties

​Common configuration tasks

Enable cheats

Change difficulty

Manage the allowlist

Manage files

Edit server.properties

Gameplay and world properties

Player and access properties

Performance and networking properties

Scripting and diagnostics properties

Common configuration tasks