C# Source Generators for use with the Godot Game Engine - NB: Version 2.7 introduces an ever so slight [BREAKING CHANGE] in that scope strings have been replaced with a more definitive enum set. - NB: Version 2.7 introduces an ever so slight [BREAKING CHANGE] in that the Autoload class must now be explicitly decorated instead of implicitly generated. - NB: Version 2.7 introduces an ever so slight [BREAKING CHANGE] in that identifiers comprised of unicode characters no longer need to be prefixed with `_` and other invalid characters are now removed instead of being replaced with `_`. * `SceneTree` class attribute: -- Provides strongly typed access to the scene hierarchy (via `_` operator) -- Generates direct access to uniquely named nodes via class properties * [NEW] ISceneTree interface for use with generics (GD4 only) -- Provides static access to TscnFilePath * [NEW] IInstantiable interface for use with generics (GD4 only) -- Provides static Instantiate method * [NEW] Custom default scope for uniquely named node properties -- Specific properties can be overridden with a partial property (GD4 only) * [NEW] `AnimNames` class attribute (GD4 only): -- Provides strongly typed access to animation names defined in .tres and .tscn files * [NEW] `AudioBus` class attribute (GD4 only): -- Provides strongly typed access to audio bus names and ids * [NEW] `AutoEnum` enum/class attribute (GD4 only): -- (enum) Generates efficient Str/Parse for enums -- (class) Generates enum for static data classes (for editor/network use) * `Autoload` class attribute: -- Provide strongly typed access to autoload nodes defined in godot.project * `CodeComments` class attribute: -- Provides a nested static class to access property comments from code (useful for in-game tooltips, etc) * [NEW] `GlobalGroups` class attribute (GD4 only): -- Provides strongly typed access to global groups defined in godot.project * `GodotOverride` method attribute: -- Allows use of On*, instead of virtual _* overrides -- (Requires partial method declaration for use with Godot 4) * `InputMap` class attribute: -- Provides strongly typed access to input actions defined in godot.project -- Attribute option to replace StringName with your own custom object/handler * [NEW] `Instantiable` class attribute (GD4 only): -- Generates configurable static method(s) to instantiate scene * `LayerNames` class attribute: -- Provide strongly typed access to layer names defined in godot.project * `Notify` property attribute: -- Generates boiler plate code, triggering only when values differ -- (Automagically triggers nested changes for Resource and Resource[]) * `OnImport` method attribute (GD4 only): -- Generates default plugin overrides and options to make plugin class cleaner (inherit from OnImportEditorPlugin) -- (This will be removed in next major release) * `OnInstantiate` method attribute: -- Generates a static Instantiate method with matching args that calls attributed method as part of the instantiation process -- (Also generates a protected constructor to ensure proper initialisation - can be deactivated via attribute) -- (This will be removed in favour of `Instantiable` in next major release) * [NEW] `ResourceTree` class attribute (GD4 only): -- Provides strongly typed access to the resource hierarchy * [NEW] Generators for `Rpc` methods (GD4 only): -- Provides strongly typed access to Rpc and RpcId methods * [NEW] `Shader` class attribute (GD4 only): -- Provides strongly typed access to shader uniforms (or visual shader parameters) * [NEW] `ShaderGlobals` class attribute (GD4 only): -- Provides strongly typed access to global shader uniforms defined in godot.project * [NEW] `Singleton` class attribute (GD4 only): -- Provides single instance access to data or scene objects * [NEW] `TR` class attribute (GD4 only): -- Provides strongly typed access to translation locales and keys (as defined in csv) * Includes base classes/helpers to create project specific source generators