OpenHack/README.md

Deprecation Notice!

This repository is no longer maintained. Please consider using Eclipse Menu instead, which is a more up-to-date and feature-rich mod for Geometry Dash.

Latest Geometry Dash version supported by OpenHack is 2.204.

OpenHack

A free and open source collection of hacks for Geometry Dash 2.2 with many features, including noclip, speedhack, startpos switcher, and more!

Table of Contents

• About
• Features
• Installation
  • Geode
  • Vanilla
• Building
• Contributing
• License
• Contact
• Support
• Acknowledgements

About

Yet another Geometry Dash modded client! Has almost everything you'll need, with features being constantly added.

Please visit the issues page for known issues and planned features (and feel free to leave your own suggestions).

Features

• Customizable GUI with a variety of settings and themes.
• Noclip, speedhack, and other popular hacks.
• StartPos Switcher
• Show Hitboxes
• Replay Bot
• Customizable keybinds
• Discord Rich Presence
• Automatic updates
• And more!

Installation

Note: OpenHack is only compatible with Windows (also Linux and macOS, if you're using Proton/Wine to run Geometry Dash). Other operating systems are not supported for now.

There are two ways to install OpenHack: using Geode, or manually installing the mod. Each method has its own advantages and disadvantages, so choose the one that best suits your needs.

Geode

1. Find "OpenHack" in the Geode mod list.
2. Click the "Install" button to install the mod.
3. Restart the game, and press "Tab" to open the mod menu.

You can also install the mod manually by downloading the latest .geode release from the releases page.

Vanilla

1. Download the latest .zip release from the releases page.
2. Extract everything from the .zip file to your Geometry Dash folder. (Right click on Geometry Dash in your Steam library, and select "Manage" -> "Browse local files")
3. Run the game, and press "Tab" to open the mod menu.

Extra steps for Linux

If you're using Linux, in addition to the above steps, you'll need to add startup parameters to the game's launch options. To do this, right-click on Geometry Dash in your Steam library, click "Properties", and then enter following parameters to the launch options:

WINEDLLOVERRIDES="xinput9_1_0=n,b" %command%

After that, you should be able to run the game and use the mod as usual.

Building

Prerequisites

• CMake
• Git
• Visual Studio (Install the "Desktop development with C++" workload)
• Geode CLI (optional, for building the Geode mod)

Instructions

Clone the repository:

git clone https://github.com/prevter/gdopenhack --recursive
cd gdopenhack

Next steps can be done using the command line or using CMake build tools for VSCode.

Build using CLI:

cmake -B build -A Win32 -DCMAKE_BUILD_TYPE=RelWithDebInfo
cmake --build build --config RelWithDebInfo

Build using CMake Tools for VSCode:

1. Open the project in VSCode.
2. Press Ctrl+Shift+P and select "CMake: Select a Kit".
3. Choose the "Visual Studio Community 2022 Release - x86" or "Visual Studio Community 2022 Release - amd64_x86" kit.
4. Press Ctrl+Shift+P and select "CMake: Build".

This will build both the Geode and vanilla versions of the mod.

The built mod will be located in the bin folder. (If you're building the Geode mod, the .geode file will be installed automatically to your game's mods folder.)

Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated. Please read CONTRIBUTING.md for more information.

License

Distributed under the MIT License. See LICENSE for more information.

Acknowledgements

MegaHack by Absolute for design inspiration and ideas.

GDH by TobyAdd for code reference.

Geode for the modding framework.

Also thanks to these awesome libraries that make this project possible:

• ImGui
• MinHook
• spdlog