本頁面由英文機器翻譯而成。閱讀英文原文。

部落格

用 AI 開發 Bevy 遊戲 — 在對話中建立、建置與檢視 Rust 遊戲

AI Game Developer 現在支援 Bevy。建立 Rust 遊戲、查看 cargo 的真實建置進度,並讓 AI 代理透過 BRP 查詢執行中的遊戲。

用 AI 開發 Bevy 遊戲 — 在對話中建立、建置與檢視 Rust 遊戲

Bevy 是以 Rust 撰寫的開放原始碼遊戲引擎,圍繞 Entity Component System 建構。它沒有編輯器:Bevy 遊戲就是一個 cargo crate,以程式碼撰寫並用 cargo 執行。AI Game Developer 是我們內建 AI 代理的桌面應用程式,現在支援 Bevy 專案。應用程式會為你建立新的 Bevy 遊戲,以進度卡片建置並執行它,顯示 cargo 的真實進度,並把代理連線到執行中的遊戲,讓它能檢視 ECS 世界的內部並加以變更。

本文說明應用程式會為 Bevy 專案做什麼、你需要自行安裝什麼,以及代理如何與執行中的遊戲協作。

用 AI 開發 Bevy 遊戲

Rust 與 Bevy 很適合 AI 代理。編譯器嚴格,錯誤訊息精確,代理很快就能了解哪裡出錯。ECS 把遊戲狀態保存在單純的元件中,可以列出與讀取。一直缺少的是程式碼之外的那個循環:啟動建置、知道遊戲真正在執行,以及不必從日誌猜測就能看見裡面的內容。

AI Game Developer 補上了這個循環。當資料夾的 Cargo.toml 依賴 bevy 且含有 src 資料夾時,它就會把該資料夾視為 Bevy 專案,此後這個專案就有「執行」按鈕、建置進度卡片,以及一組供代理使用的即時工具。

你需要什麼:Rust 與 cargo

應用程式不會替你安裝 Rust。Bevy 遊戲是用 cargo 建置的,所以請先用 rustup 從 https://rustup.rs 安裝一次 Rust 工具鏈。應用程式會在常見位置尋找 cargo:你的 CARGO_HOME、家目錄下預設的 .cargo/bin 資料夾,或你的 PATH;在 macOS 上這點很重要,因為從 Dock 啟動應用程式時看不到你 shell 的 PATH。若找不到 cargo,應用程式會明確告知並提供 rustup 連結,而不是以含糊的錯誤失敗。

Bevy 在某些平台上也有自己的系統需求,例如 Linux 上的圖形與音訊函式庫。請依你的作業系統遵循 Bevy 的安裝指南;當遊戲啟動後立刻停止時,應用程式會連同其日誌中的 panic 訊息一併告知你。

建立新的 Bevy 專案

你可以從桌面的建立專案對話框、用下方 create 指令從 CLI,或在對話中請代理建立 Bevy 專案。結果是一個小巧、可直接執行的 crate:

  • 一個 Cargo.toml,含有 Bevy 0.20 並啟用其 bevy_remote 功能,加上 Bevy 建議的開發 profile:你自己的程式碼編譯得快,相依套件則經過最佳化。
  • 一個 main.rs,加入 Bevy 的預設外掛、在應用程式傳入的連接埠上啟用 Remote Protocol 外掛,以及一個 2D 相機。
  • 一個 assets 資料夾,以及針對 target 資料夾的 .gitignore。
BashAI Game Developer CLI
/create-project bevy my-game

已經有 Bevy 遊戲了嗎?開啟它的資料夾即可。應用程式的 Bevy 外掛安裝會在你的 Cargo.toml 中加入 bevy_remote 功能。它絕不會編輯你的 Rust 原始碼:若你的應用程式尚未加入遠端外掛,應用程式會顯示要加入的那一行,而代理可以在你要求時替你加入。

查看真實的 cargo 建置進度

