Configuration
Files
server.properties

Server Properties

This page displays the server.properties file of PowerNukkitX with default values
server.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

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