教程一 · 第 7 章：UI 与游戏流程#

1
MainMenu（Control，Layout = Full Rect）
2
└── CenterContainer（Full Rect）
3
    └── VBoxContainer
4
        ├── Label "我的游戏"（大字号）
5
        ├── Button "开始游戏"
6
        ├── Button "设置"
7
        └── Button "退出"

1
using Godot;
2

3
public partial class MainMenu : Control
4
{
5
    public override void _Ready()
6
    {
7
        GetNode<Button>("CenterContainer/VBox/StartButton").Pressed += OnStart;
8
        GetNode<Button>("CenterContainer/VBox/SettingsButton").Pressed += OnSettings;
9
        GetNode<Button>("CenterContainer/VBox/QuitButton").Pressed += OnQuit;
10
    }
11

12
    private void OnStart()
13
    {
14
        GetTree().ChangeSceneToFile("res://scenes/level1.tscn");
15
    }
16

17
    private void OnSettings()
18
    {
19
        GetNode<Control>("SettingsPanel").Visible = true;
20
    }
21

22
    private void OnQuit()
23
    {
24
        GetTree().Quit();
25
        // 注意：编辑器里运行时 Quit 不会关编辑器窗口，这是正常的（发布版才退出游戏）
26
    }
27
}

1
HUD（CanvasLayer）
2
└── MarginContainer（Top Wide，四周 16px 边距）
3
    └── HBoxContainer
4
        ├── Label "HP"
5
        ├── TextureProgressBar（或 ProgressBar）命名 HpBar，Min=0 Max=100
6
        └── Label 命名 CoinLabel

1
public partial class HUD : CanvasLayer
2
{
3
    private ProgressBar _hpBar = null!;
4
    private Label _coinLabel = null!;
5

6
    public override void _Ready()
7
    {
8
        _hpBar = GetNode<ProgressBar>("MarginContainer/HBox/HpBar");
9
        _coinLabel = GetNode<Label>("MarginContainer/HBox/CoinLabel");
10

11
        var player = GetTree().GetFirstNodeInGroup("player");
12
        if (player is Player p)
13
        {
14
            p.HealthChanged += hp => _hpBar.Value = hp;
15
        }
16

17
        if (GameManager.Instance != null)
18
            GameManager.Instance.CoinsChanged += c => _coinLabel.Text = $"金币 {c}";
19
    }
20
}

1
CreateTween()
2
    .TweenProperty(_hpBar, "value", (double)hp, 0.25f)
3
    .SetTrans(Tween.TransitionType.Quad)
4
    .SetEase(Tween.EaseType.Out);

1
// 面板淡入（需要面板 Modulate 初始 alpha=0）
2
panel.Modulate = panel.Modulate with { A = 0f };
3
panel.Show();
4
CreateTween().TweenProperty(panel, "modulate:a", 1f, 0.2f);
5

6
// 伤害数字飘起淡出
7
var label = ...;
8
var tween = CreateTween();
9
tween.SetParallel(true);
10
tween.TweenProperty(label, "position:y", label.Position.Y - 60f, 0.8f);
11
tween.TweenProperty(label, "modulate:a", 0f, 0.8f);
12
tween.Chain().TweenCallback(Callable.From(label.QueueFree));

1
public partial class PauseMenu : CanvasLayer
2
{
3
    public override void _Ready() => Visible = false;
4

5
    public override void _UnhandledInput(InputEvent @event)
6
    {
7
        if (Input.IsActionJustPressed("pause")) // 自己加个输入动作绑 Esc
8
            Toggle();
9
    }
10

11
    private void Toggle()
12
    {
13
        bool paused = !GetTree().Paused;
14
        GetTree().Paused = paused;
15
        Visible = paused;
16
    }
17
}

1
GetNode<Button>("Panel/ResumeButton").GrabFocus();

1
public partial class SceneManager : Node
2
{
3
    [Signal] public delegate void GameStateChangedEventHandler(StringName state);
4

5
    public StringName State { get; private set; } = "boot";
6

7
    public void SetState(StringName newState)
8
    {
9
        State = newState;
10
        EmitSignal(SignalName.GameStateChanged, newState);
11
        GetTree().Paused = newState is "paused" or "gameover";
12
    }
13

14
    public async void ChangeScene(string path)
15
    {
16
        SetState("loading");
17
        // 这里可以弹一个过场画面
18
        await ToSignal(GetTree(), SceneTree.SignalName.ProcessFrame);
19
        GetTree().Paused = false;
20
        GetTree().ChangeSceneToFile(path);
21
    }
22
}

1
public partial class TransitionLayer : CanvasLayer
2
{
3
    private ColorRect _fade = null!;
4

5
    public override void _Ready()
6
    {
7
        _fade = new ColorRect { Color = new Color(0,0,0,0), MouseFilter = Control.MouseFilterEnum.Ignore };
8
        _fade.SetAnchorsPreset(Control.LayoutPreset.FullRect);
9
        AddChild(_fade);
10
    }
11

12
    public async Task FadeToScene(string path, float time = 0.3f)
13
    {
14
        _fade.MouseFilter = Control.MouseFilterEnum.Stop; // 挡住误操作
15
        await CreateTween().TweenProperty(_fade, "color:a", 1f, time).ToSignal(Tween.SignalName.Finished);
16
        GetTree().ChangeSceneToFile(path);
17
        await ToSignal(GetTree(), SceneTree.SignalName.ProcessFrame);
18
        await CreateTween().TweenProperty(_fade, "color:a", 0f, time).ToSignal(Tween.SignalName.Finished);
19
        _fade.MouseFilter = Control.MouseFilterEnum.Ignore;
20
    }
21
}