Up to date

This page is up to date for Godot 4.2. If you still find outdated information, please open an issue.

C# 全局类

全局类(也称为命名脚本)是在 Godot 编辑器中注册的类型,可以更方便地使用。这些类会出现在 添加节点创建资源 对话框中,而 导出属性 只能用于全局类或其派生类的实例。全局类使用 [GlobalClass] 特性注册。

using Godot;

[GlobalClass]
public partial class MyNode : Node
{
}

MyNode 类型将被注册为一个全局类,其名称与类型的名称相同。

../../../_images/globalclasses_addnode.webp

[Icon] 特性还允许提供图标的路径,以便在编辑器中作为类的图标使用。

using Godot;

[GlobalClass, Icon("res://Stats/StatsIcon.svg")]
public partial class Stats : Resource
{
    [Export]
    public int Strength { get; set; }

    [Export]
    public int Defense { get; set; }

    [Export]
    public int Speed { get; set; }
}
../../../_images/globalclasses_createresource.webp

Stats 类是一个注册为全局类的自定义资源。导出属性 类型为 Stats 的属性将仅允许分配此资源类型的实例,并且检查器将允许你轻松创建和加载此类型的实例。

../../../_images/globalclasses_exportedproperty1.webp ../../../_images/globalclasses_exportedproperty2.webp