Pro Tip: Changing FPS changes physics. For Geometry Dash, going down in FPS (240 to 60) usually requires holding clicks slightly longer. A good converter does this automatically.
In the context of Geometry Dash (GD) Macro Converter is a vital tool for players and creators who use bots to automate or showcase level completions. Because different "bots" (modifications that record and play back inputs) use unique file formats, a converter allows you to take a recorded run from one bot and use it in another. Core Functionality GD macro converters—most notably the popular web-based GD Macro Converter by Matcool —act as a "universal translator" for input data. Supported Formats: They typically handle a wide array of formats including (Mega Hack), (Tasbot/zBot), .universal Frame vs. Time: Modern converters often allow for frame-based conversion
, which is more precise for high-difficulty levels where a single millisecond of desync can lead to a crash. Clean Replay:
Many tools include a "Clean Replay" feature that removes redundant or "noise" inputs, making the macro more stable and reducing the risk of being flagged by anti-cheat systems. Key Tools and Resources Matcool’s GD Macro Converter
The industry standard web tool. It supports almost every major bot format used in the 2.1 and 2.2 eras. GDR-Converter (GitHub) A specific utility used to upgrade older
(GDR1) files to the newer GDR2 format required by modern bots like Eclipse. Nat's Macro Converter
Another reputable open-source option, often used as part of the Silicate bot ecosystem. Common Use Cases Bot Migration: If you recorded a level with an older bot like but want to showcase it using Mega Hack’s internal recorder, you must convert the Level Showcasing:
Creators of "Impossible Levels" use macros to demonstrate that a level is physically possible for a bot to complete, even if no human can do it. Cross-Platform Sharing:
Since mobile and PC bots often use different formats (e.g., Eclipse on Geode), converters bridge the gap for the community. Troubleshooting Tips The "Offset" Fix:
If a converted macro breaks (e.g., your icon jumps too early/late), players often fix this by offsetting the frames by 1
during the conversion process to account for how different bots calculate the initial start frame. Version Compatibility: Following the GD 2.2 update gd macro converter
A GD (Geometry Dash) macro converter is a specialized tool used to translate replay files between different bot formats (such as .gdr, .gdr2, .json, or .zbf). This is essential for players who want to share macros across different mod menus or use them with updated game versions. Popular Macro Converters
Several tools exist to handle these conversions, ranging from web-based interfaces to command-line utilities.
Matcool's GD Macro Converter: A widely used web-based converter that supports a variety of formats.
NAT Converter (obot-converter): An extensive tool hosted on GitHub that handles modern 2.2 formats like .gdr and .xd, as well as legacy 2.1 formats like .mhr and .zbf.
GD-Macro-Converter (Python): A command-line tool available on GitHub for users who prefer local execution or batch processing. Supported Formats
Converters typically bridge the gap between the following common file types:
.gdr / .gdr2: Standard formats used by modern bots like Eclipse Menu or xdBOT. .mhr / .mhr.json: Replay files from Mega Hack.
.zbf / .zbot: Formats originally created for the zBot client.
.json: Often used as a "universal" format for custom bot implementations. .ybot: Specific to the yBot client. How to Use a Web-Based Converter
Most converters, such as the Matcool Converter, follow a similar workflow: Pro Tip: Changing FPS changes physics
Select Source Format: Choose the "From" format (e.g., zBot or Mega Hack Replay).
Upload File: Drag and drop your macro file into the converter or use the upload button.
Select Target Format: Choose the "To" format (e.g., .gdr2 for use in modern 2.2 bots).
Clean Replay (Optional): Many tools include a "Clean" checkbox to remove redundant actions, which can reduce file size and improve playback stability.
Convert and Download: Click the "Convert" button to generate the new file and save it to your device. Importing Converted Macros
Once converted, the macro must be placed in the correct directory for your bot to recognize it:
Geode / Eclipse Menu: Place .gdr2 files in the specific replay directory created by the mod.
xdBOT: Use the "Load" button within the game's pause menu to navigate to your saved macro folder.
Importing JSON: Some bots allow importing via a "Hamburger" icon or dedicated "Import Macro" button which opens your system's file explorer. How to Import, Edit and Export Macros
This content is structured to be useful whether you are writing a blog post, creating a video script, or just trying to understand how the tool works. If you want, I can generate a sample
If you want, I can generate a sample annotated conversion for a short example macro (input → converted SVG + mapping + refactor notes). Which macro dialect or an example snippet should I use?
In the context of Geometry Dash , a macro converter is a tool used to translate replay files (macros) between different bot formats. Because different bots—like xBot, zBot, and yBot—use unique file structures, players use these converters to share or showcase levels without having to re-record them for each specific bot. Key Macro Converter Tools
Several community-developed tools facilitate these conversions:
Matcool's GD Macro Converter: A widely used web-based tool that supports a broad range of formats, including TASBOT, Echo, Universal Replay, and Plain Text.
Nat's Macro Converter: Another browser-accessible option that serves as a subset of the Silicate bot ecosystem.
GDReplayFormat (GDR): A standardized format used by bots like GDMegaOverlay and Eclipse Menu. Converters for these often handle migrations between GDR 1.0 and newer versions. How They Work
Converters typically function by reading the frame or time-based inputs of one file and mapping them to the syntax required by another.
Frame-Based Conversion: Essential for accuracy, especially when moving between high-FPS macros and vanilla physics.
Replay Cleaning: Many tools include an option to "Clean replay," which removes redundant actions to make the macro run more smoothly and look more natural.
Manual Offsetting: In some cases, such as converting from Tasbot to Replaybot, users may need to manually offset frames by one to prevent the macro from breaking during playback. Common Supported Formats
Most modern converters can handle a variety of "bot cartel" files, such as: .json (TASBOT, yBot) .gdr / .gdr2 (Eclipse, ReplayBot) .plain text (for manual editing or universal debugging) converter - Mat