geometry-dash-rl

Teacher-student RL pipeline for Geometry Dash using a Geode shared-memory bridge.

Requirements

• Python >=3.10
• Python deps from requirements.txt (torch, stable-baselines3, gymnasium, etc.)
• Geometry Dash 2.2081 and Geode SDK

Setup

python -m venv .venv
source .venv/bin/activate
pip install -U pip
pip install -r requirements.txt
pip install -e .
mkdir -p artifacts

Or:

make setup

Repository layout

Path	Purpose
src/	Python RL pipeline — see src/README.md
mods/	Geode mods for Geometry Dash — see mods/README.md
artifacts/	Generated outputs: trained models and NPZ datasets (not committed)

Geode CLI and SDK setup (macOS)

1. Install the Geode CLI

curl -L https://github.com/geode-sdk/cli/releases/download/v3.7.4/geode-cli-v3.7.4-mac.zip -o geode-cli.zip
unzip geode-cli.zip
sudo mv geode /usr/local/bin/geode
geode --version

2. Configure the CLI with your Geometry Dash path

geode config setup

When prompted for the Geometry Dash path, use:

$HOME/Library/Application Support/Steam/steamapps/common/Geometry Dash/Geometry Dash.app

3. Install the Geode SDK

geode sdk install

The SDK is installed to /Users/Shared/Geode/sdk (shared across all users). Add it to your ~/.zshrc:

echo 'export GEODE_SDK="/Users/Shared/Geode/sdk"' >> ~/.zshrc
source ~/.zshrc

4. Install Geode binaries into Geometry Dash

geode sdk install-binaries

5. Set the mods output path

echo 'export GEODE_MODS_PATH="$HOME/Library/Application Support/Steam/steamapps/common/Geometry Dash/Geometry Dash.app/Contents/geode/mods"' >> ~/.zshrc
source ~/.zshrc

Running mods

See mods/README.md for how to create, build, and run each mod.