分數與重玩

在這一部分中，我們會新增計分、播放音樂、重啟遊戲的能力。

我們要用一個變數來記錄目前的分數，使用最簡的介面在螢幕上顯示。我們會用文字標籤來實作。

在主場景中，新增一個子節點： Control 到 Main，並將其命名為 UserInterface。請確認您位於 2D 編輯畫面，您可以在此編輯使用者介面（UI）。

新增一個 Label 節點並命名為 ScoreLabel

在*屬性檢視器*中將該 Label 的 Text 設為類似“Score: 0”的占位元內容。

並且，文字預設是白色的，和我們的遊戲背景一樣。我們需要修改它的顏色，才能在運作時看到。

捲動到 主題覆寫（Theme Overrides），展開 顏色（Colors） 並啟用 字體顏色（Font Color） ，以將文字設為黑色（和白色 3D 場景有良好對比）

最後按一下視口中的文字，將其拖離左上角。

UserInterface 節點讓我們可以將 UI 組合到場景樹的一個分支上，並且也讓主題資源能夠傳播到它的所有子節點上。我們將會用它來設定遊戲的字形。

建立內容

再次選中 UserInterface 節點。在*屬性檢視器*中為 Theme -> Theme 建立一個新的主題資源。

按一下這個資源就會在底部面板中打開主題編輯器。會展示使用你的主題資源時內建 UI 控制項的外觀。

預設情況下，一個佈景主題只有幾個屬性：預設基礎縮放、預設字型 和 預設字型大小。

也參考

你可以為主題資源新增更多屬性，從而設計更複雜的使用者介面，不過這就超出本系列的範疇了。要學習主題的建立和編輯，請參閱 GUI 換膚入門。

「預設字型」需要的是您電腦上擁有的字型檔案。兩種常見的字型檔案格式是 TrueType 字型 (TTF) 和 OpenType 字型 (OTF)。

在*檔案系統*面板中，展開 fonts 目錄，按一下我們包含在專案裡的 Montserrat-Medium.ttf 檔案並將其拖放到*Default Font*（預設字形）上。文字就又會出現在主題預覽中了。

文字有一點小。將*Default Font Size*（預設字形大小）設定為 22 像素即可增大文字的大小。

追蹤得分

接下來處理分數。將一個新的腳本附加到 ScoreLabel 上，並定義 score 變數。

extends Label

var score = 0

using Godot;

public partial class ScoreLabel : Label
{
    private int _score = 0;
}

每踩扁一隻怪物，這個分數就應該加 1。我們可以使用它們的 squashed 訊號來得知發生的時間。不過，因為我們是用程式碼產生實體的怪物，我們無法在編輯器中將怪物的訊號連接到 ScoreLabel。

不過，我們可以在每次生成一隻怪物時通過程式碼來進行連接。

打開 main.gd 腳本。如果它還開著，你可以在腳本編輯器左欄中點擊它的名字。

另一種方法是在*檔案系統*面板中按兩下 main.gd 檔案。

在 _on_mob_timer_timeout() 函式的最後新增下面這行程式碼:

func _on_mob_timer_timeout():
    #...
    # We connect the mob to the score label to update the score upon squashing one.
    mob.squashed.connect($UserInterface/ScoreLabel._on_mob_squashed.bind())

private void OnMobTimerTimeout()
{
    // ...
    // We connect the mob to the score label to update the score upon squashing one.
    mob.Squashed += GetNode<ScoreLabel>("UserInterface/ScoreLabel").OnMobSquashed;
}

這一行的意思是，當小怪發出 squashed 訊號時，ScoreLabel 節點就會接收到並呼叫 _on_mob_squashed() 函式。

回到 score_label.gd 腳本，定義 _on_mob_squashed() 回呼函式。

這裡我們將進行加分並更新顯示的文字。

func _on_mob_squashed():
    score += 1
    text = "Score: %s" % score

public void OnMobSquashed()
{
    _score += 1;
    Text = $"Score: {_score}";
}

第二行用 score 變數的值替換預留位置 %s。使用此功能時，Godot 會自動將值轉換為字串文字，這在向標籤中輸出文字或者使用 print() 函式時非常方便。

也參考

