在找 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 制作;提交记录的共同作者是 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 上渲染,URL 参数
?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 是独立网站,与它以及这里的任何游戏都没有关联。



