top of page

Gd Macro — Converter

Once upon a time in the vibrating, neon-soaked world of Geometry Dash

, a new kind of "alchemist" emerged not to brew potions, but to transmute the very language of the game: the GD Macro Converter creators. The Quest for Universal Language

In the early days of high-level play, the community was fractured. Brilliant architects of "TAS" (Tool-Assisted Speedrun) replays were divided by the "Bots" they used. If you built a perfect, frame-perfect run in zBot, it was like a secret code that Echo or yBot couldn't understand. Valuable replays were trapped in their original formats, and "Showcasers"—the players who record these impossible levels for YouTube—were constantly struggling to import them. The Creation of the Converter

Enter the digital blacksmiths like matcool, who forged the GD Macro Converter. This wasn't just a tool; it was a bridge. It allowed players to take a .json file from TASBot and, with a few clicks, translate it into a format like ReplayBot or Universal Replay.

One of the most legendary challenges in this process was the "Practice Mode Bug". For years, macros would "break" or de-sync because the game's physics fluctuated slightly between runs. The converters had to become smarter, using frame-based conversion to ensure that an input on Frame 12,001 stayed exactly on Frame 12,001, no matter what hardware was running it. The Silent Heroes of the Showcase

Today, when you watch a "Top 1 Extreme Demon" showcase, you are often seeing the work of these converters. They take the "impossible" and make it "watchable," allowing the community to witness the limits of human (and bot) potential without the frustration of broken files. Key Tools Mentioned in the History:

matcool's GD Macro Converter: The classic web-based hub for multi-format translation.

Nat's Macro Converter: A modern, web-based alternative often linked with the Silicate project.

Universal Replay (GDR): An effort to create a "standard" format so that every bot could finally speak the same language. If you'd like, I can: matcool/gd-macro-converter - GitHub

In the world of Geometry Dash (GD) , precision is everything. Whether you are showcasing a nearly impossible level or testing out a new layout, the ability to record and replay your moves—known as a

—is a vital part of the community's creative toolkit. However, the variety of bot tools available (like Mega Hack, xBot, and Echo) has led to a fragmented ecosystem of file formats. This is where a GD Macro Converter

becomes an essential utility for any dedicated player or content creator. What is a GD Macro Converter?

A GD Macro Converter is a specialized tool that translates replay data from one format to another. For instance, a macro recorded in might not natively work in Mega Hack Replay

. These converters bridge that gap, allowing you to share your runs across different platforms and mods without having to re-record them from scratch. Top Tools for Macro Conversion

Several reputable community-made tools can handle these conversions seamlessly: Mat's Web-Based Converter

: A popular, lightweight online tool that supports a wide range of formats, including Plain Text Universal Replay Nat's Macro Converter (Silicate)

: Known for its extensive support of older and newer formats, such as GDReplayFormat (GDR)

: A standardized format designed by the "Bot Cartel" to create a "universal" standard for all GD bots, reducing the need for constant conversion. Why Use a Macro Converter? Cross-Mod Compatibility

: Not everyone uses the same hacks. Converting your macro to a more universal format like

ensures your subscribers or fellow creators can view your work regardless of their setup. Archiving for New Game Versions : Updates like

can break older bots. Converters help migrate your legacy replays to newer, supported formats. Collaborative Showcases

: When multiple creators work on a single level, they may use different recording tools. Converters allow them to combine their parts into a single, cohesive replay. How to Convert Your Macros Using these tools is typically straightforward:

How do I convert GDR2 to a more ''universal'' format? (.json, etc.) gd macro converter

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

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.


Step-by-Step: How to Convert a Macro (Beginner Guide)

Let’s walk through a practical example using the GDHM Web Converter (no download required).

Scenario: You downloaded a perfect run of Bloodbath as a .gmd file (MegaHack v7 format), but you are using the Eclipse mod which requires .ecm format.

Example workflow

  1. Select source platform and target platform.
  2. Paste or upload source macro(s).
  3. Choose or edit a mapping profile/preset.
  4. Run conversion and review the preview.
  5. Execute in a sandbox or test environment, adjust timing/commands.
  6. Export final macro and store versioned backups.

Outcome & Impact

  • Keeps legacy design automation alive and auditable.
  • Enables teams to migrate to modern, collaborative design ecosystems without losing intent.
  • Reduces technical debt and unlocks reuse of design logic in code-driven UIs.

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?

<!DOCTYPE html>
<html lang="en">
<head>
  <meta charset="UTF-8" />
  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
  <title>GD Macro Converter — Convert Geometry Dash Macros Instantly</title>
  <script src="https://cdn.tailwindcss.com"></script>
  <script src="https://code.iconify.design/iconify-icon/1.0.7/iconify-icon.min.js"></script>
  <link href="https://fonts.googleapis.com/css2?family=Inter:wght@300;400;500;600;700&display=swap" rel="stylesheet" />
  <link href="https://fonts.googleapis.com/css2?family=Oswald:wght@300;400;500;600;700&display=swap" rel="stylesheet" />
  <script>
    tailwind.config = 
      theme: 
        extend: 
          fontFamily: 
            inter: ['Inter', 'ui-sans-serif', 'system-ui'],
            oswald: ['Oswald', 'sans-serif'],
          ,
        ,
      ,
    ;
  </script>
  <style>
    *, *::before, *::after  box-sizing: border-box; 
    body  font-family: 'Inter', ui-sans-serif, system-ui; background: #000000; color: #ffffff; overflow-x: hidden;
/* Animations */
    @keyframes animationIn 
      0%  opacity: 0; transform: translateY(30px); filter: blur(8px); 
      100%  opacity: 1; transform: translateY(0); filter: blur(0px);
.anim-in  animation: animationIn 0.8s ease-out both; 
    .anim-in-d1  animation-delay: 0.1s; 
    .anim-in-d2  animation-delay: 0.25s; 
    .anim-in-d3  animation-delay: 0.4s; 
    .anim-in-d4  animation-delay: 0.55s; 
    .anim-in-d5  animation-delay: 0.7s; 
    .anim-in-d6  animation-delay: 0.85s;
@keyframes slideDownClip 
      0%  transform: translateY(-105%); 
      100%  transform: translateY(0);
.slide-char  display: inline-block; overflow: hidden; 
    .slide-char span  display: inline-block; animation: slideDownClip 0.8s cubic-bezier(0.16,1,0.3,1) backwards;
@keyframes float-slow  0%,100% transform: translateY(0);  50% transform: translateY(-10px);  
    .float-slow  animation: float-slow 6s ease-in-out infinite; 
    @keyframes float-medium  0%,100% transform: translateY(0);  50% transform: translateY(-15px);  
    .float-medium  animation: float-medium 5s ease-in-out infinite;
@keyframes border-beam 
      0%  offset-distance: 0%; 
      100%  offset-distance: 100%;
@keyframes pulse-glow 
      0%, 100%  box-shadow: 0 0 30px -10px rgba(249,115,22,0.4); 
      50%  box-shadow: 0 0 60px -10px rgba(249,115,22,0.7);
.pulse-glow  animation: pulse-glow 3s ease-in-out infinite;
@keyframes spin-slow  0%transform:rotate(0deg) 100%transform:rotate(360deg) 
    .spin-slow  animation: spin-slow 20s linear infinite;
