PowerNukkitX Server Software FAQ
10 questions players actually ask, answered.
How do I start a PowerNukkitX server from scratch?
Download PowerNukkitX, run the JAR file to generate your server folder and configuration files, then edit server.properties to set your world name, difficulty, and game mode before launching again. The server will create a default world and be ready for players to connect via your IP address.
Can I use my existing Bedrock world on a PowerNukkitX server?
Yes, you can place your Bedrock world files into the server's worlds folder, but ensure the world format is compatible with PowerNukkitX and back up your data first. Some custom modifications from single-player may not transfer perfectly.
Do vanilla Bedrock commands work on PowerNukkitX?
Yes, PowerNukkitX supports standard Bedrock commands like /give, /setblock, /tp, and /gamemode without modification. Custom plugins can add additional commands beyond the vanilla set.
How do I add a plugin to my server?
Place the plugin JAR file into your server's plugins folder, then restart the server—PowerNukkitX will load it automatically on startup. Check your server logs to confirm the plugin loaded without errors.
What's the difference between custom items and custom blocks?
Custom items are objects players carry in their inventory (like tools or food), while custom blocks are solid structures placed in the world that can have unique properties and interactions. Both require separate setup processes but can work together.
Will my server run on Linux?
Yes, PowerNukkitX runs on any system with Java installed, including Linux, Windows, and macOS. Just run the JAR file the same way you would on Windows.
How do I change mob behavior or spawn rates?
Edit your server.properties or world-specific configuration files to adjust spawn limits and difficulty settings, which affects mob behavior. For deeper customization, you'll need a plugin that modifies mob AI or spawn mechanics.
Can players use Bedrock Edition clients to join my PowerNukkitX server?
Yes, PowerNukkitX is built specifically for Bedrock Edition clients, so any player with Bedrock Edition can connect using your server's IP address and port.
My server is running slow—what should I check?
Check your server.properties for view-distance and entity-spawn settings, reduce the number of active plugins, and monitor your Java heap memory allocation. Large worlds with many custom blocks or mobs will require more resources.
Do I need to restart the server every time I add a custom item or block?
Yes, the server must restart to load new custom items and blocks into the world. Most plugins also require a restart to take effect, though some may support hot-reloading depending on their design.