Server Properties
This page displays the
server.properties
file of PowerNukkitX with default valuesserver.properties
motd=PowerNukkitX Server
sub-motd=v2.powernukkitx.com
server-port=19132
server-ip=0.0.0.0
view-distance=16
white-list=off
achievements=on
announce-player-achievements=on
spawn-protection=16
max-players=20
allow-flight=off
spawn-animals=on
spawn-mobs=on
gamemode=0
force-gamemode=off
hardcore=off
pvp=on
difficulty=1
level-name=world
level-seed=
allow-nether=off
allow-the_end=off
use-terra=off
enable-query=on
enable-rcon=off
rcon.password=2NDcxN2E3Y
auto-save=on
force-resources=off
force-resources-allow-client-packs=off
xbox-auth=on
check-login-time=off
disable-auto-bug-report=off
allow-shaded=off
server-authoritative-movement=server-auth
network-encryption=on
motd
- Description: The text shown to players within the server list.
- Accepted values: Any string
- Default value:
PowerNukkitX
sub-motd
- Description: The world name shown in the pause menu.
- Accepted values: Any string
- Default value:
v2.powernukkitx.org
server-ip
- Description: The IP address the server binds to. Set to
0.0.0.0
to listen on all available interfaces. - Accepted values: Any valid IPv4 or IPv6 address.
- Default value:
0.0.0.0
server-port
- Description: The port number the server listens on. Ensure it is not blocked by firewalls.
- Accepted values: Any number between
1-65535
. - Default value:
25565
view-distance
- Description: The maximum view distance for the server
- Accepted values: Any number
- Default value:
12
allow-list
- Description: Enable or disable the allowlist in the game.
- Accepted values:
on
,off
- Default value:
off
achievements
- Description: Enable or disable player achievements in the game.
- Accepted values:
on
,off
- Default value:
on
annouce-player-achievements
- Description: Enable or disable the announcement of player achievements.
- Accepted values:
on
,off
- Default value:
on
spawn-protection
- Description: The radius around the spawn that should be protected.
- Accepted values: Any number
- Default value:
16
max-players
- Description: The maximum amount of players who should be able to join the server.
- Accepted values: Any number
- Default value:
20
allow-flight
- Description: Wheter to allow players to fly - players will be kicked if they are detected for flying if turned on.
- Accepted values:
on
,off
- Default value:
off
spawn-animals
- Description: Enable or disable the natural spawning of animals.
- Accepted values:
on
,off
- Default value:
on
spawn-mobs
- Description: Enable or disable the natural spawning of mobs.
- Accepted values:
on
,off
- Default value:
on
gamemode
- Description: The default gamemode players should be in when joining the server.
- Accepted values:
0
(Survival)1
(Creative)2
(Adventure)3
(Spectator)
- Default value:
0
(Survival)
force-gamemode
- Description: Whether to force joining players back into the default gamemode.
- Accepted values:
on
,off
- Default value:
off
hardcore
- Description: Enable or disable hardcore mode: If a player dies, they are banned.
- Accepted values:
on
,off
- Default value:
off
pvp
- Description: Whether to allow players fighting against each other.
- Accepted values:
on
,off
- Default value:
on
difficulty
- Description: The difficulty setting affects gameplay mechanics, for example mob spawning and damage.
- Accepted values:
0
(Peaceful)1
(Easy)2
(Normal)3
(Hard)
- Default value:
1
(Easy)
level-name
- Description: The name of the world in which new players should spawn in by default.
- Accepted values: Any world name (creates a new world if non-existent)
- Default value:
world
level-seed
- Description: The seed used to generate the world.
- Accepted values: Any seed (leave empty to for a random seed)
- Default value:
allow-nether
- Description: Enable or disable nether portals.
- Accepted values:
on
,off
- Default value:
on
allow-the_end
- Description: Enable or disable end portals.
- Accepted values:
on
,off
- Default value:
on
use-terra
- Description: Enable or disable the usage of Terra packs to generate worlds. Read more on how to use Terra here
- Accepted values:
on
,off
- Default value:
on
enable-query
- Description: Enable or disable the visibility of server information to protocol servers.
- Accepted values:
on
,off
- Default value:
on
enable-rcon
- Description: Enable or disable the remote console
- Accepted values:
on
,off
- Default value:
off
rcon.password
- Description: Password for remote console (RCON) access.
- Accepted values: Any string.
- Default value: Randomly generated string.
⚠️
When using remote console, your server is exposed to the internet. Make sure to use a secure password!
auto-save
- Description: Enable or disable the automatic saving of worlds. You can change the save interval in pnx.yml.
- Accepted values:
on
,off
- Default value:
on
force-resources
- Description: Whether to force players to download the server's resource packs
- Accepted values:
on
,off
- Default value:
off
force-resources-allow-client-packs
- Description: Whether to allow players to use their own resource packs when force-resources is turned on.
- Accepted values:
on
,off
- Default value:
off
xbox-auth
- Description: Enable or disable Xbox Online verification
- Accepted values:
on
,off
- Default value:
on
⚠️
Disabling verification allows bad actors to join your server without verification of their identity, thus creating a potential security risk. Only modify this if you know what you are doing!
check-login-time
- Description: Enable or disable checking players' login times. This can reduce the likelihood of malicious attacks, but it may also prevent some players from connecting to the server.
- Accepted values:
on
,off
- Default value:
off
disable-auto-bug-report
- Description: If enabled, the server will no longer send automatic error reports to the Sentry platform of the PowerNukkitX development team.
- Accepted values:
on
,off
- Default value:
off
allow-shaded
- Description: Wheter to allow the usage of shades packages to boot the server
- Accepted values:
on
,off
- Default value:
off
server-authoritative-movement
- Description: This setting decides whether to verify movement on the server or trust the clients.
- Accepted values:
client-auth
,server-auth
- Default value:
server-auth
network-encryption
- Description: Enable or disable the encryption of data on the network.
- Accepted values:
on
,off
- Default value:
off