Skip to content

About

A Python tool that converts Minecraft 1.12.2 worlds into Geometry Dash levels (.gmd).

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

9 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 

Repository files navigation

MC2GD (Minecraft to Geometry Dash)

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.

Features

  • 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).

IMPORTANT: Minecraft Version

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.

Block Conversion Table

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

Installation and Usage

For regular users (Windows)

  1. Download the ready-to-use MC2GD.exe from the Releases section.
  2. Run the program (Python installation is not required). tutorial: https://www.youtube.com/watch?v=CHkHoaQoQJo

For developers (from source)

  1. Install Python 3.10+.
  2. Install the dependencies:

pip install anvil-parser2 tkinterdnd2

  1. Run the script:

python mc2gd.py

How to Use

  1. Build your structure in Minecraft 1.12.2.

  2. Save the world and exit the game.

  3. Launch MC2GD.exe.

  4. Drag the world save folder (where level.dat is located) into the program window.

  5. Specify the Z-layer and the chunk radius.

  6. Click CONVERT. A .gmd file will appear on your desktop.

  7. In Geometry Dash, select Create -> Import and choose that file.

  8. 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 .gmd file 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).

Limitations and Status

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

Credits

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.

About

A Python tool that converts Minecraft 1.12.2 worlds into Geometry Dash levels (.gmd).

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages