教程一 · 第 2 章：核心心智模型——节点、场景、脚本#

1
Node（最基础：无位置概念，适合做逻辑控制器/管理器）
2
└── CanvasItem（能画在 2D 画布上）
3
    ├── Node2D（有位置/旋转/缩放，2D 万物之基）
4
    │   ├── CharacterBody2D    角色身体（玩家、敌人，自己控制移动）
5
    │   ├── RigidBody2D       刚体（受物理力控制，会翻滚、弹跳）
6
    │   ├── StaticBody2D      静态碰撞体（地面、墙壁）
7
    │   ├── Area2D            区域（触发器：拾取物、伤害区、传感器）
8
    │   ├── Sprite2D          贴图
9
    │   ├── CollisionShape2D  碰撞形状（给上面那些 body 配形状）
10
    │   ├── Camera2D          摄像机
11
    │   └── AnimationPlayer   动画播放器
12
    └── Control（UI 体系：按钮、血条、菜单的基类）
13
        ├── Button / Label / ColorRect
14
        └── Control 容器（HBoxContainer、VBoxContainer……）

1
Player（CharacterBody2D）        ← 负责移动逻辑
2
├── Sprite2D                     ← 负责显示贴图
3
├── CollisionShape2D             ← 负责碰撞形状
4
├── Camera2D                     ← 负责跟随
5
└── AnimationPlayer              ← 负责播放动画

1
main.tscn            主场景（关卡）
2
├── TileMap / 地面 StaticBody
3
├── Player（实例 player.tscn）
4
├── Enemy × N（实例 enemy.tscn）
5
├── SpawnPoint（Marker2D）
6
└── HUD（实例 hud.tscn）

1
using Godot;
2

3
// 挂在 CharacterBody2D 节点上：这个脚本就能用 Velocity、MoveAndSlide()
4
public partial class Player : CharacterBody2D
5
{
6
    public override void _Ready() { }
7
}

1
// 挂在 Button 上：就能用 Pressed 事件、Text 属性
2
public partial class StartButton : Button { }

1
// 挂在 Node 上：纯逻辑管理器（计分板、游戏流程）
2
public partial class GameManager : Node { }

1
public override void _Ready()
2
{
3
    // 节点和它的所有子节点都进入场景后，执行一次
4
    // 用来：初始化变量、找子节点、连接信号、读存档
5
}
6

7
public override void _Process(double delta)
8
{
9
    // 每帧渲染前执行；delta = 上一帧经过的秒数
10
    // 用来：非物理移动、UI 更新、计时器累加
11
}
12

13
public override void _PhysicsProcess(double delta)
14
{
15
 // 固定帧率（默认每秒 60 次）调用
16
    // 用来：所有物理相关——角色移动、碰撞、射线检测
17
}

1
private double _timer;
2

3
public override void _Process(double delta)
4
{
5
    _timer += delta;          // 按真实秒数累加，与帧率无关
6
    Position += Vector2.Right * 100f * (float)delta; // 每秒右移 100 像素
7
}

1
Main
2
├── Player
3
│   └── Sprite2D
4
└── Enemies
5
    └── Enemy1

1
private Sprite2D _sprite;
2

3
public override void _Ready()
4
{
5
    // 写法 A：GetNode<T>("路径")
6
    _sprite = GetNode<Sprite2D>("Sprite2D");
7

8
    // 写法 B：[Export] 在编辑器里拖拽指定，解耦、推荐给可变结构
9
}

1
[Export] public float MoveSpeed = 300f;
2
[Export] private PackedScene _bulletScene;  // 拖入 bullet.tscn
3
[Export] public NodePath TargetPath;       // 拖入任意节点的路径

1
// 全场景找所有 enemy
2
foreach (Node enemy in GetTree().GetNodesInGroup("enemy"))
3
{
4
    GD.Print(enemy.Name);
5
}

1
GetParent();                 // 父节点
2
GetTree().CurrentScene;      // 当前主场景根
3
GetTree().Root;              // 整个游戏窗口的最底层 Viewport

1
public partial class Player : CharacterBody2D
2
{
3
    // 声明自定义信号（命名用过去式：事件"已经发生"）
4
    [Signal] public delegate void HealthChangedEventHandler(int current, int max);
5
    [Signal] public delegate void DiedEventHandler();
6

7
    private int _hp = 100;
8

9
    public void TakeDamage(int amount)
10
    {
11
        _hp -= amount;
12
        EmitSignal(SignalName.HealthChanged, _hp, 100); // 发射
13
        if (_hp <= 0) EmitSignal(SignalName.Died);
14
    }
15
}

1
public override void _Ready()
2
{
3
    var player = GetNode<Player>("../Player");
4
    player.HealthChanged += OnHealthChanged;   // C# 事件式订阅，最常用
5
}
6

7
private void OnHealthChanged(int current, int max)
8
{
9
    Text = $"HP {current}/{max}";
10
}

1
using Godot;
2

3
public partial class MoveDemo : Node2D
4
{
5
    [Export] public float Speed = 300f;
6

7
    public override void _Process(double delta)
8
    {
9
        Vector2 dir = Input.GetVector("ui_left", "ui_right", "ui_up", "ui_down");
10
        Position += dir * Speed * (float)delta;
11
        QueueFree();  // ← 先别写这行，下章讲；这里只演示移动
12
    }
13
}