Home

Awesome

C# Tools for Godot

Debugger and utilities for working with Godot C# projects in VSCode.

Requirements

Godot >= 3.2.2 and < 4.0. Older versions of Godot or 4.0 and higher are not supported.

Features

NOTES:

VSCode installation and configuration

Install via extensions marketplace by searching for neikeq.godot-csharp-vscode.

Multiple Project setup

If the current workspace contains multiple Godot projects, the extension will prompt you to select the one you want to use with the extension on opening the workspace in VSCode. The selected project can be changed anytime from the status bar or using the Select Project command.

Setup debugging

To debug a Godot project you have to create the debugger launch configurations. It can be created from the Debug panel or by using the Generate Assets for Build and Debug command.

Additional Launch configuration

The Launch debugger configurations requires additional setup. The "executable" property must be set to a path that points to the Godot executable that will be launched. By default, the extension tries to automatically populate this property with the path to the running Godot instance but if there isn't one it needs to be set manually: Fix editor path

You can also set the godot.csharp.executablePath setting to the path that points to the Godot executable that will always be used when generating the debugger configurations so you won't have to set it manually everytime.

The generated debugger configuration will also create a tasks.json that contains a build task for building the project from VSCode which is used by the Launch configuration in order to build the project before launching (this is configured in the "preLaunchTask" property of the configuration and can be removed).

The build task uses the Godot executable to build the the C# project (this is configured in the "command" property and must be configured like the "executable" property of the Launch configuration if the extension could not find the right path). The build task can be modified to execute the dotnet command directly instead or modify the Godot CLI arguments.

Debugger launch configurations

By default the extension creates the following launch configurations:

Screenshots

Debugging

Nodes code completion

Input actions code completion

Signals code completion