GodotUtils.InstanceResolver 1.2.0

Godot Utilities

Instance Resolver

Package for Godot C#. Provides a convenience and reliable way to pass parameters for Instantiate<Node>() from PackScene

<details open> <summary>Main Usage</summary>

using Godot;
using GodotUtils.InstanceResolver;

namespace YourCompany.YourGame;

[Resolvable]
public partial class Bullet : RigidBody2D
{
    // You can disable warning by using 'null!' or '#pragma warning disable CS8618'
    [Parameter]
    private long _damage;

    [Parameter]
    private int _speed = 100;

    [Parameter]
    private Texture Texture { get; set; } = null!;

    // game logic...
}

Above code will generate a partial class below

// <auto-generated/>
#pragma warning disable
#nullable enable
namespace GodotUtils.InstanceResolver.Roslyn.Sample
{
    partial class Bullet : global::GodotUtils.InstanceResolver.__Internal.IResolvableNode<Bullet, Bullet.ParametersBuilder>
    {
        public class ParametersBuilder : global::GodotUtils.InstanceResolver.__Internal.IParametersBuilder<Bullet>
        {
            public required long Damage { get; set; }

            private readonly global::GodotUtils.InstanceResolver.__Internal.Models.OptionalValue<int> _speedValue = new();
            public bool IsSpeedInitialized() => _speedValue.IsInitialized;
            public int Speed
            {
                get => _speedValue.Value;
                set
                {
                    _speedValue.Set(value);
                }
            }

            public required global::Godot.Texture Texture { get; set; }
        }

        public Bullet Build(ParametersBuilder parameters)
        {
            _damage = parameters.Damage;
            if (parameters.IsSpeedInitialized())
            {
                _speed = parameters.Speed;
            }

            Texture = parameters.Texture;
            return this;
        }
    }

    public class BulletPackedScene : global::GodotUtils.InstanceResolver.__Internal.IResolverPackedScene<Bullet, Bullet.ParametersBuilder>
    {
        public BulletPackedScene(string path, string? typehint = null, global::Godot.ResourceLoader.CacheMode cacheMode = global::Godot.ResourceLoader.CacheMode.Reuse)
        {
            Value = global::Godot.ResourceLoader.Load<global::Godot.PackedScene>(path, typehint, cacheMode);
        }

        public global::Godot.PackedScene Value { get; }
    }
}

And then you use this code to Instantiate node

readonly BulletPackedScene BULLET_SCENE = new("<<uid_or_path_of_node_scene>>");

var bullet = BULLET_SCENE.Instantiate(new() { Damage = 10, Texture = texture });

</details>