https://github.com/Open-GD/OpenGD
Open source implementation of Geometry Dash powered by a fork of cocos2dx 4.0.
https://github.com/Open-GD/OpenGD
axmol axmolengine cocos2d cocos2d-x cpp geometry-dash geometrydash reverse-engineering
Last synced: 2 months ago
JSON representation
Open source implementation of Geometry Dash powered by a fork of cocos2dx 4.0.
- Host: GitHub
- URL: https://github.com/Open-GD/OpenGD
- Owner: Open-GD
- License: gpl-3.0
- Created: 2023-02-24T15:56:23.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2025-02-09T21:40:23.000Z (4 months ago)
- Last Synced: 2025-03-23T23:20:44.428Z (2 months ago)
- Topics: axmol, axmolengine, cocos2d, cocos2d-x, cpp, geometry-dash, geometrydash, reverse-engineering
- Language: C++
- Homepage:
- Size: 9.23 MB
- Stars: 192
- Watchers: 8
- Forks: 38
- Open Issues: 9
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-geometry-dash - OpenGD - Open source implementation of GD powered by a fork of cocos2dx 4.0. (Other)
README




![]()
![]()
OpenGD
Open source implementation of Geometry Dash

Report Bug
·
Latest Release
·
Request Feature
# UNMAINTAINED
new (unfinished) projects are [gdrender](https://github.com/maxnut/gdrender) and [gdclone](https://github.com/opstic/gdclone)## About The Project

OpenGD is an open-source implementation of the popular game Geometry Dash. Our main goal is to remake the gameplay 1:1, while also improving performance through new engine features and C++ enhancements. We also plan to implement multithreading in the future.
## Status
We are currently rewriting the gameplay from the ground up, **levels are not playable at the moment**.
### Built With
OpenGD is powered by [axmol](https://github.com/axmolengine/axmol), which is maintained a fork of cocos2dx 4.0 that adds many new features and improvements over the original cocos2dx. The original Geometry Dash is also made with cocos2dx, but with a much older version from 2014.
## Build instructions
Required:
- Powershell
- CMake
- C++20 Compiler (MSVC, clang or gcc)Windows
### Quick start
Clone axmol, run setup.ps1 and restart cmd for command line variables to update
```
git clone https://github.com/axmolengine/axmol
cd axmol
./setup.ps1
```In the OpenGD folder, build with cmake as usual
```
cmake -B build_x64
cmake --build build_x64 --config RelWithDebInfo
```> **Warning**
> VS 2019 might not work on Windows, VS 2022 is recommended### Recommended setup: VSCode
Required:
- Ninja
- clang (llvm)
- cmake-tools extension
- c/c++ extensionRecommended: [sccache](https://github.com/mozilla/sccache) (faster re-builds)
Make sure ninja and clang are on path!
From cmake-tools select configuration `Ninja default` or `Ninja sccache`, then build with cmake-tools or `cmake --build build`.
The VSCode setup provides support for intellisense and debugger (requires vs2022)
Other platforms
Check axmol [Dev setup](https://github.com/axmolengine/axmol/blob/dev/docs/DevSetup.md)To actually run the game you will need the resources from the 2.2/2.1 version of Geometry Dash.
## License
Distributed under the GPL v3 License . See `LICENSE` for more information.
## Credits
* [axmol](https://github.com/axmolengine/axmol) a fork of cocos2d-x-4.0
* [GD 1.0 decomps](https://github.com/Wyliemaster/Geometry-Dash-1.0) by Wylie
* [GD Physics decomps](https://github.com/camila314/gdp) by Camila
* [GD 2.1 decomps](https://github.com/matcool/gd-decomps) by mat
* [hps](https://github.com/jl2922/hps) high performance C++11 serialization library
* [gdclone](https://github.com/opstic/gdclone) another gd reconstruction project### Contributors
This project exists thanks to all the people who have contributed: