GodotSharpExtras 0.1.0

.NET Framework 4.7.2
There is a newer version of this package available.
See the version list below for details.
dotnet add package GodotSharpExtras --version 0.1.0
NuGet\Install-Package GodotSharpExtras -Version 0.1.0
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="GodotSharpExtras" Version="0.1.0" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add GodotSharpExtras --version 0.1.0
#r "nuget: GodotSharpExtras, 0.1.0"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install GodotSharpExtras as a Cake Addin
#addin nuget:?package=GodotSharpExtras&version=0.1.0

// Install GodotSharpExtras as a Cake Tool
#tool nuget:?package=GodotSharpExtras&version=0.1.0


C# Extras for Godot, provides tools that are not currently implemented by the Core GodotSharp library. One being the onready keyword. Instead, this is replaced with using two C# attributes, called NodePath() and ResolveNode() attributes, that allows easily to reference a variable to their proper node in the Scene / SceneTree.


To install this library, simply use dotnet command line tool, to add a package reference for GodotSharpExtras, using the following command:

dotnet add package GodotSharpExtras


In order to compile a custom version of this project, you will need the GodotSharp libraries from an existing Project which can be found under .mono folder. In order to make it easier to build, simply copy the .mono folder from one of your projects, directly into the root of this folder, and then run the following command:

dotnet build

This will compile the DLL file, as well as create a Nuget package, that you can install locally, or you can simply copy the DLL file over to your project, under any folder you want, and add the following to your project's csproj file.

    <Reference Include="GodotSharpExtras">


This function is what wires everything up from the Godot side of things, to the C# Side of things. In order for C# to be able to get the nodes it needs to reference with the proper C# Variables, OnReady() needs to be called. By the Godot documentation, it isn't recommended to use this when calling various functions on the node, but due to the nature in which the system needs to wire things up, it needs a reference to the node that we are running the OnReady() function on to be able to ensure that the variables are properly setup with the values. This is done through the C#'s Extension Methods. This allows us to add OnReady() to a node reference, without having to recompile GodotSharp in order to add this method. See examples for NodePath and ResolveNode on how OnReady() works.


NodePath will use a String Path to the Node that you want to access from the Godot side of things, in C#. It takes care of actually getting the instance when you call the OnReady() function in C#.


using Godot;
using GodotSharpExtras;

public class MyNode : Container {
    Label MyLabel;
    public override void _Ready() {
      MyLabel.Text = "Hello World!";


ResolveNode allows an exported variable to the editor, to receive a NodePath, that can still be resolved to an actual node used within the C# code, as a reference to the node in the same way that NodePath is used. The difference is, the NodePath is an Assignment from the Editor, or code, instead of it being a string path to the node itself.


using Godot;
using GodotSharpExtras;

public class MyNode : Node2D {
  public string SpritePath;
  Sprite PlayerSprite;
  public override void _Ready() {
    PlayerSprite.Location = new Vector2(120,120);


When compiling using NodePath, and ResolveNode, the compiler will give a warning about a variable associated with these two attributes, will never be assigned to, or have a value. This is because the compiler doesn't recognize that we are using the Extension Method OnReady() to actually assign values to these variables, the way to surpress this warning, is simply to assign null to the value of the variable, to surpress this warning.


using Godot;
using GodotSharpExtras;

public class MyNode : Container {
  public Label MyLabel;
  public override void _Ready() {
    MyLabel.Text = "Hello World";

Will Generate this warning:

C:\MyProject\Label.cs (7,16): warning CS0649: Field 'ColorLabel.MarginContainer' is never assigned to, and will always have its default value null [C:\MyProject\MyProject.csproj]

While doing this will solve the issue:

using Godot;
using GodotSharpExtras;

public class MyNode : Container {
  public Label MyLabel = null;
  public override void _Ready() {
    MyLabel.Text = "Hello World";

Future items will be added as they are worked on.

Product Compatible and additional computed target framework versions.
.NET Framework net472 is compatible.  net48 was computed.  net481 was computed. 
Compatible target framework(s)
Additional computed target framework(s)
Learn more about Target Frameworks and .NET Standard.
  • .NETFramework 4.7.2

    • No dependencies.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories (1)

Showing the top 1 popular GitHub repositories that depend on GodotSharpExtras:

Repository Stars
A Project, Version and Addons/Plugins manager for Godot Game Engine.
Version Downloads Last updated
0.4.0 197 3/1/2023
0.4.0-beta.16 83 1/29/2023
0.4.0-beta.12 73 1/14/2023
0.4.0-beta.10 77 12/25/2022
0.4.0-beta.7 71 12/2/2022
0.4.0-beta.4 86 11/12/2022
0.3.6 349 11/3/2022 288 10/31/2022
0.3.4 507 7/16/2022
0.3.1 350 7/7/2022
0.3.0 343 6/30/2022
0.2.3 676 2/18/2022
0.2.2 339 2/18/2022
0.2.1 334 2/18/2022
0.2.0 344 2/17/2022
0.1.0 233 11/23/2021

Initial Release, Built against 3.3.0 assemblies.  Based on work by Sam Bloomberg.