在找 three.js 範例嗎?想看單一功能,官方的 three.js examples 頁面是最好的起點:幾百個簡短的 demo,每個只示範一件事,例如一個載入器、一種材質、一個後製效果或一個物理引擎,點一下就能看到原始碼。它缺的是完整的遊戲:它的「games」分類裡只有一個範例,一款小型第一人稱射擊遊戲。

這份清單補上了這個缺口。下面是 7 款完整的 three.js 遊戲,現在就能在瀏覽器裡玩,而且每一款的完整原始碼都公開在 GitHub 上,由作者本人附上連結。每款我們都根據專案自己的 README 和檔案,寫了程式碼裡值得讀的地方。7 款都是用 AI 程式模型做的,主要是 Claude Fable 5.2 和 Claude Opus 5.5,所以它們也呈現了這類程式碼放在真實專案裡是什麼樣子。

重複使用任何內容之前,請先查看每個儲存庫的授權條款。其中 5 款也收錄在我們的開源網頁遊戲合集裡,那邊對授權條款講得更詳細;這裡的重點是 three.js 技術。

一覽

遊戲 值得學習的 three.js 技術 原始碼 授權
Cayley 物理優先的飛行模擬、串流載入的真實地形、不需建置 lauramionel/cayley-flight-simulator MIT
Baron 卡通著色、描邊、在 Web Worker 裡產生的種子地形 dai-studio/ex-baron BSD-2-Clause
The Lost Storm 遊戲邏輯與 three.js 渲染分離 marginsystems/the-lost-storm MIT
Valley Ride WebGPU 渲染器、實例化的草和樹、壓縮素材 StarKnightt/valley-ride MIT
Castle Valley 由實例化筆觸組成的繪畫風格渲染器 remorses/castle-valley 沒有授權檔案
PaletteRider 城市、人物和音樂由程式碼產生;不需要伺服器的多人模式 aashishgtbit/PaletteRider 沒有授權檔案
Skyfall Protocol 在 WebGPU 上以 3D Tiles 串流載入照片級城市 a7ul/skyfall 沒有授權檔案

沒有授權檔案的公開儲存庫允許你閱讀程式碼,但不給你任何重複使用的權利。

Cayley:用純 JavaScript 寫的飛行模擬器

有真實機翼物理的飛行模擬器:九款真實機型,世界上任何一座機場,真實地形高度和衛星影像,即時天氣。Lionel Mora 說 Claude Fable 5.2 一個晚上就寫出了它。

程式碼裡值得看的地方:

  • 不需建置。 它是一個靜態網站:three.js(r184)直接放在 vendor/ 資料夾裡,用任何 Web 伺服器都能執行。如果你想不用打包工具來使用 three.js,這是個好例子。
  • 飛行模型(js/fdm.js):一個以 240 Hz 步進的六自由度剛體,機翼被切成 40 條,螺旋槳逐片槳葉模擬。README 說每幀大約只花四分之一毫秒。
  • 串流地形(js/terrain.js):圍繞飛機的地圖圖磚四元樹,衛星影像下面是真實地形高度,建築來自 OpenStreetMap 向量圖磚。
  • 程式碼產生的聲音(js/engine-worklet.js),逐個取樣合成;還有用 Node 執行、不依賴任何套件的測試。

遊玩:lauramionel.github.io/cayley-flight-simulator · 原始碼:GitHub · MIT

Cayley
Cayley作者 @lionel_mora

一款瀏覽器飛行模擬器:真實機翼物理、9 架真實飛機、整個地球以 3D 即時載入。Claude Fable 5.2 一夜做成。

Baron:沒有素材檔案的卡通畫風

一款卡通雙翼機遊戲:在機庫裡組裝飛機,然後在一個由種子產生的世界上空起飛、飛行、降落。由 Dai Studio 用 TypeScript、three.js(WebGL 2)和 Vite 製作;commit 的共同作者是 Claude Opus 5.5。

程式碼裡值得看的地方:

  • 卡通畫風(src/render):帶邊緣光的卡通材質、反轉外殼描邊和一個基於深度邊緣的墨線 pass,最後接 FXAA。
  • 無盡的世界(src/world):帶種子的亂數和雜訊,地形在 Web Worker 裡分塊產生,圍繞飛機分成幾圈細節層級。
  • 一切都在程式碼裡。 README 說所有美術和音訊都由程式碼產生,沒有外部素材檔案,聲音用的是 Web Audio API。
  • 遊戲專案的好習慣:固定 120 Hz 的遊戲迴圈,針對世界確定性和飛行模型的 Vitest 測試,一個 ?debug 調校面板,以及可以離線使用的可安裝應用程式。

遊玩:baron.by.dai.studio · 原始碼:GitHub · BSD-2-Clause

Baron
Baron作者 Dai Studio

