MC-Unified | The All-in-One Minecraft Edition Unifier

License: MIT Gc.idk (Gc1dk)

MC-Unified solves ALL 4 major Minecraft edition problems in a single program with zero external dependencies (Python 3.7+ standard library only).

---

The 4 Problems It Solves

#	Problem	Solution
1	Java Edition lacks cross-platform play and mobile support	Bridge Server - protocol translation between Java (varint/TCP) and Bedrock (RakNet/UDP)
2	Bedrock Edition lacks deep modding and Java-specific features	Mod Translator + Shared Modding API - write once, deploy everywhere
3	Education Edition lacks unrestricted customization and cross-play	Skin Unlocker + Feature Restorer + Cross-Play Enabler
4	No unified "all-in-one" modding and cross-play system	Unified Launcher combines all solutions into one interface

Quick Start

# Windows: just double-click run.bat
# Or run from the command line:
python main.py              # Interactive mode
python main.py --bridge     # Start cross-play server (Java:25565, Bedrock:19132)
python main.py --unlock     # Unlock Education Edition
python main.py --detect     # Detect installed editions

Features

Cross-Platform Play (Problem 1)

• Java <-> Bedrock protocol translation (varint, RakNet, packet mapping)
• Block, entity, item, biome, and inventory mapping between editions
• Chat relay, player join/leave events, server management
• No mods needed on clients

Cross-Edition Modding (Problem 2)

• Translate .jar Java mods (Fabric/Forge/Quilt) to Bedrock .mcpack
• Translate Bedrock behavior packs to Java Fabric mods
• SharedModdingAPI: define blocks/items/recipes once, export for all 3 editions
• Parses manifest.json, fabric.mod.json, mods.toml, mcmod.info

Education Edition Unlocking (Problem 3)

• Custom skin packs with custom geometry (bypasses skin restrictions)
• Restores removed biomes (nether forests, mushroom fields, bamboo jungle)
• Restores structures (nether fortress, bastion, mineshaft)
• Restores gameplay (PvP, explosions, redstone, brewing, enchanting)
• Cross-play compatibility checking + command translation between editions

Unified System (Problem 4)

• Interactive CLI + full Python API
• Edition detection (Java, Bedrock, Education)
• Configuration manager with validation
• Single launcher that orchestrates everything

Folder Structure

MC-Unified/
├── main.py                 <- Entry point (run this)
├── run.bat / run.ps1       <- One-click launchers
├── Examples.md             <- Full usage guide
├── bridge/                 <- Protocol translation + cross-play server
├── modding/                <- Mod parsing + translation + shared API
├── education/              <- Education unlocker + feature restorer
├── unifier/                <- All-in-one launcher + config + detection
└── LICENSE                 <- MIT Gc.idk (Gc1dk)

Example (Write Once, Deploy Everywhere)

from modding.shared_api import SharedModdingAPI

api = SharedModdingAPI()
api.set_mod_info(mod_id="mymod", mod_name="My Mod", version="1.0.0")

api.block("mymod:crystal_block", display_name="Crystal Block", hardness=2.0, light_level=10)
api.item("mymod:crystal_shard", display_name="Crystal Shard", max_stack=64)
api.recipe("crystal_from_shards",
    recipe_type="crafting_shaped",
    pattern=["SSS", "S S", " S "],
    key={"S": "mymod:crystal_shard"},
    result="mymod:crystal_block",
    result_count=1,
)

# Generates: my_mod_java/ + my_mod_bedrock/ + my_mod_education/
api.export_all_editions("./output")

Requirements

• Python 3.7+ (no external packages needed)
• Windows, macOS, or Linux
• gh CLI only needed for repo management, not for running

License

MIT Gc.idk (Gc1dk) - Free to use, modify, and distribute.