MC2GD is a desktop application written in Python with a graphical interface designed to automatically convert 3D structures from Minecraft into 2D levels for Geometry Dash.
The program reads data from region files (.mca), extracts blocks from a specified Z-layer, and generates a .gmd file ready for import into the game editor.
- Automatic Parsing: Reads Minecraft worlds without manual export.
- Side View (2D): Selects a specific Z-layer to create a flat level.
- Flexible Settings: Adjustable chunk scanning radius.
- Drag and Drop: Drag and drop the world folder directly into the window.
- Threaded Processing: Conversion runs in a separate thread (UI does not freeze).
- Data Validation: Level name validation (max 20 characters, English only).
Minecraft 1.12.2 is strictly required for this tool to work correctly.
Using newer or older versions may result in errors due to changes in world saving formats (e.g., the Tag Level does not exist error or missing block IDs). The block mapping table is built specifically for the numeric IDs used in 1.12.2.
| Minecraft Block | MC ID | Geometry Dash Object | GD ID |
|---|---|---|---|
| Oak Planks | 5 | Normal Block | 1 |
| Grass Block | 2 | Spike | 8 |
| Stone | 1 | Normal Block | 1 |
| Oak Door | 64 | Ship (Plane) | 13 |
| Iron Door | 71 | Normal Cube | 12 |
| Oak Stairs | 53 | Yellow Orb | 36 |
| Oak Slab | 126 | Yellow Pad | 35 |
- Download the ready-to-use MC2GD.exe from the Releases section.
- Run the program (Python installation is not required). tutorial: https://www.youtube.com/watch?v=CHkHoaQoQJo
- Install Python 3.10+.
- Install the dependencies:
pip install anvil-parser2 tkinterdnd2
- Run the script:
python mc2gd.py
-
Build your structure in Minecraft 1.12.2.
-
Save the world and exit the game.
-
Launch MC2GD.exe.
-
Drag the world save folder (where level.dat is located) into the program window.
-
Specify the Z-layer and the chunk radius.
-
Click CONVERT. A .gmd file will appear on your desktop.
-
In Geometry Dash, select Create -> Import and choose that file.
-
Specify the Z-layer and the chunk radius:
- In Minecraft, stand right in front of your build.
- Press F3 (or Fn+F3) to open the debug screen.
- Look at the third number (Z coordinate).
- Enter that number into the "Z Layers" field in the program (e.g.,
-6). - If your build has depth, enter multiple layers separated by commas (e.g.,
-6, -5, -4). - Click CONVERT. A
.gmdfile will appear on your desktop. - "For Linux users: run python3 mc2gd.py. You need Python 3.10+, anvil-parser2, and tkinterdnd2 (or use the 'Select Folder' button instead of Drag & Drop).
- Status: The project is in active development. The public release is scheduled for 15.11.26.
- The program scans only one selected Z-layer at a time.
- Blocks are scaled at 1 block = 30 pixels.
- Complex blocks (glass, redstone, etc.) are not supported yet.
Developer: FGNgd (MasiGDPS Team). This is a fan project and is not affiliated with RobTop Games or Mojang. This project is inspired by GD Colon's MC2GD, but is an independent implementation in Python with a GUI.