Skip to main content

server.properties

Modify the running configuration of the server to customize some basic functionalities.

These are the standard Minecraft server settings defined in server.properties. For advanced Nukkit-MOT settings, see nukkit-mot.yml.

motd​

Data TypeDefault Value
StringMinecraft Server

server name / text which shows on the server list

note

can't be empty

sub-motd​

Data TypeDefault Value
StringPowered by Nukkit-MOT

second line for motd

note

shows only for players in local network when viewing the server on the friends list in game

can't be empty since 1.16.210

server-port​

Data TypeDefault Value
Integer19132

server's port

note

there can't be two servers running in the same port

you will need to port forward in order to have your server publicly accessible

bedrock edition uses UDP

server-ip​

Data TypeDefault Value
String0.0.0.0

server's IP address

note

there can't be two servers running in the same port

you will need to port forward in order to have your server publicly accessible

bedrock edition uses UDP

view-distance​

Data TypeDefault Value
Integer8

maximum view distance in chunks

bigger value = more chunks loaded = more ram & cpu usage

max-players​

Data TypeDefault Value
Integer50

Maximum number of players allowed on the server

language​

Data TypeDefault Value
Stringeng

default language that Nukkit uses

force-language​

Data TypeDefault Value
Booleanoff

force server side translations to be used

enable only if you have a plugin to implement those

shutdown-message​

Data TypeDefault Value
StringServer closed

message that shows for players when you stop the server

use § for colors and §n for new line

gamemode​

Data TypeDefault Value
Integer0

server's default gamemode

0 = survival, 1 = creative, 2 = adventure, 3 = spectator

force-gamemode​

Data TypeDefault Value
Booleanon

set player gamemode to default gamemode on every join

difficulty​

Data TypeDefault Value
Integer2

server's default difficulty (0-3)

hardcore​

Data TypeDefault Value
Booleanoff

players will be banned when they die

pvp​

Data TypeDefault Value
Booleanon

Whether to enable player versus player combat

level-name​

Data TypeDefault Value
Stringworld

Name of the default world

level-seed​

Data TypeDefault Value
String

Seed for the default level

level-type​

Data TypeDefault Value
Stringdefault

generator used to create the default level if it doesn't exist

supported by default: default, normal, flat, nether, the_end or void

generator-settings​

Data TypeDefault Value
String

Special world generator settings for the default level

spawn-protection​

Data TypeDefault Value
Integer10

size of the spawn area in blocks where non op players can't build or break blocks

white-list​

Data TypeDefault Value
Booleanoff

allow only players on the whitelist to join the server

use /whitelist command or modify white-list.txt to add players to whitelist

whitelist-reason​

Data TypeDefault Value
StringServer is white-listed

Reason for enabling the whitelist, displayed to players when they are denied access

xbox-auth​

Data TypeDefault Value
Booleanon

require Xbox account to join

note

does not bypass client side requirements

if you disable this (not recommended), install a login plugin to protect player account security

encryption​

Data TypeDefault Value
Booleanon

enable network encryption

it's recommended to enable this if you don't use a proxy software

force-resources​

Data TypeDefault Value
Booleanoff

force players to download server's resource pack if they want to join

force-resources-allow-client-packs​

Data TypeDefault Value
Booleanoff

don't disable client's own packs when force-resources is enabled

spawn-animals​

Data TypeDefault Value
Booleanon

enable animal spawning

spawn-mobs​

Data TypeDefault Value
Booleanon

enable monster spawning

allow-flight​

Data TypeDefault Value
Booleanoff

enable / disable allowing players to fly

note

if players are often kicked for flying, try setting this to on

auto-save​

Data TypeDefault Value
Booleanon

automatically save the world and player data

note

if disabled, changes to worlds are not saved automatically even on unload, use plugin to save manually if needed

enable-rcon​

Data TypeDefault Value
Booleanoff

enable remote console access

note

rcon isn't very secure way to remote control the server

rcon uses the same port (but TCP) as the server

See: https://developer.valvesoftware.com/wiki/Source_RCON_Protocol

rcon.password​

Data TypeDefault Value
StringRandom 10 characters

Password for RCON connections

rcon.port​

Data TypeDefault Value
Integer25575

Port for RCON connections

enable-query​

Data TypeDefault Value
Booleanon

enable extended query

server-authoritative-movement​

Data TypeDefault Value
Stringserver-auth

Server authoritative movement

Optional: client-auth / server-auth-with-rewind / server-auth

server-authoritative-block-breaking​

Data TypeDefault Value
Booleanon

Server authoritative block breaking