DIG Macro

Auto minigame macro for DIG.
Current version: 2.0.0 | Changelogs | Discord Server

What is This?

DIG Macro is a tool that automatically plays the minigame in the roblox game DIG.

How does this work?

DIG Macro uses Python and computer vision to detect when to click inside the digging minigame. It uses pywebview which is a wrapper around a web browser to create a custom GUI.

---

📑 Table of Contents

• Features
• TO-DO and Known Issues
• Supported Operating Systems
• Quick Start
  • Download and Run
    • Running on macOS
    • Permissions on macOS
• How to Stop the Macro
• Global Hotkeys
• Editing the Configuration
  • How to Open the Configuration
• Pathfinding Macros (Movement Patterns)
  • How to Add or Edit Movement Patterns
• Troubleshooting
• Credits

---

✨ Features

• Custom GUI: A custom graphical interface with options and macro status.
• Configuration GUI: A graphical interface that allows you to simply configure any macro setting and provides information about each one.
• Auto Sell: Automatically sells your items after a given number of digs or after completing the pathfinding macro. (requires 'Sell Anywhere' gamepass)
• Auto Rejoin: If you disconnect or something goes wrong, the macro will automatically rejoin DIG.
• Auto Start Minigame: Starts the minigame automatically for you.
• Prediction System: Predicts the player's bar position, resulting in faster digging.
• Pathfinding Macros: A system that will move you around from where you started using various movement patterns (square, etc.).
• Boss Support: You can use this macro to battle bosses.

---

💻 Supported Operating Systems

Note

Only 64-bit and arm64 architectures are supported.

Operating System	Support Status	Supported Versions	Tested On	Notes
Windows	✅ Full Support	Windows 10 and later	Windows 10, Windows 11	Roblox UWP (Microsoft Store) is not supported
Linux	✅ Full Support	Most modern distributions (Ubuntu 13+/Debian, RHEL/Fedora, Arch, OpenSUSE)	Linux Mint 22.1 (Cinnamon X11)	Wayland is not supported, Requires Sober
MacBook with Apple Silicon	✅ Full Support	macOS Big Sur 11.7+, 8GB RAM or more	MacBook M3	Nothing here...
MacBook with Intel CPU	✅ Full Support	macOS High Sierra 10.13+, 8GB RAM or more	MacBook Pro Intel i7	Due to Intel CPU performance on MacBooks, the macro will only work with Roblox locked at 60 FPS and with the lowest graphics settings possible

If you have improvements or patches for additional (or currently supported) operating system(s), please consider submitting a pull request.

---

🚀 Quick Start

📥 Download and Run

Warning

Some antivirus software may flag the standalone (pre-built) version as a false positive.
This is a common issue with binary files (.exe/.app/.bin) generated using Python compilers such as Nuitka or PyInstaller/auto-py-to-exe. These tools bundle Python code into a single binary file, which can sometimes trigger antivirus alerts despite the code being completely safe.

All of our code is open source and publicly available!

Standalone (pre-built) version

1. Download the latest version for your Operating System:
   • Click here to go to Releases
2. Run the macro:
   • Windows: Double-click digmacro_windows.exe.
   • Linux: Double-click digmacro_linux.bin or run ./digmacro_linux.bin in your terminal.
   • macOS: Refer to the macOS section below for help.

Source version

Note

Python 3.12.8 and later is required.

1. Download the latest version:
   • MAIN (stable) - Download | DEV - Download
2. Extract the ZIP File:
   • Windows/Linux: Right-click the downloaded zip file and select Extract Here or Extract All.
   • macOS: Double-click the downloaded zip file.
3. Open the Folder:
   • Windows: Go into the extracted digmacro-[main/dev] folder.
   • Linux: Right-click the extracted digmacro-[main/dev] folder and select Open in Terminal.
   • macOS: Right-click the extracted digmacro-[main/dev] folder and select New Terminal at Folder (that option might be inside Services dropdown).
4. Run the macro:
   • Windows: Double-click launch.bat or run launch.bat in Command Prompt opened in the extracted folder.
   • Linux/macOS: Run sh launch.sh in the Terminal you opened.

---

 macOS Setup

Video Tutorial

Text Tutorial

1. Download & unzip digmacro_macos.zip, then double-click digmacro_macos.app to launch.

