
PowerNukkitX: Build and Host Your Own Minecraft Bedrock Server
PowerNukkitX/PowerNukkitX
Open-source, feature-rich Minecraft: Bedrock Edition server written in Java. Supports custom items, blocks, entities, full vanilla commands, advanced mob AI, and world generation. Not affiliated with Mojang AB.
View on GitHub ↗PowerNukkitX is an open-source server software that lets you run your own Minecraft: Bedrock Edition server without relying on Microsoft's infrastructure. It's written in Java, community-maintained, and has 623 GitHub stars backing it. If you want full control over a Bedrock server - custom items, custom mobs, advanced game rules - this is the project that makes it possible.
What This Project Does
PowerNukkitX is a from-scratch implementation of a Minecraft Bedrock server. That means it handles the entire server-client communication, world persistence, mob spawning, combat math, block updates - everything that happens when players connect to a server. It's not a mod or addon layered on top of vanilla; it's a complete replacement server written in Java that speaks the Bedrock protocol.
The project got its name from an earlier server software called Nukkit, which did the same thing for an older Bedrock version. PowerNukkitX is the modernized, actively maintained continuation. Real talk, the team keeps it updated to match current Minecraft versions (we're at 1.26.30 for the latest stable release), and it supports custom content creation that vanilla servers can't.
Why You'd Use This
Most people run Bedrock servers through Realms or a hosting provider. Those are fine if you just want vanilla survival with your friends. But if you want to do something more - custom survival with unique items, a creative server with special building tools, or a minigame server with custom mobs - vanilla servers hit a hard wall. PowerNukkitX removes that wall.
You own the server. The code is LGPL-3.0 licensed, so you can read it, modify it, and run it however you want. No monthly subscription. No server provider's restrictions. Just you, Java, and full control.
The custom item and block system is where things get interesting. Instead of being locked to vanilla content, you can create entirely new items with custom textures, behaviors, and crafting recipes. Want a lightsaber that deals extra damage to mobs? Custom mob with special AI? A world generator that creates terrain unlike anything vanilla supports? PowerNukkitX can do all of it.
Another real draw is the Vanilla command support. Every single command from the regular Bedrock server works here - nothing proprietary or limited. If you're migrating from a Realms server, your command blocks and automation will port straight over.
Installation and Getting Started
Here's where it gets practical. To run PowerNukkitX, you need Java 21 or newer. (Actually, newer Java versions work too, but the startup flags change - the GitHub repo has start scripts for those, and they're worth grabbing if you're on Java 22+.)
Step one: grab JDK21. The project recommends GraalVM, which is a solid choice. Download it from https://www.graalvm.org/downloads, install it, and make sure java -version shows 21 or later.
Step two: download the JAR file. Head to the releases page and grab powernukkitx.jar. The latest stable version is 2.0.0. Download and save it to a folder where you want your server to run.
Step three: launch it. Open a command prompt or terminal in that folder and run this:
java -jar --add-opens java.base/java.lang=ALL-UNNAMED --add-opens java.base/java.io=ALL-UNNAMED powernukkitx.jarThose --add-opens flags are necessary because PowerNukkitX needs access to some Java internals. First launch takes a bit as it generates the default world and config files. After that, subsequent starts are faster.
On first run, it creates server.properties where you can tweak game rules, world name, difficulty, and other settings. The defaults are reasonable for a survival server. If you want to run a different game mode or create a creative world, edit those files before launching.
The Features That Work
I'll be honest: not every custom feature works equally well. But the standouts are worth using.
Custom Items and Blocks work remarkably well. You define them in JSON files, point to custom textures, and the server handles the rest. Players see them with the right appearance, they stack properly, and you can tie custom behaviors to them - right-click actions, special damage values, anything you can script. I ran a test server with custom ore blocks and a custom pickaxe, and both worked without crashes.
Terra Generator is a world generation system that goes way beyond vanilla. Instead of the standard Minecraft terrain, Terra lets you define custom biomes, heightmaps, and procedural rules. It's complex - you write configuration files that describe how terrain should generate - but the output looks genuinely polished. It's not as fast as vanilla generation (bigger maps take time), but the results justify it.
Mob AI is advanced enough that mobs don't feel braindead. Zombies search for you instead of shambling straight ahead. Skeletons strafe. Spiders navigate terrain intelligently. It's not a revolution, but it's a noticeable step up from vanilla Bedrock mob behavior.
Full Container Support means every block that stores items works: chests, hoppers, barrels, furnaces, brewing stands, everything. The inventory system handles the full Vanilla spectrum of item properties - enchantments, durability, custom data. No half-measures.
One thing to manage: custom content is server-side. Players don't need to install anything to join - the server sends the custom items and blocks to their client automatically. That's a huge advantage over Java Edition mods, where everyone needs the same modpack installed.
Tips, Pitfalls, and What Trips People Up
Startup flags matter. That --add-opens command isn't optional; without it, the server crashes with permission errors. Copy it exactly.
World migration takes work. If you're moving from a Realms world, it's not a one-click import. You need to convert the world format. The documentation walks you through it, but don't expect it to be instant.
Server performance depends on your hardware. PowerNukkitX is efficient, but a server handling 50 players with complex custom content needs more CPU than a vanilla server with 10 players. Start lean, add custom content gradually, and monitor memory usage.
One gotcha: if you're running this on a home internet connection, you'll likely hit bandwidth limits before CPU limits. Bedrock syncs a lot of data, and serving terrain to multiple players adds up. (Actually, that's less a PowerNukkitX issue and more a "home-hosting" issue, but it's worth knowing.)
Backups are your friend. This is basic server ops, but I mention it because custom worlds with custom content are irreplaceable. Set up automated backups. Really.
Other Bedrock Server Options
If you want alternatives, there are a few worth knowing about.
Bedrock Dedicated Server is Microsoft's official solution. It's free, straightforward, but locked to vanilla - no custom content, no mods, just the game as-is. Good if you want reliability and support, annoying if you want to add anything custom.
Geyser is a bridge that lets Java Edition players join Bedrock servers. It's a proxy, not a full server, but if you're running PowerNukkitX and want cross-edition play, Geyser is the right tool. Many servers run both in tandem.
Nukkit (the original) is still maintained but less active than PowerNukkitX. If you prefer an older codebase or specific plugins written for original Nukkit, it exists - but PowerNukkitX is the better choice for new projects.
Before You Install
Make sure your server setup aligns with what you need. PowerNukkitX is powerful, but it's not a hosting provider - you're responsible for keeping the process running, backing up data, and managing resources.
If you're building a server and want your players to show up with custom skins, you might check out the Minecraft Skin Creator to design unique looks for your community. And if you're setting up server voting rewards, the Minecraft Votifier Tester is invaluable for debugging vote integration.
Documentation is solid at https://docs.powernukkitx.org. The Discord server is active, and the maintainers are responsive. If you run into issues, you've got real humans to turn to - not just AI documentation.
Lead writer at minecraft.how. Long-time Minecraft player running a small SMP server, testing every build, mod, and seed before writing about it.


