Skip to content

Settings

PetteriM1 edited this page Mar 27, 2020 · 31 revisions

In Nukkit PetteriM1 Edition server.properties file contains all settings for Nukkit, here is explained what they do:

motd

server name / text that shows on server list

sub-motd

second line for motd

shows only for local players

server-port

server's port

there can't be two servers running in same port

server-ip

ip where server runs

default is 0.0.0.0 and you usually don't need to change this

view-distance

maxim view distance in chunks

bigger = more chunks loaded = more ram usage

white-list

allow only players on whitelist to join server

achievements

enable player achievements

announce-player-achievements

broadcast achievement messages for all players

spawn-protection

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

max-players

maxim number of players

spawn-animals

spawn animals

spawn-mobs

spawn mobs

entity-auto-spawn-task

enable task for auto spawning mobs and animals

spawn-animals, spawn-mobs or both must be enabled if you want anything to be spawned

works by server difficulty setting

entity-despawn-task

enable despawning for mobs and animals

recommended to keep this enabled

language

language that nukkit uses

in default builds only english (eng) included

force-language

force game to use language files from server

shutdown-message

message that shows for players when you stop the server

use § for colors and §n for new line

save-player-data

enable saving of player inventory, position etc.

recommended to keep enabled if you have single world server

can be disabled for creative or minigame only server

for multi world servers it is recommended to use plugin like world essentials and disable this

gamemode

server's default gamemode

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

force-gamemode

set player's gamemode to default gamemode every time he joins

hardcore

player will be banned after he dies

pvp

enable or disable pvp on server

difficulty

server's default difficulty

generator-settings

special settings for world generator

level-name

name of default level

level-seed

default level's seed

level-type

default level's type

default, normal, flat, nether or end

enable-query

enable / disable query

keep this on if you put your server to server list

enable-rcon

enable / disable rcon

rcon can be used for remote console

rcon.password

password for rcon connection

auto-save

enable / disable auto saving for worlds

force-resources

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

xbox-auth

require xbox account to join

bed-spawnpoints

enable bed spawnpoints

may be good idea to disable this if you don't have single world survival server

explosion-break-blocks

enable explosion damage for blocks

affects for all explosions like tnt, creepers and end crystals

stop-in-game

allow op to use /stop command in game

recommended to keep this disabled

op-in-game

allow op to op more players in game

you may want to disable this

xp-bottles-on-creative

allow creative players to throw experience bottles

you may want to disable this because its very easy to crash server by spamming them

spawn-eggs

enable spawn eggs

recommended to disable this for creative servers

mob-ai

enable build in entity ai

query-plugins

send list of plugins in query

enable if you want to show list of your plugins on server list

debug-level

set higher value if you need debug data

async-workers

if set to auto it will try to detect the number of cores

zlib-provider

select zlib provider

async-compression

use async tasks for compression

adds half/one tick delay, less cpu load on main thread

compression-level

compression level used of zlib when sending batched packets

higher = more cpu usage but less bandwidth usage

auto-tick-rate

allow server to automatically change levels tick rate to maintain 20 ticks per second

auto-tick-rate-limit

how much server can drop tick rate

base-tick-rate

default tick rate

1 = 20 ticks per second, 2 = 10 ticks per second, etc.

recommended to keep as default (1)

always-tick-players

haven't found any usage for this

enable-timings

enable timings by default

timings-verbose

enable verbose for timings

timings-privacy

hide some stuff from timings report

timings-history-interval

interval between history frames for timings

in ticks, 20 ticks = 1 second

timings-history-length

length of timings history

in ticks, 20 ticks = 1 second

timings-bypass-max

allow timings to bypass max

light-updates

enable light updates

usually no reason to disable this

clear-chunk-tick-list

haven't found any usage for this

cache-chunks

save chunks to memory for faster sending

note: no multiversion support

spawn-threshold

how many chunks needs to be loaded before player spawns

chunk-sending-per-tick

how many chunks can be send per tick

chunk-ticking-per-tick

how many chunks can be ticked per tick

chunk-ticking-radius

radius in chunks around players to get ticked

chunk-generation-queue-size

how many chunks can be waiting for generation

chunk-generation-population-queue-size

how many chunks can be waiting for population

ticks-per-autosave

how often world autosave task runs

in ticks, 20 ticks = 1 second

ticks-per-entity-spawns

how often entity auto spawner runs

in ticks, 20 ticks = 1 second

ticks-per-entity-despawns

how long entities lives

in ticks, 20 ticks = 1 second

thread-watchdog

task that checks if server is freezing and kills it

useful if you have auto restart script

thread-watchdog-tick

how ofter thread watchdog runs its check

in ticks, 20 ticks = 1 second

nether

enable nether dimension and nether portals

end

enable end dimension and end portals

suomicraft-mode

enable / disable random stuff that makes things run better on suomicraft server

recommended to keep this disabled

do-not-tick-worlds

list of worlds where random block ticking is disabled

this disables plants growing, leaves decacying, dirt turning into grass, falling blocks etc.

you may want to add lobby and minigame worlds here

load-all-worlds

load all worlds from worlds folder on startup

ansi-title

enable server status title for console window

disable this if you get text glitches (common issue with panels)

worlds-entity-spawning-disabled

list of world where entity auto spawning is not allowed

example: lobby, pvp, creative

block-listener

enable checks used for snow and iron golems, monster egg stone etc.

allow-flight

enable/disable fly anticheat

timeout-milliseconds

how long should the server wait before kicking player if no response from client

in milliseconds, 1000 milliseconds = 1 second

multiversion-min-protocol

the minium allowed protocol version

to allow all supported protocol versions set this to 0 or any other value lower than the minium supported protocol version

vanilla-bossbars

show boss bar for wither and ender dragon (experimental)

dimensions

enable dimensions (experimental)

whitelist-reason

that message is shown if player gets kicked because of white-listed server

use § for colors and §n for new line

chemistry-resources-enabled

enable textures for chemistry mode blocks and items with no resource pack downloading needed

temp-ip-ban-failed-xbox-auth

block ip of player for 5 seconds when xbox auth fails

helps to prevent bot clients to slow down the server but may cause problems if many players uses same ip

call-data-pk-send-event

you can disable DataPacketSendEvent for better performance if none of your plugins uses it

call-batch-pk-send-event

you can disable BatchPacketsEvent for better performance if none of your plugins uses it

do-level-gc

enable/disable level garbage collection

skin-change-cooldown

cooldown for in game skin changes in seconds

check-op-movement

enable movement checking for operators

do-not-limit-interactions

option to disable hack to limit right click spamming

do-not-limit-skin-geometry

disable maximum skin and geometry size checks

warning: too big skins can crash the server

You can’t perform that action at this time.