瀏覽器裡的卡通雙翼機遊戲:在機庫裡組裝飛機,從跑道起飛,飛越隨機生成的山丘和海岸,再平安降落。開源程式碼由 Claude Opus 5.5 參與撰寫。

The Lost Storm:遊戲與畫面分開的 RPG

一款等角視角動作 RPG:在迷霧中醒來,用快捷列上的技能戰鬥,撿起以真正 3D 模型掉落的戰利品。Mark Arguinbaev 在直播中用 Claude Fable 5.2 開發它。README 說它用的是 three.js、TypeScript 和 Vite,上面沒有再套遊戲引擎。

程式碼裡值得看的地方:

  • 模擬與渲染分離。 遊戲本身(戰鬥、技能、怪物、尋路、戰利品、存檔)放在 sim/ 裡,是純 TypeScript,不含 three.js 也不含 DOM,所以能在 Node 裡執行和測試。three.js 只存在於 src/render/:等角攝影機、光照、地面、特效和天氣。
  • 內容即資料。 技能、怪物、物品、技能樹和每個區域都是 data/ 裡的 JSON 檔,在啟動時驗證。
  • 發布到遊戲平台:建置腳本可以為 itch.io 這類平台產生離線版本,另有一個選用的伺服器,用於雲端存檔和共用大廳。

遊玩:theloststorm.com · 原始碼:GitHub · MIT

The Lost Storm
The Lost Storm作者 @marginsystems

一款在瀏覽器裡玩的等角視角暗黑奇幻動作 RPG,目前開放 Alpha 測試中:在迷霧中醒來,一路殺過雨水濕滑的廢墟,收集附帶傳奇能力的戰利品。以 three.js 和 Claude Fable 5.2 打造,並在直播中開發。

RPG動作黑暗奇幻

Valley Ride:在 WebGPU 上跑 three.js

沿著一條 2.5 公里的小徑平靜地騎馬,前往夕陽下的營火。Prasenjit 用 Claude Code 花兩天做成,大部分用 Claude Opus 5.5,騎士用 Claude Fable 5.2,馬和樹用 Blender 製作。

程式碼裡值得看的地方:

  • WebGPU 加備援。 它用 three.js(r187,唯一的執行期依賴)在 WebGPU 上渲染,網址參數 ?webgl=1 可以切換到 WebGL 2。README 說只在 Windows 版 Chrome 上測試過。
  • 大量植物,依然流暢:鏡頭附近的草是實例化的草葉,樹有三級細節,隨著你移動重新打包成實例化網格。
  • 素材壓縮:KTX2 和 WebP 貼圖,以及 meshopt 壓縮的網格。即便如此,第一次造訪也要下載約 74 MB。
  • 畫質預設和 GPU 檢查:從低到極高的預設,以及在 GPU 上驅動 Chrome 的腳本,一旦掉幀或著色器編譯失敗就判定失敗。用到的提示詞都在 PROMPTS.md 裡。

遊玩:starknightt.github.io/valley-ride · 原始碼:GitHub · MIT

Valley Ride
Valley Ride作者 @prasenx

一款悠閒的騎馬遊戲:騎著馬穿越群山間的山谷,在夕陽西下時抵達營火旁,以 three.js 和 WebGPU 打造。作者用 Claude Opus 5.5 和 Fable 5.2 兩天就做完了,而且開源。

Castle Valley:繪畫風格渲染器

第一人稱視角,從幽暗的森林走向一座城堡,手持火把和劍,與哥布林和巨魔戰鬥,整個世界都用油畫筆觸畫成。Tommy D. Rossi 說是 Claude Fable 5.2 做的。

程式碼裡值得看的地方:

  • 不靠濾鏡的油畫效果。 README 解釋說,這個世界由大約 250 萬張實例化卡片組成,每張是一筆筆觸,釘在 3D 中的一個點上,下面是填補空隙的純色幾何體。因為筆觸從不移動,你走動時顏料會一直留在物體上。
  • 程式碼產生的筆刷貼圖(src/brush.ts),以及從參考影片裡量出來的色彩漸層(src/paint.ts)。
  • 筆觸的細節層級:遠處的筆觸更少、更大,依固定的排序來挑選,所以筆觸永遠不會互相替換。
  • 最後一道 pass(src/main.ts):調色、畫布紋理和一點凡尼斯光油。

遊玩:omw-game.kimaki.dev · 原始碼:GitHub · 沒有授權檔案

Castle Valley
Castle Valley作者 @__morse

油畫筆觸畫出的第一人稱奇幻冒險:一手火把一手長劍,走出黑森林,奔向城堡下的村莊,一路砍哥布林和巨魔。Tommy D. Rossi 說是 Claude Fable 5.2 做的,程式碼開源。

PaletteRider:整座城市都由程式碼產生

