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

部落格

用 AI 開發 Three.js 遊戲 — 在對話視窗旁打造並遊玩網頁遊戲

AI Game Developer 現在能建立 Three.js 網頁遊戲,在對話視窗旁的即時遊戲面板中執行,並讓 AI 代理觀看、遊玩與測試。

用 AI 開發 Three.js 遊戲 — 在對話視窗旁打造並遊玩網頁遊戲

AI Game Developer 是我們內建 AI 代理的桌面應用程式,現在支援全新的引擎:Web (Three.js)。你可以從應用程式、命令列,或直接請代理建立 three.js 遊戲,遊戲會在對話視窗旁的即時面板中執行。代理不只會寫程式碼:它還能查看執行中的遊戲、按下按鍵、擷取螢幕畫面並執行遊玩測試,因此「改點東西、看看結果、修正」的循環都在同一個視窗裡完成。

本文說明 Three.js 支援的功能、新專案如何開始,以及你和代理如何一起在同一個執行中的遊戲上工作。

用 AI 開發 Three.js 遊戲

Three.js 是網頁上最受歡迎的 3D 函式庫之一。three.js 遊戲就是一個網頁:用 TypeScript 程式碼建立場景、相機和影格迴圈,由開發伺服器提供,並在瀏覽器中遊玩。這讓它非常適合與 AI 代理一起工作。每個變更都是單純的程式碼,頁面瞬間重新載入,遊戲也能在任何有瀏覽器的地方開啟。

通常卡住的是程式碼周邊的設定:安裝正確的 Node.js、建立專案、啟動開發伺服器,然後把螢幕截圖和錯誤訊息複製回對話中。AI Game Developer 處理了這一塊,所以對話可以專注在遊戲本身。

用起始場景建立專案

建立 Web (Three.js) 專案有三種方式,結果都一樣:一個 three.js + Vite + TypeScript 專案,裡面沒有任何多餘的東西。遊戲需要什麼函式庫,代理會自己加上。

  • 在桌面應用程式中開啟建立專案對話框,然後選擇 Web (Three.js)。
  • 在 AI Game Developer CLI 中,執行下方顯示的 create 指令。
  • 在任何對話中請代理建立一個 three.js 遊戲;它會使用同一個建立步驟。
BashAI Game Developer CLI
/create-project threejs my-game --starter island

每個新專案都從起始範本開始。Empty 是一張空白白頁,含有 canvas、場景、相機和影格迴圈,等著你實現自己的想法。四個範例場景則提供好看的基礎讓你繼續發展:Studio,打光台座上一個閃亮的扭結;Blueprint,畫在藍圖紙上的機加工零件;Checker,帶有座標軸和簡單形狀的棋盤地板;以及 Island,黎明時分的低多邊形漂浮島嶼。每個範例都在程式碼開頭說明該替換成你的遊戲的部分,並把所有可調數值集中在同一個設定物件中,讓你和代理都知道從哪裡開始。

四個範例起始場景:Studio、Blueprint、Checker 和 Island
範例起始場景:Studio、Blueprint、Checker 和 Island

已經在用 Unity、Godot 或 Unreal Engine 了嗎?應用程式可以在該專案中建立網頁原型,放在引擎不會匯入的 WebPrototypes 資料夾。這是在主遊戲中實作之前,先在瀏覽器裡試玩某個機制的好方法。

Node.js 已為你準備好

網頁遊戲需要 Node.js 和 npm。你不必自己安裝。應用程式會從 nodejs.org 下載它自己的 Node.js,用官方公布的 SHA-256 校驗碼檢查,並存放在自己的資料夾中,與你機器上既有的 Node.js 分開。這件事會在應用程式啟動後不久於背景進行,所以第一個遊戲通常不必等下載。

當你或代理在專案中執行 npm 時,用的是應用程式的 npm 與應用程式的設定。如果你在企業代理伺服器或私有 registry 後面工作,你自己 npm 設定中的相關設定(registry、proxy、憑證與認證資訊)會一併帶過來,其他設定則不帶。