你可以在 GDScript 格式化字串了解更多字串格式化的資訊。在 C# 中，建議參考使用 "$" 的字串插值。

你現在可以玩遊戲，壓死幾個敵人，看看分數的增長。

備註

在一個複雜的遊戲中，你可能想把你的使用者介面與遊戲世界完全分開。在這種情況下，你就不會在標籤上記錄分數了。相反，你可能想把它儲存在一個單獨的、專門的物件中。但當原型設計或你的專案很簡單時，保持你的程式碼簡單就可以了。程式設計總是一種平衡的行為。

執行遊戲

我們現在就要新增死亡後重玩的能力。玩家死亡後，我們會在螢幕上現實一條消息並等待輸入。

回到 main.tscn 場景，選擇 UserInterface 節點，新增一個子節點 ColorRect，並命名為 Retry。這個節點會用單一顏色填滿一個矩形，並將作為覆蓋層來使畫面變暗。

要使其覆蓋整個視口，可以使用工具列中 錨點預設 功能表。

點擊打開，並應用*整個矩形*命令。

什麼都沒發生。好吧，是幾乎什麼都沒有；只有四個綠色的大頭針移動到了選擇框的四個角落。

這是因為 UI 節點（圖示都是綠色）使用的是錨點和邊距，它們都相對於它們父節點包圍框。這裡的 UserInterface 節點比較小，所以 Retry 會受限於它。

選中 UserInterface 然後也對其使用*錨點預設 -> 整個矩形*。Retry 節點就應該覆蓋整個視口了。

讓我們修改它的顏色，把遊戲區域變暗。選中 Retry，在*屬性檢視器*中將 Color*（顏色）設定為透明的暗色。要實作整個效果，可以在取色器中將 *A 滑動條拖到左邊。它控制的是顏色的 Alpha 通道，也就是不透明度。

接著，在 Retry 節點下新增一個 Label 子節點，並將它的 Text 屬性設為「按下 Enter 鍵重新嘗試」。為了將它移動並錨定在畫面中央，對它套用 錨點預設 -> 居中。

複寫建置選項

我們現在就可以去編寫程式碼，在玩家死亡時顯示 Retry 節點，重玩時隱藏。

打開 main.gd 腳本。首先，我們想要在遊戲開始時隱藏覆蓋層。將這一行加到 _ready() 函式中。

func _ready():
    $UserInterface/Retry.hide()

public override void _Ready()
{
    GetNode<Control>("UserInterface/Retry").Hide();
}

然後在玩家受到攻擊時，我們就顯示這個覆蓋層。

func _on_player_hit():
    #...
    $UserInterface/Retry.show()

private void OnPlayerHit()
{
    //...
    GetNode<Control>("UserInterface/Retry").Show();
}

最後，當 Retry 節點可見時，我們需要監聽玩家的輸入，按下確認鍵時讓遊戲重啟。可以使用內建的 _unhandled_input() 回呼函式來實作，任何輸入都會觸發這個回呼函式。

如果玩家按下了預設的 ui_accept 輸入動作並且 Retry 是可見狀態，我們就重新載入目前場景。

func _unhandled_input(event):
    if event.is_action_pressed("ui_accept") and $UserInterface/Retry.visible:
        # This restarts the current scene.
        get_tree().reload_current_scene()

public override void _UnhandledInput(InputEvent @event)
{
    if (@event.IsActionPressed("ui_accept") && GetNode<Control>("UserInterface/Retry").Visible)
    {
        // This restarts the current scene.
        GetTree().ReloadCurrentScene();
    }
}

我們可以通過 get_tree() 函式存取全域 SceneTree 物件，然後用它來重新載入並重啟目前場景。

新增腳本

要新增音樂，讓音樂在後臺連續播放，我們就要用到 Godot 的另一項功能：自動載入。

要播放音訊，只需往場景裡新增一個 AudioStreamPlayer 節點，然後為它附加一個音訊檔。啟動場景時，就會自動播放。然而，如果重新載入了場景，比如我們在重玩的時候就這麼幹了，這些音訊節點也會被重設，音樂也就會從頭開始播放。

你可以使用自動載入功能來讓 Godot 在遊戲開始時自動載入節點或場景，不依賴於目前場景。你還可以用它來建立能夠全域存取的物件。

在*場景*功能表中按一下*新建場景*，或者使用目前打開的場景旁邊的 + 圖示來建立一個新場景。

點擊「建立其他節點」按鈕來建立一個 AudioStreamPlayer，並將其重新命名為 MusicPlayer。

我們在 art/ 目錄中包含了一條音樂音軌 House In a Forest Loop.ogg。按一下並把它拖放到*屬性檢視器*中的 Stream*（流）屬性上。同時要打開 *Autoplay，這樣音樂就會在遊戲開始時自動播放了。

將場景儲存為 music_player.tscn。

我們必須將它註冊為自動載入。前往 專案 -> 專案設定… 選單，然後點擊 全域 -> 自動載入 分頁。

在「路徑」欄位中，您需要輸入您的場景路徑。點擊資料夾圖示開啟檔案瀏覽器，然後雙擊 music_player.tscn。接著，點擊右側的「新增」按鈕以註冊節點。

music_player.tscn 現在會載入到您開啟或遊玩的任何場景中。所以如果您現在執行遊戲，音樂會在任何場景中自動播放。

在這一節課結束之前，我們來看一下在底層發生了什麼。運作遊戲時，你的*場景*面板會多出來兩個分頁：遠端*和*本地。

你可以在*遠端*分頁中查看運作中的遊戲的節點樹。你會看到 Main 節點以及場景中所包含的所有東西，最底部是產生實體的小怪。

頂部的是自動載入的 MusicPlayer 以及一個 root 節點，這是你的遊戲的視口。

這一節課就是這樣。在下一部分，我們會新增動畫，讓遊戲更美觀。

這是完整的 main.gd 腳本，僅供參考。

extends Node

@export var mob_scene: PackedScene

func _ready():
    $UserInterface/Retry.hide()


func _on_mob_timer_timeout():
    # Create a new instance of the Mob scene.
    var mob = mob_scene.instantiate()

    # Choose a random location on the SpawnPath.
    # We store the reference to the SpawnLocation node.
    var mob_spawn_location = get_node("SpawnPath/SpawnLocation")
    # And give it a random offset.
    mob_spawn_location.progress_ratio = randf()

    var player_position = $Player.position
    mob.initialize(mob_spawn_location.position, player_position)

    # Spawn the mob by adding it to the Main scene.
    add_child(mob)

    # We connect the mob to the score label to update the score upon squashing one.
    mob.squashed.connect($UserInterface/ScoreLabel._on_mob_squashed.bind())

func _on_player_hit():
    $MobTimer.stop()
    $UserInterface/Retry.show()

func _unhandled_input(event):
    if event.is_action_pressed("ui_accept") and $UserInterface/Retry.visible:
        # This restarts the current scene.
        get_tree().reload_current_scene()

using Godot;

public partial class Main : Node
{
    [Export]
    public PackedScene MobScene { get; set; }

    public override void _Ready()
    {
        GetNode<Control>("UserInterface/Retry").Hide();
    }

    public override void _UnhandledInput(InputEvent @event)
    {
        if (@event.IsActionPressed("ui_accept") && GetNode<Control>("UserInterface/Retry").Visible)
        {
            // This restarts the current scene.
            GetTree().ReloadCurrentScene();
        }
    }

    private void OnMobTimerTimeout()
    {
        // Create a new instance of the Mob scene.
        Mob mob = MobScene.Instantiate<Mob>();

        // Choose a random location on the SpawnPath.
        // We store the reference to the SpawnLocation node.
        var mobSpawnLocation = GetNode<PathFollow3D>("SpawnPath/SpawnLocation");
        // And give it a random offset.
        mobSpawnLocation.ProgressRatio = GD.Randf();

        Vector3 playerPosition = GetNode<Player>("Player").position;
        mob.Initialize(mobSpawnLocation.Position, playerPosition);

        // Spawn the mob by adding it to the Main scene.
        AddChild(mob);

        // We connect the mob to the score label to update the score upon squashing one.
        mob.Squashed += GetNode<ScoreLabel>("UserInterface/ScoreLabel").OnMobSquashed;
    }

    private void OnPlayerHit()
    {
        GetNode<Timer>("MobTimer").Stop();
        GetNode<Control>("UserInterface/Retry").Show();
    }
}