A macro is a recording of every input in a level. To play one back you need a file made for your playback tool. Every macro on GDMacros shows its tool on the download card, so check that first, then follow the matching section below.

xdBot

Free

What most macros here use. Needs a manual install now, see below.

zBot

Free

A cross-platform replay bot. Uses the converted .gdr downloads.

Mega Hack

Paid

A paid mod menu with its own replay system.

Before you start

These tools run with Geode, the Geometry Dash mod loader. Install Geode first and launch the game once so it sets itself up. Everything below assumes Geode is already working.

Macros only work in a modded client. They will not do anything in a clean copy of the game, and they are not completions. Do not submit macro runs as records.

xdBot

Free.gdr2

Most macros in the catalog are xdBot recordings.

xdBot is no longer in the Geode mod browser. The original owner abandoned it, so searching for it in game will not find it. A newer build is still maintained, and you install it by hand using the links below.

  1. 1

    Download the .geode file

    Pick the build for your device:Download for PCDownload for mobileBoth are hosted on MediaFire. The file is called zilko.xdbot.geode.
  2. 2

    Find your Geode mods folder

    Geode keeps installed mods in a geode/mods folder inside the game directory:Windows  Geometry Dash/geode/modsAndroid  (launcher media folder)/game/geode/modsiOS  Documents/game/geode/modsOn Steam you can reach the Windows folder with Manage, then Browse local files.
  3. 3

    Drop the file in and restart

    Put zilko.xdbot.geode straight into that mods folder. Do not unzip it and do not rename it. Close Geometry Dash fully and open it again, and Geode loads the mod on startup.
  4. 4

    Check it loaded

    Open the Geode menu in game and look for xdBot in your installed mods. If it is not there, the file is in the wrong folder or the game was not restarted.
  5. 5

    Download a macro and load it

    Grab a macro from the catalog, start the level it was made for, then pause. Open xdBot from its button in the corner of the pause screen, press Load and pick the file.
  6. 6

    Play it back

    Make sure playback is enabled rather than recording, then unpause. The macro drives the level from wherever you started it.

zBot

Free.gdr

The initial zBot collection was converted from compatible xdBot recordings while keeping the same level and macro-author credit. Native zBot recordings can also be submitted.

Install zBot through Geode. Its free version includes recording and playback; the optional paid key removes zBot's visible watermark.

Open zBot on Geode
  1. 1

    Install zBot

    Open Geode's mod browser, search for zBot and install the version offered for your device. The official Geode page above also lists the currently available builds.
  2. 2

    Download the zBot entry

    Open a level in the catalog and choose the download card labelled zBot. Its filename ends in .gdr.
  3. 3

    Load the replay

    Open zBot in game and use its load or import control to select the downloaded .gdr file.
  4. 4

    Play from the beginning

    Use playback mode and start the matching level from the beginning. Keep the game at 240 FPS unless the macro page says otherwise.

Mega Hack

Paid.gdr2

Mega Hack ships its own replay system and reads the same .gdr2 files.

Mega Hack is not free. It is a paid mod menu, bought from its developer.

Buy Mega Hack
  1. 1

    Buy and install it

    Purchase Mega Hack from absolllute.com and follow the installer. Once it is running, open the mod menu in game and find the replay or macro section.
  2. 2

    Put the macro where it can find it

    Mega Hack loads replays from its own macros folder. Drop the downloaded file in there, or use the menu's import option if your version has one.
  3. 3

    Select and play

    Pick the macro from the list, switch the mode from record to playback, then start the level.

Use the file made for your playback tool. Mega Hack and xdBot entries use .gdr2, while zBot entries use .gdr. Check the recorder on each download card and take the one that matches your setup.

If the macro desyncs

A macro is a list of inputs tied to timing, so anything that changes the game's timing breaks it partway through. When a run starts clean and then dies at the same spot every time, check these:

  • Frame rate. Every macro here is made to run at 240 FPS. Set your game to the same rate the macro was recorded at.
  • Physics bypass and speedhacks. Turn them off unless the macro says otherwise.
  • Other mods. Anything that alters timing, gameplay or object behaviour can shift the run.
  • The level version. If the creator updated the level after the macro was recorded, the macro no longer matches it.
  • Start position. Play from the beginning of the level, not from a checkpoint or a start pos.

More tools may come

The catalog now carries xdBot, zBot and Mega Hack downloads. Support for other replay tools may be added later, including Eclipse, and this page will be updated as each one is added.

Ready to grab one?

Every macro in the catalog is free, hosted by us, and shows which tool it needs.