/* Button styles */
    .btn-primary 
      background: linear-gradient(to bottom right, #fb923c 0%, #ea580c 100%);
      box-shadow: 0 0 50px -12px #f97316;
      transition: all 300ms ease;
.btn-primary:hover 
      transform: scale(1.03);
      box-shadow: 0 0 70px -12px #f97316;
.btn-primary:active  transform: scale(0.98);
.btn-outline 
      border: 1px solid rgba(255,255,255,0.2);
      transition: all 300ms ease;
.btn-outline:hover 
      border-color: rgba(255,255,255,0.5);
      background: rgba(255,255,255,0.05);
      transform: scale(1.03);
/* Card hover */
    .card-hover  transition: all 400ms cubic-bezier(0.23,1,0.32,1); 
    .card-hover:hover  transform: translateY(-4px); border-color: rgba(255,255,255,0.2);
/* Nav */
    .nav-link  position: relative; 
    .nav-link::after 
      content: ''; position: absolute; bottom: -4px; left: 0; width: 100%; height: 1px;
      background: #f97316; opacity: 0; transition: opacity 300ms;
.nav-link:hover::after  opacity: 1;
/* Textarea */
    .macro-textarea 
      background: rgba(255,255,255,0.03);
      border: 1px solid rgba(255,255,255,0.1);
      transition: border-color 300ms;
.macro-textarea:focus 
      outline: none;
      border-color: rgba(249,115,22,0.5);
/* Scrollbar */
    ::-webkit-scrollbar  width: 6px; 
    ::-webkit-scrollbar-track  background: transparent; 
    ::-webkit-scrollbar-thumb  background: rgba(255,255,255,0.15); border-radius: 3px; 
    ::-webkit-scrollbar-thumb:hover  background: rgba(255,255,255,0.25);
/* Toast */
    @keyframes toastIn 
      0%  opacity:0; transform: translateY(20px) scale(0.95); 
      100%  opacity:1; transform: translateY(0) scale(1);
@keyframes toastOut 
      0%  opacity:1; transform: translateY(0) scale(1); 
      100%  opacity:0; transform: translateY(20px) scale(0.95);
.toast-in  animation: toastIn 0.35s ease-out both; 
    .toast-out  animation: toastOut 0.3s ease-in both;
/* Background glow */
    .bg-glow 
      position: absolute; width: 600px; height: 600px; border-radius: 50%;
      background: radial-gradient(circle, rgba(249,115,22,0.12) 0%, transparent 70%);
      pointer-events: none;
/* FAQ */
    .faq-answer  max-height: 0; overflow: hidden; transition: max-height 0.4s ease, padding 0.4s ease; 
    .faq-answer.open  max-height: 300px; 
    .faq-chevron  transition: transform 0.3s ease; 
    .faq-chevron.open  transform: rotate(180deg);
/* Selection */
    ::selection  background: rgba(249,115,22,0.3); color: #fff;
/* Stat counter */
    .stat-num  font-variant-numeric: tabular-nums; 
  </style>
</head>
<body>
<!-- Toast Container -->
  <div id="toast-container" class="fixed bottom-6 right-6 z-[100] flex flex-col gap-3"></div>
<!-- Background Effects -->
  <div class="fixed inset-0 z-[-10] pointer-events-none">
    <div class="bg-glow" style="top:-200px;left:-200px;"></div>
    <div class="bg-glow" style="bottom:-300px;right:-200px;opacity:0.6;"></div>
    <div class="absolute inset-0" style="background: radial-gradient(ellipse 80% 50% at 50% 0%, rgba(249,115,22,0.06) 0%, transparent 60%);"></div>
  </div>
<!-- NAVIGATION -->
  <nav class="fixed top-0 left-0 right-0 z-50 backdrop-blur-[12px]" style="background:rgba(0,0,0,0.6); border-bottom:1px solid rgba(255,255,255,0.05);">
    <div class="max-w-7xl mx-auto px-4 sm:px-6 lg:px-8 flex items-center justify-between" style="padding-top:16px; padding-bottom:16px;">
      <!-- Logo -->
      <a href="#" class="flex items-center gap-3 group">
        <div class="w-9 h-9 flex items-center justify-center" style="background:linear-gradient(to bottom right,#fb923c,#ea580c);">
          <iconify-icon icon="mdi:swap-horizontal-bold" width="20" style="color:#fff;"></iconify-icon>
        </div>
        <span class="font-oswald text-xl font-600 tracking-tight uppercase">GD Macro<span class="text-orange-400">Converter</span></span>
      </a>
<!-- Desktop Links -->
      <div class="hidden md:flex items-center gap-8">
        <a href="#features" class="nav-link text

The Ultimate Guide to GD Macro Converters: Everything You Need to Know

In the world of Geometry Dash (GD), the pursuit of perfection often leads players toward automation and precision tools. Whether you are a level creator looking to showcase a "frame-perfect" layout or a player trying to document your progress, a GD Macro Converter is an essential piece of software in your toolkit.

This article explores what these converters do, why they are popular, and how to use them effectively. What is a GD Macro Converter?

A GD Macro Converter is a utility tool designed to translate gameplay data between different formats used by Geometry Dash "macros" (automated scripts of inputs).

In GD, a macro records every click and release relative to the game's frames. However, because there are various mod menus and botting tools—such as MegaHack (mhr), GD Bot, TasBot, and xdBot—the file formats often differ. A converter allows you to take a recording from one bot and make it playable on another. Common File Formats .mhr: MegaHack Replay (the industry standard). .gdbot: Files used by the popular GD Bot.

.json / .txt: Raw data formats often used by open-source tasbots. Why Use a GD Macro Converter? 1. Cross-Compatibility

If you recorded a complex level using an older bot but recently upgraded to MegaHack v7 or v8, you don’t want to re-record your run. A converter migrates that data instantly. 2. Showcasing "Impossible" Levels

The "Illuminati" of the GD community often create levels that are physically impossible for humans to click. To showcase these, creators use macros. Converters allow these creators to share their "bot files" with others regardless of what software the recipient is using. 3. FPS Scaling and Fixing Once upon a time in the vibrating, neon-soaked

Some advanced converters don't just change the file type; they help adjust the FPS (Frames Per Second). Since Geometry Dash physics can change based on frame rate, converting a 60 FPS macro to 360 FPS is vital for accuracy. How to Use a GD Macro Converter

While there are several web-based and downloadable tools, the process generally follows these steps:

Export your Replay: Save your macro from your current mod menu (e.g., export as a .gdbot file).

Upload to the Converter: Open a tool like the GD Replay Converter (often found on GitHub or specialized community Discord servers).

Select Output Format: Choose the format compatible with your target bot (e.g., .mhr).

Adjust Settings: If prompted, ensure the FPS matches your original recording to prevent "desyncing" (where the icon hits a spike despite the macro).

Download and Import: Put the new file into your bot’s "macros" folder and hit play. Are GD Macros "Cheating"? The community has a nuanced view of macros:

Allowed: Showcasing levels on YouTube, creating "Auto" versions of levels, or using them for practice/testing.

Banned: Using macros to beat rated levels and submitting them to the Demon List or the in-game leaderboards.

Pro Tip: If you upload a video using a macro, always label it as a "Showcase" or "Macro" to maintain transparency within the community. Where to Find a GD Macro Converter

Most players look for converters within the Geometry Dash Modding community. Popular hubs include:

GitHub: Search for "GD Replay Converter" to find open-source web tools.

Discord: Joining the servers for MegaHack or specific GD Bots often gives you access to the latest conversion scripts. Conclusion

The GD Macro Converter is a bridge between different eras and tools of Geometry Dash modding. It saves time, preserves history, and allows the community to push the boundaries of what is visually possible in the game. Whether you're a layout creator or a TAS (Tool-Assisted Speedrun) enthusiast, having a reliable converter is a game-changer.


Conclusion

GD Macro Converter can significantly reduce friction when moving automation between environments, especially for routine or moderately complex macros. Its effectiveness depends on robust parsing, well-maintained mapping profiles, and careful testing. For highly specialized or timing-critical macros, expect manual intervention or a full rewrite.

If you want, I can:

  • Provide a step-by-step guide for converting a specific macro format pair (please name the source and target).
  • Draft documentation or a mapping profile template for a particular platform.

The Ultimate Guide to Using a GD Macro Converter Geometry Dash (GD) Macro Converter

is a vital tool for the game's botting community, allowing players to translate "macros" (recorded sequences of inputs) between different bot formats . Whether you are moving a layout from or converting Plain Text into a usable

file, these converters bridge the gap between incompatible software. Why Use a Macro Converter?

In the world of Geometry Dash botting, different tools use unique file extensions and data structures to store player inputs. A converter is essential for: Bot Interoperability

: If you recorded a macro using one bot but want to showcase it using another's features (like superior rendering or physics fixes), you need to convert the file. Cross-Version Compatibility

: Updating from older bots to newer ones often requires changing the macro format to remain functional. Refining Inputs : Many converters include a "Clean Replay" Step-by-Step: How to Convert a Macro (Beginner Guide)

feature that removes redundant actions, making the macro more efficient and "human-like". Popular Supported Formats The most comprehensive converters, such as the matcool GD Macro Converter , support a wide range of formats: zBot & yBot

: Two of the most widely used bots for high-level demon completions. Echo & ReplayBot

: Popular for their user-friendly interfaces and recording stability. xBot, TASBOT, and DDHOR

: Specialist tools often used for TAS (Tool-Assisted Speedrun) projects. Universal Replay (URL)

: A standardized format intended to work across multiple platforms. How to Convert Your GD Macros

Most modern converters are web-based or open-source tools found on GitHub. Follow these general steps: Upload Your File : Select the source macro from your computer (e.g., a Select "From" and "To"

: Choose the current format of your macro and the desired output format from the dropdown menus. Toggle Cleanup Options "Clean Replay"

checkbox to strip unnecessary data that might cause lag or desyncs. Convert and Download

: Click the convert button and save the new file to your bot's specific directory. Advanced Features: Frame-Based Conversion

For top-tier "Impossible Levels" or extremely precise timings, some tools offer frame-based conversion

In Geometry Dash (GD), a GD macro converter is a specialized utility used to translate gameplay recordings—known as macros—between different mod and bot formats. This tool is essential for creators who want to showcase levels or verify impossible layouts using various botting software without re-recording the entire run. What is a GD Macro Converter?

A GD macro converter acts as a bridge between the diverse file formats used by the Geometry Dash botting community. Because different mods like Mega Hack Replay, xdBot, and zBot use unique ways to store input data, a converter allows a macro recorded in one tool to be played back in another. Key Features and Functionality

Most modern converters, such as the Matcool GD Macro Converter, offer a range of features to ensure macro accuracy:

Format Interoperability: Converts between popular formats including .gdr, .json, ReplayBot, xBot, TASBOT, and Echo.

Frame-Based Conversion: Allows for precise timing adjustments by converting macros based on specific frame rates.

Replay Cleaning: Removes redundant actions or "spam" inputs to make the replay smoother and less prone to breaking during playback.

Advanced Editing: Features like flipping player inputs (Player 1 to Player 2), offsetting frames, and removing specific input types help refine the final showcase. Why Use a Macro Converter?

Showcasing Levels: Many "list" level showcases are created by botting a level to ensure the highest possible quality for viewers.

Compatibility: If a specific bot is discontinued (like the older versions of xdBot), players can convert their existing macros to work with newer, supported mods like those found on the Geode modding framework.

Collaboration: Creators can share their "paths" through a level, allowing others to analyze the exact movements required for completion. Popular Tools and Bots

Several tools are frequently used alongside converters to create and manage macros: matcool/gd-macro-converter - GitHub

Here’s a concise guide on GD Macro Converters (commonly used in Geometry Dash for converting macros between formats, e.g., for bots like MegaHack or GDH).


bottom of page