2. If you see a warning that the app is from an unidentified developer, you need to allow it in your security settings:

   • Go to System Preferences → Security & Privacy → General.
   • Click "Open Anyway" next to the message about the app being blocked.

If you still cannot open the app after pressing open anyway (like not launching) You can use the following command in terminal after changing directories to whereever the digmacro_macos.app file is found:

cd /path/to/digmacro_macos.app # Change this to the actual path where digmacro_macos.app is located like ~/Downloads/
xattr -dr com.apple.quarantine digmacro_macos.app
open digmacro_macos.app

🔐 Permissions on macOS

1. Accessibility Permissions

Required for controlling mouse clicks and keyboard input Needed for the automation features to work

How to grant: System Preferences → Security & Privacy → Privacy → Accessibility → Add the application (digmacro_macos)

2. Screen Recording Permissions

Required for taking screenshots to analyze the game state Used for image recognition and prediction systems

How to grant: System Preferences → Security & Privacy → Privacy → Screen Recording → Add the application (digmacro_macos)

3. Input Monitoring Permissions

Required for keyboard and mouse event handling

How to grant: System Preferences → Security & Privacy → Privacy → Input Monitoring → Add the application (digmacro_macos)

---

⏹️ How to Stop the Macro

• Close the Macro Window: Just click the close (X) button or press Ctrl+E.

---

⌨ Global Hotkeys

These keyboard shortcuts can be used at any time while the macro is running, regardless of which application is focused:

• Ctrl+E - Exit
  • The hotkey will immediately stops and closes the macro.
• Ctrl+P - Pause/Resume
  • This hotkey will pause/resume the macro. Useful if you need to do something without closing the macro.

---

⚙️ Editing the Configuration

You can easily change how the macro works using a simple graphical interface.

🔧 How to Open the Configuration

Follow the same steps as running the macro, but when asked "What would you like to do?", simply select Edit the configuration to edit the configuration instead of starting the macro.

---

🗺️ Pathfinding Macros (Movement Patterns)

The macro can move your character in different patterns (like a square, line, etc.). You can use the built-in patterns or create your own.

➕ How to Add or Edit Movement Patterns

1. Open the File:
   Go to the storage folder and open pathfinding_macros.json with a text editor (like Notepad).

2. Understanding the Format:
   Each pattern is a list of steps. Each step tells the macro which key(s) to press and for how long.

   • Single Key:
     "w" means press W.
   • Multiple Keys:
     ["w", "d"] means press W and D together.
   • Duration:
     The number (like 1.0) is how many seconds to hold the key(s).

   Example:

   "square": [
       ["w", 1.0],
       ["d", 1.0],
       ["s", 1.0],
       ["a", 1.0]
   ]

3. Add Your Own Pattern:
   Add a new entry with your chosen name and steps.
   For example, to add a "vertical_line" pattern:

   {
     "vertical_line": [
       ["w", 2.0],
       ["s", 2.0]
     ],
     "square": [
       ["w", 1.0],
       ["d", 1.0],
       ["s", 1.0],
       ["a", 1.0]
     ]
   }

4. Save the File:
   After editing, save the file. Your new pattern will appear in the configuration GUI.

---

🔧 Troubleshooting

• Computer Vision is at the wrong place.

  • Go to the storage folder and delete region.json file. Then you will be prompted to re-select your minigame region again.

• Macro is missing clicks or not working well:

  • The macro’s speed can be affected by several factors:

    1. Your CPU performance and Roblox FPS also impact how well the macro runs
    2. mss on Windows slows down the macro because of VSync

  • If you're having issues, try the following:

    1. Lower your in-game graphics and enable "Low Graphics" inside DIG settings
    2. Close background applications (ideally only have the macro and Roblox running)
    3. Adjust the configuration (MIN_CLICK_INTERVAL, TARGET_FPS, USE_PREDICTION, PLAYER_BAR_DETECTION)
    4. Change your screen resolution (for example 1080p to 720p)

• Running from source with macOS is not working well:

  • This may be due to using Python from Homebrew, please uninstall Python from homebrew and install it from the official site for the best experience running from source.

• Need help?

  • Check the Changelogs for updates or create a new issue in this repository.

---

👥 Credits

• upio (notpoiu): UI Design and helped with macOS support and testing