A Geode mod that runs and records Blockwork macros inside Geometry Dash, synced to level attempts. Blockwork's engine (blockwork-ffi, a static library built from the Blockwork repo) is linked into the mod, so the desktop app doesn't need to be running.
| Path | What it is |
|---|---|
src/main.cpp |
Settings, hotkeys, attempt start/end, frame-locked playback and step recording, and the game hooks ($modify) |
src/MacrosPopup.* |
The in-game panel for choosing, creating and clearing macros |
src/LevelMacros.hpp |
Which macro belongs to which level, kept in the mod's saved values |
mod.json |
Mod metadata and every setting shown in Geode's settings page |
about.md, changelog.md |
Text Geode shows on the mod's page |
scripts/ |
Linux test tools (below) |
The mod targets Windows Geometry Dash, including under Proton (resources/linux-input.so, which just build makes, is the Linux-side input helper it starts there). These steps cross-compile the Windows build from Linux. CMakeLists.txt also links a macOS build (blockwork-ffi/build-macos.sh in Blockwork makes the library), but just has no recipe for it.
You need:
- the Geode CLI and SDK, with
GEODE_SDKset - a Blockwork checkout, by default next to this one at
../Blockwork - an xwin "splat" folder with the Windows SDK, and a clang-cl CMake toolchain file
just,cmake,ninjaand Rust with thex86_64-pc-windows-msvctarget
Copy .env.example to .env and fill in the paths, then:
just build # builds blockwork-ffi and resources/linux-input.so from the Blockwork checkout, then the mod
just install # installs the .geode into your Geode profile
just run # install, then launch the game
just cleanTo configure CMake by hand, pass -DBLOCKWORK_FFI_LIB (the built blockwork_ffi.lib) and -DBLOCKWORK_FFI_INCLUDE_DIR (blockwork-ffi/include in the Blockwork repo).
The release workflow (.github/workflows/multi-platform.yml, run by hand with a version) does not build blockwork-ffi yet, so CI builds stop at CMake's BLOCKWORK_FFI_LIB check. Release builds currently come from just build.
The scripts assume Linux, Steam and Proton, and the Python ones use evdev for a virtual keyboard.
scripts/autotest.py [--level ID] [--macro ID] [--runs N]launches the game, opens a level with a macro running frame-locked, and reports the outcome from the Geode log. It turns QOL mod's safe mode on and disables timing mods for the run (restored afterwards), and overwrites this mod's own settings.GD_DIR,GD_MOD_SAVESandBLOCKWORK_DIRoverride the Steam, save and Blockwork config paths. Its defaults name a local level ("Bloodbath 2") and macro ("Bloodbath (frame-locked)"); pass--local ""and--sourceto use others.scripts/inputgen.py MACRO_JSONpresses Space on a macro's schedule, paced by the step counter the mod writes to/tmp/bw_step.txt.scripts/strayinput.py [SECONDS]presses Space at random, to check that playback ignores real input.
GPL-3.0-or-later. See LICENSE.
