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
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 gd macro converter
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:
Select Source Format: Choose the "From" format (e.g., zBot or Mega Hack Replay). In the context of Geometry Dash , a
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
GD Macro Converter a community-developed tool, primarily hosted on
, designed to translate replay files (macros) between various Geometry Dash bot formats Back up originals before conversion
. This is essential for players and creators who use different software for botting levels, as macro formats are often proprietary to specific mods. Key Features & Usage Web-Based Interface : You can access the tool directly via the GD Macro Converter website without installing software. Drag-and-Drop Conversion
: Users can upload a macro file, and the tool often attempts to "guess" the source bot format automatically. Format Flexibility
: It supports converting between several popular formats, including: .gdr / .gdr2 Eclipse Menu Mega Hack Replay : Used by the Other formats like How to Convert a Macro Select Your Bot Converter website
, choose the bot your macro was recorded with under "Converting from". Choose Target Format
: Select the bot you want to use the macro with under "Converting to". Upload & Download : Drag your file into the designated area, click , and download the new file format. Troubleshooting
: If a macro breaks during conversion (e.g., from TASBot to Replaybot), try converting it to "Plain Text" first as an intermediate step, or adjusting the frame offset. Common Macro Bots gd-macro-converter/new.html at master - GitHub
You have a physical part on your desk, but you lost the original CAD file. You do, however, have the old G-code file that ran on the CNC machine five years ago. A GD Macro Converter allows you to extract the toolpath coordinates and regenerate a vector sketch. It won't give you parametric history, but it gives you the exact geometry to remanufacture or modify the part.
One of the most common uses of a converter is changing the frame rate assumption. A macro recorded at 60 FPS will fail miserably on a 360 FPS monitor due to physics engine discrepancies. Advanced converters can interpolate or scale input timing.
The recent 2.2 update introduced camera triggers, swing copters, and dash spiders. This complicated macro conversion because older converters don't recognize the new physics. However, developers are now releasing GD Macro Converter 2.2 versions that include: