Configuration
Nukkit offers extensive configuration options to customize your server's behavior, performance, and features.
Main Configuration Files
server.properties
The standard Minecraft server configuration file.
Common Settings:
motd: The name displayed in the server list (Message of the Day)sub-motd: The text displayed below the name in the server listserver-port: The port your server runs on (default:19132)view-distance: Maximum chunk render distance sent to players (default:10)gamemode: Default game mode (0=Survival,1=Creative,2=Adventure,3=Spectator)difficulty: World difficulty (0=Peaceful,1=Easy,2=Normal,3=Hard)xbox-auth: Require players to be authenticated with Xbox Live (on/off)white-list: Restrict server access to specific players (on/off)pvp: Enable player vs player combat (on/off)allow-nether/allow-the-end: Enable alternate dimensions (on/off)
nukkit.yml
Nukkit-specific advanced configuration.
Key Sections:
- Performance: Tick rate, chunk settings, entity limits
- World Generation: Generator settings, terrain options
- Network: Protocol settings, compression
- Features: Enable/disable specific Nukkit features
Editing Configuration
Stop the Server
Always stop your server before editing config files:
Edit the File
Open server.properties or nukkit.yml with any text editor (Notepad, VS Code, Nano).
Save Changes
Save the file after making your changes.
Restart the Server
Start your server to apply the new settings.
Important Notes
Warning: Invalid values in config files can prevent your server from starting. Always backup your config files before making changes.
- Changes only take effect after a restart
- Comments in config files start with
# - Boolean values in
server.propertiesuseonoroff - Always use a proper text editor (like VS Code or Notepad++) to avoid formatting errors.