Java2Nukkit World Converter
github.com
What it is
Java2Nukkit World Converter changes Minecraft Java Edition 1.15.2 anvil worlds into Nukkit’s anvil world format. It runs from a terminal with a Java JAR and source and destination world directories, and requires Java 1.8 or newer. Source worlds must be optimized using Minecraft 1.15.2; other versions or unoptimized worlds may convert incorrectly or crash. The converter can also be used as a Kotlin or Java library, though its API is described as having no customizations. The API can select regions for conversion; without a changed filter, it converts everything. Conversion supports only the overworld. Entities are not carried over except item frames, and unsupported blocks or items may be replaced or removed. Custom player heads are skipped by default, with an option to keep them as regular Steve heads. The MIT-licensed software is free, but provided without warranty. It runs on Linux, macOS, and Windows.
Spec sheet
- What it does
- Converts Minecraft Java Edition 1.15.2 Anvil worlds into Nukkit Anvil world format.Read 15 Oct 2026 · github.com
- Purpose
- Converts Minecraft 1.15.2 Java Edition anvil worlds to Nukkit's anvil world format.Read 30 Sep 2026 · github.com
- Support
- Users are directed to open a GitHub issue for questions, which the README says will be replied to soon.Read 30 Sep 2026 · github.com
- License
- The MIT license grants use, copying, modification, publishing, distribution, sublicensing, and sale free of charge.Read 30 Sep 2026 · github.com
- API maturity
- The README describes the API as very simple and says it does not currently allow customizations.Read 15 Oct 2026 · github.com
- Build process
- Linux users build with ./gradlew build and Windows users with gradlew.bat build; the CLI JAR is placed in build/libs.Read 15 Oct 2026 · github.com
- Changelog: PowerNukkit output
- The unreleased changelog lists a PowerNukkit save-format target enabled with --target powernukkit.Read 15 Oct 2026 · raw.githubusercontent.com
- Changelog: version 3.0.0
- The 3.0.0 release dated January 25, 2020 added mappings for Minecraft Java Edition 1.15 items and blocks.Read 15 Oct 2026 · raw.githubusercontent.com
- Cloudburst downloads
- The Cloudburst listing reports 11,122 downloads.Read 15 Oct 2026 · cloudburstmc.org
- Cloudburst listing author
- The independent Cloudburst resource listing identifies joserobjr as the author.Read 15 Oct 2026 · cloudburstmc.org
- Cloudburst listing date
- Cloudburst lists the resource creation date as May 26, 2019.Read 15 Oct 2026 · cloudburstmc.org
- Cloudburst release history
- Cloudburst lists the first release as May 26, 2019 and the last update as January 25, 2020.Read 15 Oct 2026 · cloudburstmc.org
- Cloudburst views
- The Cloudburst listing reports 14,800 views.Read 15 Oct 2026 · cloudburstmc.org
- Command line
- Runs from a terminal with a Java JAR and source and destination world directories.Read 30 Sep 2026 · github.com
- Command-line use
- The converter runs from a terminal with a Java JAR and source and destination world directories.Read 15 Oct 2026 · github.com
- Compatibility handling
- Unsupported blocks and items are replaced or removed because of Bedrock Edition or Nukkit limitations.Read 30 Sep 2026 · github.com
- Custom-head handling
- Custom player heads are skipped by default, with an option to convert them as ordinary Steve heads.Read 15 Oct 2026 · raw.githubusercontent.com
- Dependency distribution
- The library is shared through JCenter with dependencies from SpigotMC and the orangy Maven repository.Read 30 Sep 2026 · github.com
- Dependency publication
- Version 3.0.0 is published under the br.com.gamemods group and is shown with JCenter, Gradle, Maven and Ivy dependency examples.Read 15 Oct 2026 · github.com
- Dimension handling
- Only the overworld is supported; Nether and The End are excluded.Read 15 Oct 2026 · raw.githubusercontent.com
- Dimension limit
- Only overworld dimensions are supported; Nether and The End are not converted.Read 30 Sep 2026 · github.com
- Dropped-item limitation
- Converted dropped items lose their Owner and Thrower tags because Java and Bedrock accounts differ.Read 15 Oct 2026 · raw.githubusercontent.com
- Entity handling
- Entities are not converted except item frames, which are treated as blocks in Bedrock.Read 15 Oct 2026 · raw.githubusercontent.com
- Head handling
- Custom player heads are skipped by default and can be retained as regular Steve heads with the keep-custom-heads option or skipSkinHeads setting.Read 30 Sep 2026 · github.com
- Java requirement
- Java 1.8 or newer is required.Read 15 Oct 2026 · github.com
- Language support
- The library API is documented for both Kotlin and Java.Read 15 Oct 2026 · github.com
- Library API
- Can be used as a library from Kotlin or Java, although its API is described as having no customizations.Read 30 Sep 2026 · github.com
- Library use
- The converter can be embedded as a library rather than used only as a CLI.Read 15 Oct 2026 · github.com
- Licence
- The repository distributes the tool under the MIT License.Read 15 Oct 2026 · github.com
- Limit: conversion errors
- Cloudburst reviewers reported NBT-converter errors and an unexpected chunk-section-version failure during conversion.Read 15 Oct 2026 · cloudburstmc.org
- Limit: large maps
- Cloudburst reviewers reported problems with larger pre-generated maps and maps above roughly 4k by 4k or 5k dimensions.Read 15 Oct 2026 · cloudburstmc.org
- Limit: slab orientation
- A GitHub issue reported some top slabs becoming bottom slabs; the issue was marked resolved.Read 15 Oct 2026 · github.com
- Maker identity
- PowerNukkit is a verified GitHub organization controlling the powernukkit.org domain.Read 15 Oct 2026 · github.com
- Maker scope
- The PowerNukkit organization describes its main project as a Nukkit fork supporting new Minecraft Bedrock features.Read 15 Oct 2026 · github.com
- Mapping quality
- The documentation says many mappings were made manually and may contain human errors.Read 15 Oct 2026 · github.com
- Nukkit limitation
- Pistons lose their heads and do not work after conversion.Read 15 Oct 2026 · raw.githubusercontent.com
- Potion limitation
- Potion effects are currently converted as water potions.Read 15 Oct 2026 · raw.githubusercontent.com
- Praise: basic maps
- A Cloudburst reviewer said it worked well for basic maps and recommended it for small maps.Read 15 Oct 2026 · cloudburstmc.org
- Rating on Cloudburst
- 2.71 out of 5 from 7 reviewsRead 15 Oct 2026 · cloudburstmc.org
- Region selection
- The API supports filtering conversion to selected regions, which is useful for debugging.Read 15 Oct 2026 · github.com
- Replacement behavior
- Unsupported content can be removed or substituted; examples include spruce, birch, jungle, acacia and dark-oak signs becoming oak signs.Read 15 Oct 2026 · github.com
- Support channel
- Questions are directed to GitHub issues, which the README says will be flagged and answered.Read 15 Oct 2026 · github.com
- Supported operating systems
- The project says it works on Windows, Linux, Mac OS and other Java-supported platforms.Read 15 Oct 2026 · github.com
- Unsupported entities
- No entities are converted except item frames, which are blocks in Bedrock Edition.Read 30 Sep 2026 · github.com
- Version limitation
- Other Minecraft versions and unoptimized worlds can produce incorrect conversions or crashes.Read 15 Oct 2026 · github.com
- Warranty
- The project disclaims warranty and responsibility for damage caused by the tool.Read 15 Oct 2026 · github.com
- World preparation
- Source worlds must be optimized with Minecraft 1.15.2 before conversion.Read 15 Oct 2026 · github.com
- World requirement
- Source worlds must be optimized using Minecraft 1.15.2; other versions or unoptimized worlds may convert incorrectly or crash.Read 30 Sep 2026 · github.com
Plans and prices
Strong points and limits
Strong points
- Free under the MIT license.
- Can convert selected regions through its API.
- Runs on Linux, macOS, and Windows.
Limits
- Requires optimized Minecraft 1.15.2 worlds.
- Does not convert Nether or The End.
- Most entities are not converted.
- Provided without warranty.
Who it suits
This tool suits users converting optimized Minecraft Java Edition 1.15.2 worlds to Nukkit format, including developers using Kotlin or Java. It is not for converting other source versions or dimensions.
Java2Nukkit World Converter in depth
Read the full write-up
Java2Nukkit World Converter moves Minecraft Java Edition 1.15.2 worlds into Nukkit’s anvil format. It is best for Java- or Kotlin-comfortable users with an optimized overworld to migrate. Choose it only when its precise source-version requirement and conversion losses fit the job.
Overview
The converter runs as a Java JAR from a terminal, taking source and destination world directories; Java 1.8 or newer is required. Source worlds must be optimized using Minecraft 1.15.2. Other versions or unoptimized worlds may convert incorrectly or crash, making compatibility a prerequisite rather than a detail to check later.
Conversion covers the overworld only, so Nether and The End content is left behind. Entities are not converted except item frames, which count as blocks in Bedrock Edition. Unsupported blocks and items may be replaced or removed for Bedrock or Nukkit compatibility. Custom player heads are skipped by default; the keep-custom-heads option or skipSkinHeads setting retains them as ordinary Steve heads, not with their custom appearance.
Key features
Terminal workflow and developer library
The directory-based command-line workflow suits users comfortable running Java tools. Java and Kotlin developers can instead use the library, but its API offers no customizations. It does support selecting regions for conversion; leaving the filter unchanged converts everything. Dependencies are distributed through JCenter, with dependencies from SpigotMC and the orangy Maven repository, which developers need to account for in their build setup.
Format conversion, not broad migration
The tool changes the world format from Minecraft Java Edition 1.15.2 to Nukkit Anvil; it does not convert between Java and Bedrock editions or convert world versions. Its value is therefore specific: a compatible 1.15.2 world headed to Nukkit, not a general route between Minecraft editions or releases.
Pricing
The MIT-licensed software plan costs nothing. It includes the converter for optimized Minecraft Java Edition 1.15.2 worlds, with Java 1.8 or newer required. The MIT license permits use, copying, modification, publishing, distribution, sublicensing, and sale at no charge, so there is no paid tier to weigh against the conversion limits.
The software is provided as-is without warranty, and the project disclaims responsibility for damage caused by the tool. Questions are directed to GitHub issues, which the README says will be replied to soon.
Platforms
The converter supports Linux, macOS, and Windows. On each, users need a Java 1.8-or-newer runtime and a terminal workflow; it is not a web conversion service.
Who it's for
This is a practical fit for administrators or developers moving an optimized 1.15.2 overworld into Nukkit, especially when region selection or library use is useful. It is a poor choice for worlds from other versions, unoptimized saves, projects that need Nether or End dimensions, or builds where entities and custom head appearance must survive intact.
Pros and cons
Pros: Free under a permissive MIT license, with Linux, macOS, and Windows support, and both terminal and Java/Kotlin library workflows.
Pros: Region selection in the API can limit conversion to chosen areas; leaving the filter unchanged handles the whole world.
Cons: Only optimized Minecraft Java Edition 1.15.2 source worlds are in scope; other versions or unoptimized worlds can fail or produce incorrect results.
Cons: Only overworld dimensions are supported, and entities are not preserved apart from item frames.
Cons: Unsupported blocks and items may be replaced or removed, while custom heads can only be retained as regular Steve heads.
Cons: The library API has no customizations, and the software comes without warranty.
Alternatives
For version migration rather than changing to Nukkit’s format, consider MC Version Converter: it is free, runs on Linux, macOS, and Windows, and converts Java Edition 26.x worlds to versions 1.18.2–1.21.11, built from Rust source code.
Chunker is another free, open-source option; choose it when its broader tool fit is preferable to this converter’s tightly bounded 1.15.2-to-Nukkit workflow.
Bridger is free and open source, with code, issue reporting, and development hosted through GitHub; it is an alternative to consider if that project model suits your needs.
LCEStudio is a free, MIT-licensed option for Windows users. LegacyEditor is free and supports Linux, macOS, and Windows.
WorldSwitch suits browser-based conversion: its free Mini tier handles uploaded files up to 70 MB without sign-up, while larger files start with a €1.99, paid once Small conversion for 71–300 MB.
LCE2JE is a free option for Linux and Windows users. For browser-based Java and Bedrock world conversion, Server to Singleplayer World Converter offers a free plan.
For more options, browse Minecraft World Converters.
Verdict
Use Java2Nukkit World Converter when you have an optimized Minecraft Java Edition 1.15.2 overworld and specifically need Nukkit Anvil output. Its free, cross-platform Java workflow is straightforward in scope, but the strict source requirement and losses to dimensions, entities, and unsupported content make another converter the safer choice for broader migrations.
Verdict
The converter has a narrow format and source-version scope, with significant limits on dimensions and entities. Check world requirements and unsupported content before relying on the conversion.
Where Specifiction places it
- Minecraft World Converters#3 of 188.8