Skip to content
Skip to content
Back to Blog
PowerNukkitX server configuration interface showing custom items and settings

PowerNukkitX: Build and Host Your Own Minecraft Bedrock Server

Alexandru Maftei
Alexandru Maftei
@ice
Updated
1,953 views
TL;DR:PowerNukkitX is an open-source Java server for Minecraft: Bedrock Edition that lets you host custom servers with unique items, blocks, and mob AI. Perfect for communities wanting full control without monthly subscriptions.
🐙 Open-source Minecraft project

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.

⭐ 623 stars💻 Java📜 LGPL-3.0
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:

bash
java -jar --add-opens java.base/java.lang=ALL-UNNAMED --add-opens java.base/java.io=ALL-UNNAMED powernukkitx.jar

Those --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.

About the author
Alexandru Maftei
Alexandru MafteiLead Writer

Lead writer at minecraft.how. Long-time Minecraft player running a small SMP server, testing every build, mod, and seed before writing about it.

Share with your friends!

Frequently Asked Questions

Is PowerNukkitX legal to use and host a public server?
Yes. PowerNukkitX is open-source under the LGPL-3.0 license, which allows you to run, modify, and commercialize servers built on it (with proper attribution). It's not affiliated with Mojang, but it doesn't violate Minecraft Terms of Service for operating a Bedrock server. Check Minecraft's EULA periodically for updates.
Does PowerNukkitX support cross-platform play between Java and Bedrock players?
Not natively. PowerNukkitX is Bedrock-only, so it connects Windows, mobile, and console Bedrock players. To bridge Java and Bedrock editions, you'll need Geyser as a proxy running alongside PowerNukkitX. Many communities successfully run both together.
What are the minimum system requirements to run PowerNukkitX?
You need Java 21+ and sufficient RAM. For small servers (5-10 players, vanilla content), 2-4GB RAM works. With custom items, mobs, and more players, expect 4-8GB. CPU isn't the bottleneck; bandwidth and storage matter more for home hosting.
Can I use Nukkit plugins and addons with PowerNukkitX?
Some. PowerNukkitX maintains API compatibility with certain Nukkit plugins, but not all. Check the plugin's documentation - if it supports PowerNukkitX, it'll work. The Discord and forums list verified plugins. Don't assume legacy plugins will load without testing.
How do I back up my PowerNukkitX world?
Backups are file-based. Shut down the server, then copy the 'worlds' folder to a safe location. Use automated backup scripts for daily backups. For data integrity, always back up while the server is stopped. No special tools needed.

Comments

No comments yet. Be the first to share your thoughts!

We use cookies to improve your experience. By continuing to use this site, you agree to our use of cookies. Read our Privacy Policy