在對話視窗旁玩遊戲

按下標題列中的 Play,或在專案面板中的專案上按 Play,遊戲就會啟動。啟動期間,一張進度卡片會顯示每個步驟:Node.js 檢查、相依套件有變更時進行安裝,以及啟動開發伺服器。接著遊戲會在旁邊的工作階段旁以遊戲面板開啟。

Studio 起始場景:一個閃亮的扭結在台座上旋轉,相機繞著它移動
執行中的 Studio 起始場景,以 three.js 算繪

遊戲面板是你執行中遊戲的真實瀏覽器檢視,工具列上有重新載入、暫停與單步影格、靜音、FPS 計數器和彈出視窗。點進遊戲,鍵盤就交給遊戲;按 Esc 把鍵盤還給應用程式。彈出會把遊戲放到獨立視窗,在第二個螢幕上很方便,你也可以用平常的瀏覽器開啟它。你可以從專案選單或按 Ctrl+Shift+G(macOS 上為 Cmd+Shift+G)開啟面板。

編輯會熱重新載入。當代理變更檔案,Vite 會就地更新頁面,不需要重新啟動。如果某個變更無法編譯,頁面會保留上一次成功建置的版本,而代理會看到編譯錯誤。

代理可以看見並操控遊戲

這就是改變與 AI 合作感受的部分。當代理連上 Web (Three.js) 專案,它會得到一組即時遊戲工具:

  • 狀態與記錄:開啟的頁面、影格率、主控台輸出、未攔截的錯誤與堆疊,以及編譯錯誤。
  • 在影格算繪完成後擷取遊戲 canvas 的螢幕畫面,讓代理看到你所看到的。
  • three.js 場景樹,以及遊戲選擇公開的任何數值,不需要額外的遊戲程式碼。
  • 輸入:鍵盤、滑鼠、滾輪、觸控和遊戲手把,外加暫停、單步若干影格與變更時間縮放。
  • 遊玩測試:一段由輸入、影格步進、檢查與螢幕畫面組成的腳本化流程,最後產生一份 PASSED 或 FAILED 報告。

所以你可以提出像「把跳躍高度調高,然後確認玩家能不能到達第二個平台」這樣的要求,代理就會做出變更、用真實輸入玩這個關卡、查看結果並告訴你發生了什麼事。測試時它可以開啟隱藏檢視,甚至同時開好幾個,這樣測試執行就不會佔用你的螢幕。

在手機上遊玩

在應用程式中執行的遊戲,也可以在透過遠端連結與應用程式配對的手機上遊玩。遊戲在你的電腦上執行時,手機會顯示該專案的 Play,遊戲會透過遠端連線既有的同一條加密連結串流:不需要設定區域網路、連接埠轉送或公開網址。代理也能操控手機檢視,包括輸入與螢幕畫面,這對檢查觸控操作很有用。

需要時再上多人連線

所有起始範本都沒有伺服器,因為大多數遊戲一開始並不需要。當你的遊戲需要時,每個新專案都包含一個給代理用的多人連線技能:一個小而經過審查的骨架,含有 WebSocket 中繼伺服器與用戶端,以及把它接進遊戲的步驟。應用程式會在遊戲旁邊執行那個遊戲伺服器,若它當掉就重新啟動,並從遊戲自己的位址提供服務,所以從手機也能運作。

開始使用

從 ai-game.dev/download 下載 AI Game Developer,用 Studio 或 Island 起始範本建立 Web (Three.js) 專案,按下 Play,然後請代理做你的第一個變更。ai-game.dev/docs/app 的應用程式指南涵蓋安裝應用程式與登入。如果你偏好原生引擎,可以閱讀關於 Bevy 的同伴文章 ai-game.dev/blog/bevy-game-development-with-ai,以及關於 BRUTAL 的 ai-game.dev/blog/brutal-dotnet-game-development-with-ai。

圖片來源:本文中的場景是應用程式自家的起始場景,以 three.js 算繪(MIT License,Copyright 2010-2026 three.js authors)。

更多部落格文章

所有文章