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
Integration

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")
Read the Godot SDK guide
Built for Godot

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.

How it works

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.

FAQ

Godot bug reporting questions

How do I add Bugnet to a Godot 4 project?

Run the installer from the folder that contains project.godot. It downloads BugnetSDK.gd to addons/bugnet/ and registers it as an Autoload named Bugnet. Paste your API key at the top of the script, or call Bugnet.bugnet_init() from code. It is a plain script, not an editor plugin, so nothing needs enabling under Plugins.

Does it work with C# (.NET) projects?

Yes. The SDK is a GDScript Autoload, and Godot lets C# scripts call into GDScript autoloads, so a .NET project can use it the same way after adding it under Project Settings > Globals > Autoload.

What gets captured when a Godot game errors?

Script errors and crashes are reported with the stack trace, the device, OS and GPU, the game version and recent log output. Player reports can include a screenshot of the current viewport, custom metadata and file attachments from user:// such as a save file.

Can I style the in-game report form to match my game?

Yes. The widget is built from Control nodes, so it picks up your project's default Theme automatically, or you can give it its own theme with the widget_theme property. Labels, categories and the overlay colour are exported properties.

Is Bugnet free for Godot games?

The free plan includes up to 100 bug reports in total (a lifetime cap, not a monthly allowance), which is plenty to integrate the SDK and run a playtest. Paid plans raise the limits and add features such as session replay.

Start tracking errors in your Godot game

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

Sign up for free View Godot docs