在名畫裡騎腳踏車,從保羅·克利的〈城堡與太陽〉到梵谷的〈夜間露天咖啡座〉,再到莫內在吉維尼的花園。Aashish Tiwari 說,從 3D 城市到音樂,都是用 Claude Fable 5.2 做的。

程式碼裡值得看的地方:

  • 程序化內容:three.js 和 Vite,純 JavaScript,城市、人物、音樂和音效都由程式碼產生。唯一的圖片檔是那些畫。
  • 用開放資料重現的真實山谷:瑞士章節由 tools/lauterbrunnen/ 裡的 Python 腳本,根據 OpenStreetMap 和高程圖磚烘焙而成。
  • 不需要遊戲伺服器的多人模式(src/net.js):每個瀏覽器每秒幾次透過 WebSocket 把自己騎士的位置送到一個公共訊息中繼站,同時監聽其他人的位置。

遊玩:aashishgtbit.github.io/PaletteRider · 原始碼:GitHub · 沒有授權檔案

PaletteRider
PaletteRider作者 @Aashish_Tiwari_

騎著腳踏車進入名畫之中,從保羅·克利〈城堡與太陽〉到梵谷〈夜晚的露天咖啡座〉,在天亮前收集一顆顆小太陽。從 3D 城市到音樂,全部使用 Claude Fable 5.2 打造。

Skyfall Protocol:WebGPU 上的照片級城市

駕駛七款現代噴射戰機之一,飛越一座帶貼圖的 3D 里昂,可以玩四幕任務,也可以自由飛行。README 說這款遊戲是透過提示詞來指揮和試玩的,作者並沒有讀過程式碼。

程式碼裡值得看的地方:

  • three.js 的 WebGPU 渲染器,沒有 WebGL 備援,所以需要支援 WebGPU 的電腦版 Chrome。
  • 3D Tiles 串流:城市是 Métropole de Lyon 2023 的實景網格,用 3D Tiles Renderer 載入,離飛機越近細節越多。
  • 本機地圖儲存:地圖包只需下載一次,然後選擇它所在的資料夾;遊戲用 Chrome 的 File System Access API 讀取,並把處理好的圖磚快取在 IndexedDB 裡。
  • 需要留意的授權:飛機模型是採用非商業授權的第三方素材,儲存庫本身也沒有授權檔案。

遊玩:atulr.com/skyfall · 原始碼:GitHub · 沒有授權檔案

Skyfall Protocol

駕駛 F-22 飛越擬真重現的里昂,以 WebGPU 渲染。

更多開源 three.js 遊戲

Blendi 的繪畫風遊戲 Oil Paint、Painted Valley、Patchwork Quilt、Watercolour 和 Small Magic 開源在 patch.gg 而不是 GitHub 上;我們的開源網頁遊戲合集裡有介紹。沒有公開程式碼的 three.js 遊戲,可以看所有用 three.js 做的遊戲和我們的 WebGL 遊戲合集。想自己做一款,可以讀如何用 Claude Fable 5.2 和 three.js 做一款 3D 網頁遊戲(英文)。

常見問題

官方的 three.js 範例在哪裡?

在 threejs.org/examples。它們是按 WebGL、WebGPU、WebXR、物理等分類整理的簡短 demo,每個都有「View source」連結。一次學一個功能,它們是最好的參考;上面這些遊戲則呈現了這些功能在完整專案裡怎麼組合在一起。

我可以複製這些遊戲的程式碼嗎?

只能在各自授權條款允許的範圍內。MIT 和 BSD-2-Clause 允許你重複使用程式碼,包括商業用途,前提是保留著作權聲明。Castle Valley、PaletteRider 和 Skyfall Protocol 沒有授權檔案,所以只能閱讀,不能重複使用。素材可能有自己的條款:Skyfall 的飛機模型是非商業授權。

新手應該先讀哪一個?

想看不用打包工具的 three.js,就讀 Cayley;想看 TypeScript 遊戲專案怎麼組織,就讀 Baron 或 The Lost Storm。The Lost Storm 把遊戲邏輯和渲染分開的做法,任何遊戲都值得參考。

這些遊戲需要 WebGPU 嗎?

Skyfall Protocol 需要,Valley Ride 預設使用它。其他 5 款執行在所有現代瀏覽器都支援的 WebGL 2 上。

它們真的是用 AI 做的嗎?

這是每位作者在自己的貼文或 README 裡說的。例如 Valley Ride 的 README 就寫明了 Claude Opus 5.5 和 Claude Fable 5.2,還附上了提示詞。

儲存庫、README 和授權條款都在 2026 年 11 月 21 日檢查過。遊戲、程式碼和截圖屬於各自的作者。three.js 是由其貢獻者維護的開源專案;VibeGamer 是獨立網站,與它以及這裡的任何遊戲都沒有關聯。