Bevy 遊戲的首次建置要編譯數百個 crate,可能花上好幾分鐘。不知道發生什麼事地等待是最難熬的部分,所以應用程式會把它顯示出來。當你按下「執行」,應用程式會在背景執行 cargo run,並從日誌讀取 cargo 自己的進度條。進度卡片接著以真實數字顯示每個步驟:更新 crate 索引、下載遊戲的 crate,以及以已完成與總計建置單元及 cargo 自己回報的百分比進行編譯。沒有任何估算。

建置進度卡片的示意圖:正在編譯遊戲,480 個單元中已完成 308 個,64%,接著遊戲啟動,代理的工具連上
示意圖:應用程式從 cargo 讀取的建置進度,以及隨後的即時工具

建置完成後,卡片會顯示遊戲正在啟動,並等到它真正執行。如果 cargo 因編譯錯誤而停止,卡片會顯示錯誤行與完整日誌的路徑。如果遊戲在啟動後立刻 panic,例如因為缺少某個系統函式庫,你會看到 panic 訊息,而不是遊戲默默消失。之後的建置是增量的,快得多。

每個專案只執行一次:遊戲執行中再按「執行」會顯示它,而不是啟動第二份。關閉對話不會停止你的遊戲,因為你可能還在玩。

代理透過 BRP 與你的遊戲對話

Bevy 內建 Bevy Remote Protocol,簡稱 BRP:透過 HTTP 的 JSON-RPC,讓另一個程式查詢並變更執行中應用程式的 ECS 世界。AI Game Developer 將它作為即時連線,且僅限你自己的機器(127.0.0.1)。當代理連線到 Bevy 專案時,會取得這些工具:

  • discover 列出執行中遊戲所提供的遠端方法。
  • query 依實體擁有或不擁有的元件尋找實體,並回傳元件值。
  • get_components 讀取單一實體所選的元件。
  • list_components 列出單一實體的元件,或遊戲註冊的每個元件型別。
  • call 執行任何其他 BRP 方法,例如生成或移除實體、插入或變更元件,或讀寫資源。

這讓代理得到事實而非猜測。問「敵人為什麼不動?」,代理就能在遊戲執行時查詢敵人的 Transform 與 velocity 元件、變更某個值來測試想法,然後修正程式碼。這些工具使用目前 Bevy 版本的方法名稱,並會回退到 Bevy 0.15 與 0.16 使用的舊名稱。

多個 Bevy 專案可以同時執行。應用程式會為它啟動的每個遊戲分配自己的 BRP 連接埠,且只與它為該專案啟動的遊戲通訊,把 Bevy 的預設連接埠留給你自行啟動的遊戲。

須知

  • Bevy 遊戲照慣例在自己的原生視窗中開啟。應用程式不會在你閒置時停止它;重新啟動或與代理斷線才會使它停止。
  • 代理的工具只能看到 BRP 所暴露的內容:支援 reflection 的元件與資源。在你自己的元件與資源上 derive Reflect,才能讓它們可見。
  • Bevy 自身的 MIT 或 Apache-2.0 授權同樣適用於你的遊戲,就像沒有這個應用程式時一樣。

開始使用

用 rustup 安裝 Rust,從 ai-game.dev/download 下載 AI Game Developer,建立 Bevy 專案並按下「執行」。首次建置執行時,向代理描述你想要的遊戲。更多關於應用程式的資訊在 ai-game.dev/docs/app。想改為建置瀏覽器版本?請閱讀 ai-game.dev/blog/threejs-game-development-with-ai 關於 Three.js 支援的說明,以及 ai-game.dev/blog/brutal-dotnet-game-development-with-ai 關於 BRUTAL C# 框架的介紹。

圖片版權:Bevy 鳥標誌來自 Bevy 儲存庫(MIT OR Apache-2.0);它代表該引擎,仍屬 Bevy 所有。插圖由 AI Game Developer 製作。

更多部落格文章

所有文章