Unity Debugger

v26.4.6 · by tomires · added 3 November 2026

Debug Unity applications in Zed

Debug adapters

How to install

With Forge Super installed, the button above opens the app on this extension, where you press Install. Nothing is installed until you do.

You can also open the Extensions panel in the app and search for Unity Debugger. The extension's id is unity-debugger.

Don't have Forge Super yet? Download it here.

README

From the extension's repository, written by its authors and not by Mentenaz. See the source.

Unity Debugger for Zed

This extension allows you to debug Unity projects in Zed. In order to use it you will need to source your own debug adapter. I recommend using unity-dap which supports Linux, macOS and Windows and works with all Unity projects utilizing the Mono scripting backend. Mono needs to be installed on your machine and added to PATH in order to use the tool.

[!IMPORTANT] While using the debug adapter provided as part of Unity for Visual Studio Code package is technically possible, the project's license specifically disallows use with non-Microsoft IDEs.

Setup

Clone this repository, install Rust and use the Install Dev Extension button in Zed's Extensions tab.

Project setup

Open the folder housing your Unity project and create a debug.json file in .zed subdirectory. Alternatively, press CMD/CTRL+J and select Edit debug.json. Paste the following contents:

[{
    "adapter": "unity",
    "label": "Attach to Unity Editor",
    "request": "attach",
    "projectPath": "${ZED_WORKTREE_ROOT}",
    "adapterPath": "/path/to/unity-debug-adapter.exe/.dll"
}]

Adapter path should point towards the debug adapter library, the rest can be left as-is. You may launch the debugger by pressing CMD/CTRL+J, clicking the + icon and selecting Attach to Unity Editor.