在找 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
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
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
一款在瀏覽器裡玩的等角視角暗黑奇幻動作 RPG,目前開放 Alpha 測試中:在迷霧中醒來,一路殺過雨水濕滑的廢墟,收集附帶傳奇能力的戰利品。以 three.js 和 Claude Fable 5.2 打造,並在直播中開發。
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
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 · 沒有授權檔案
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 · 沒有授權檔案
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 · 沒有授權檔案
更多開源 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 是獨立網站,與它以及這裡的任何遊戲都沒有關聯。



