Godot SDK

Error tracking for Godot Games

One GDScript file that runs as an Autoload singleton in any Godot 4.x project. Crash reports, player feedback, and session data — all in one dashboard.

Sign up for free

Up and running in minutes

Bugnet for Godot is a single script, BugnetSDK.gd, registered as an Autoload named Bugnet. It is not an editor plugin, so there is nothing to enable under Project Settings > Plugins.

  1. Install the Autoload

    From your project folder (where project.godot lives), run the installer. It downloads BugnetSDK.gd to addons/bugnet/ and adds the Bugnet Autoload to project.godot.

    Terminal (macOS / Linux)
    curl -s https://bugnet.io/sdks/godot/install.sh | bash
    PowerShell (Windows)
    powershell -ExecutionPolicy Bypass -c "& { iwr -useb https://bugnet.io/sdks/godot/install.ps1 -OutFile $env:TEMP\bugnet.ps1; & $env:TEMP\bugnet.ps1 }"

    Prefer to do it by hand? Download BugnetSDK.gd into res://addons/bugnet/, then open Project > Project Settings > Globals > Autoload (just Autoload before Godot 4.3), pick the script, set the Node Name to Bugnet and click Add.

  2. Add your API key

    No code: open Project > Project Settings > Globals > Autoload, click the BugnetSDK.gd path to open the script, and paste your key into api_key at the top — the Autoload initializes itself on startup. Or in code, from any script:

    main.gd
    func _ready():
        Bugnet.bugnet_init("YOUR_API_KEY", "https://api.bugnet.io")
  3. Let players report bugs

    Crash capture and session tracking start automatically. Open the in-game report form from a key or a menu button, or file reports from your own code:

    main.gd
    func _input(event):
        # F1 opens the bug report form
        if event is InputEventKey and event.pressed and event.keycode == KEY_F1:
            Bugnet.show_widget()
    
    func _on_fell_out_of_world():
        Bugnet.report_bug("Fell through the floor", "Level 3, near the bridge")

Everything you need, nothing you don't

A Single GDScript Autoload

One BugnetSDK.gd file, registered as the Bugnet Autoload. No editor plugin, no engine modules, no native binaries.

Automatic Crash Reports

Stack traces with device info and recent logs, captured the moment an error fires.

Screenshot Capture

The current frame is captured and attached to each report when screenshot capture is on for your project.

Session Replay

A screen recording of the last 30 seconds before the report (Studio Plus).

Godot 4.x Ready

Built for Godot 4.x and written in pure GDScript.

Cross-Platform

Desktop, mobile, and web exports. The same script runs on every platform Godot exports to.

Three steps to fewer bugs

1

Install the Autoload

Run the one-line installer (or add BugnetSDK.gd as an Autoload named Bugnet yourself), then add your API key.

2

Players report bugs

Players submit bug reports directly from your game. Screenshots, device info, and session data are captured automatically.

3

You fix and ship

Triage reports in your Bugnet dashboard, assign priorities, and track fixes on a public bug tracker your players can follow.

“As a solo dev, players were leaving faster than I could read Discord. Bugnet showed me exactly which bugs were causing the most churn. I fixed the top three and my retention rate doubled in two weeks.”

SB
Sam Bell
Solo Dev, Echoes of the Rift
340+Studios
1.2M+Bug reports
38%Less churn

New to the Godot engine or weighing your options? Read our in-depth Godot game engine guide, or compare every major engine side by side in Best game engines for indie developers.

Start tracking errors in your Godot game

Join hundreds of indie studios using Bugnet to turn bug reports into player loyalty.