MC Version Converter
github.com
What it is
MC Version Converter is a free command-line tool for converting Minecraft: Java Edition worlds saved in version 26.1 or later so versions 1.18.2 through 1.21.11 can open them. It is distributed as source code, so users need Rust and must build it with `cargo build --release` on Linux, macOS, or Windows. Batch mode processes each world folder in `input_worlds/` and writes results to separate folders in `output_worlds/`; the original world is not modified. When converting for older targets, the tool reverses legacy formats for items, entity equipment, attributes, signs, and player bed respawns, among other changes. Versions 1.17.x and earlier are unsupported because their world height differs from newer versions. Content introduced in 26.x may be lost, and blocks without a target-version equivalent may be replaced with air when a target block allowlist is supplied. Some data without a legacy equivalent is dropped, and oversized `.mcc` chunk files are copied without conversion. Corrupt region, POI, or chunk files are skipped with a warning. The project is unofficial and MIT-licensed.
Spec sheet
- Purpose
- Converts Minecraft: Java Edition worlds saved in 26.1 or later into a structure older versions can open.Read 30 Sep 2026 · github.com
- Platforms
- The mcconvert CLI works on Linux and macOS, and the documented run.bat workflow is for Windows.Read 30 Sep 2026 · github.com
- Integrations
- The README documents no integrations; it describes a local command-line tool built with Rust.Read 29 Sep 2026 · github.com
- Support
- The opened project page documents command-line usage, error codes, and known limitations; it does not state a support service or response commitment.Read 30 Sep 2026 · github.com
- License
- The repository is licensed under the MIT License.Read 29 Sep 2026 · github.com
- Affiliation
- The README describes the tool as unofficial and says it is not affiliated with Mojang or Microsoft.Read 29 Sep 2026 · github.com
- Batch conversion
- The batch command converts all eligible world folders in input_worlds into separate output folders in output_worlds.Read 30 Sep 2026 · github.com
- Block handling
- Blocks unavailable in the target version can be replaced with air when a target-version block allowlist is supplied; without it, replacement is skipped.Read 30 Sep 2026 · github.com
- Build and distribution
- The tool is distributed as source code and users build it with Rust using `cargo build --release`.Read 29 Sep 2026 · github.com
- Compatibility limit
- Versions 1.17.x and earlier are unsupported because their world height differs from newer versions.Read 29 Sep 2026 · github.com
- Conversion direction
- Converting older worlds to newer versions is described as a future direction.Read 30 Sep 2026 · github.com
- Conversion features
- For older target versions, the converter reverses legacy item, entity equipment, attribute, sign text, and player bed respawn formats, among other changes.Read 29 Sep 2026 · github.com
- Data loss
- Unsupported blocks, items, mobs, and data without a legacy equivalent may be lost or dropped during conversion.Read 30 Sep 2026 · github.com
- Failure handling
- Corrupt region, POI, or chunk files are skipped with a warning instead of stopping the conversion.Read 29 Sep 2026 · github.com
- Features
- It reverses legacy world, item, entity, attribute, sign, and player respawn data formats when required by the target version.Read 30 Sep 2026 · github.com
- Installation
- The tool is distributed as source code and requires building with Rust using cargo build --release.Read 30 Sep 2026 · github.com
- License and credits
- The repository identifies an MIT license and credits Claude for assistance with development and reverse-engineering.Read 30 Sep 2026 · github.com
- Limitations
- Versions 1.17.x and older are unsupported because their world height differs from newer versions.Read 30 Sep 2026 · github.com
- Original files
- The README says the original world is never modified and conversion results are written to a new folder.Read 29 Sep 2026 · github.com
- Other limitations
- The README says some 26.x data with no legacy equivalent is dropped, and oversized `.mcc` chunk files are copied without conversion.Read 29 Sep 2026 · github.com
- Security and affiliation
- The page calls the tool unofficial and says it is not affiliated with Mojang or Microsoft.Read 30 Sep 2026 · github.com
- Supported targets
- It supports conversion to Minecraft versions 1.21.11 down to 1.18.2.Read 30 Sep 2026 · github.com
- World safety
- The original world is never modified; conversions are written to a new folder.Read 30 Sep 2026 · github.com
Plans and prices
Strong points and limits
Strong points
- Leaves original world files unchanged
- Batch conversion writes results to separate folders
- Supports targets from 1.18.2 through 1.21.11
- Skips corrupt files with a warning
- Licensed under MIT
Limits
- Requires building from source with Rust
- Versions 1.17.x and earlier are unsupported
- Some 26.x content may be lost
- Oversized `.mcc` chunks are copied without conversion
Who it suits
This tool suits Minecraft: Java Edition players who need to move worlds from 26.1 or later into versions 1.18.2 through 1.21.11. It is for users comfortable building and running a Rust command-line utility.
MC Version Converter in depth
Read the full write-up
MC Version Converter is a free command-line utility for moving Minecraft: Java Edition worlds from newer releases to supported older ones. It suits players who can build Rust software and need a world an older client can open. The separate-output workflow is reassuring, but version limits and possible loss of newer content make this a narrowly useful converter.
Overview
The tool converts worlds saved in Java Edition 26.1 or later for use with versions 1.18.2 through 1.21.11. It reverses changes to legacy world, item, entity, attribute, sign, and player respawn data formats when the destination needs them. This is useful for taking a newer world back to a supported release, not for upgrading an older world: conversion in that direction is only a future aim. It also does not convert Java worlds to Bedrock.
MC Version Converter runs locally as a command-line tool and is distributed as source code. Building it requires Rust and cargo build --release, so it avoids a software price but asks users to handle compilation themselves. That trade-off suits technically confident players better than anyone looking for a ready-to-run app or graphical workflow.
Key features
Batch conversion and separate outputs
Batch mode processes each world folder in input_worlds/ and puts the results in separate folders under output_worlds/. This is convenient for repeated downgrades, and keeping results apart from source worlds reduces the risk of overwriting a world. The README says the original is never modified.
Legacy-format handling
When required by the destination version, the converter reverses changes to items, entity equipment, attributes, sign text, and player bed respawn data, among other formats. This targeted repair is the reason to choose it over a simple folder copy. It does not guarantee full fidelity: data introduced in 26.x without a legacy equivalent is dropped, and blocks, items, or mobs added in 26.x may be lost. Blocks with no equivalent can become air when a target-version block allowlist is supplied; without an allowlist, that replacement is skipped.
Failure handling and boundaries
Corrupt region, POI, or chunk files are skipped with a warning rather than stopping the whole conversion, which can let a batch continue but leaves affected content unconverted. Oversized .mcc chunk files are copied without conversion. Versions 1.17.x and earlier are unsupported because their world height differs from newer versions, so this tool cannot bridge to those older releases.
Pricing
MC Version Converter is free: its source-code plan costs nothing and includes conversion of Java Edition 26.x worlds to versions 1.18.2–1.21.11. There is no free trial because the software is already free. The main cost is practical rather than monetary: users need Rust and must build the program themselves. The repository uses the MIT License.
Platforms
The tool supports Linux, macOS, and Windows. It is a local command-line program, not a browser service, and the documented workflow is built around Rust compilation. The project page covers command-line use, error codes, and known limitations; it does not promise a support service or response time.
Who it's for
This is a good fit for Java Edition players who need to move a 26.1-or-later world back to a supported version, can compile Rust software, and are willing to accept that newer content may not survive intact. It is a poor fit for players needing an earlier-than-1.18.2 target, an older-to-newer conversion, Java-to-Bedrock conversion, or a packaged graphical application. The project describes itself as unofficial and unaffiliated with Mojang or Microsoft.
Pros and cons
Pros
Free and MIT-licensed, with builds for Linux, macOS, and Windows.
Preserves the source world by writing conversions to new folders.
Batch mode and legacy-format reversals address repeated, targeted downgrades.
Corrupt files trigger warnings and are skipped instead of halting a conversion.
Cons
Source distribution requires Rust and a manual release build, adding setup work.
Only newer-to-older conversion is supported, with targets limited to 1.18.2–1.21.11.
Newer blocks, items, mobs, and data without legacy equivalents can be lost or dropped.
Oversized .mcc chunks are copied without conversion, and corrupt files are left unconverted.
Alternatives
For a Java-to-Nukkit conversion centered on Minecraft Java Edition 1.15.2 worlds, consider Java2Nukkit World Converter; it is free and supports Linux, macOS, and Windows, but requires optimized worlds and Java 1.8 or later.
Chunker, Bridger, LCEStudio, and LegacyEditor are other free converter options to compare.
Choose WorldSwitch if a browser-based conversion suits you better: its free Mini plan handles uploaded files up to 70 MB per conversion, with larger files on paid per-conversion plans.
LCE2JE is another free option for Linux and Windows users.
Server to Singleplayer World Converter is a free browser-based option for Java and Bedrock world conversion.
See the Minecraft World Converters list for more options.
Verdict
Choose MC Version Converter if you need to bring a Java Edition 26.1-or-later world back to versions 1.18.2–1.21.11, want to keep the original untouched, and are comfortable building from Rust source. Look elsewhere if you need a broader conversion direction, an earlier target, a graphical app, or confidence that newer world content will remain intact.
Verdict
MC Version Converter addresses a specific direction of Minecraft world conversion and keeps the original world intact. Building from source and possible loss of newer content are important limits, and earlier target versions are unsupported.
Where Specifiction places it
- Minecraft World Converters#5 of 188.3