为什么值得关注

它展示了不依赖任何外部模型、纹理、字体或音频，如何用代码生成完整游戏资产；同时实现了结构化的非真实感渲染（NPR）管线、水力侵蚀地形与可复现的测试机制。

适合谁使用

对 Three.js/WebGL 游戏开发感兴趣的开发者
想研究卡通渲染/NPR 技术的美术或技术美术
程序化生成与地形模拟爱好者
BMX/竞速游戏玩家或独立游戏玩家

典型使用场景

作为 WebGL 卡通渲染和非真实感绘制的参考实现
学习代码生成资产、程序化地形与侵蚀模拟
构建固定时间步物理和相机系统的竞速游戏原型
使用确定性浏览器捕获做视觉回归对比

项目优势

全部资源由代码生成，无外部下载依赖，内容管线统一且可复现
NPR 渲染有结构性约束：无 PBR、色相偏移阴影、量化光照、双线系统与可变线宽
地形使用噪声加液滴水力侵蚀与热侵蚀，并结合赛道走廊生成真实山体路径
工程实践扎实：120Hz 固定物理步长、自适应分辨率、接口化架构和确定性捕获工具

使用前须知

性能目标为高配置设备（如 M5 Pro）上的 retina 60fps，中低端设备可能无法达到
操作组合多，技巧门槛较高，休闲玩家不易上手
所有资源由代码生成，意味着修改美术内容需通过代码或重新生成，而非直接替换文件

README 快速开始

DESCENT

A cel-shaded downhill BMX racing game. Four riders, point to point, summit to valley floor. Built in Three.js and TypeScript.

Every asset in this repository is generated by the code in this repository. No downloaded models, textures, HDRIs, fonts, or audio. Every mesh is built from geometry primitives and procedural lathes in code. Every texture is rasterised with canvas 2D or evaluated in a shader. Every sound is synthesized with the Web Audio API. The mountain is noise plus a hydraulic erosion simulation. The letterforms in the HUD are drawn as paths.

npm install
npm run dev

That is the whole setup. Open the URL it prints and you are racing.

Controls


W / ↑	Pedal
A D / ← →	Steer
S / ↓	Rear brake — locks the back wheel, scrubs speed, throws dirt
Q	Front brake
Space	Crouch → preload. Hold into a lip, release at the top for extra air. Also bunny-hops on flat ground.
J / K	Lean back / forward. Lean back on the flat to manual.
Shift + direction	Trick modifier 1 (tailwhip, x-up)
E + direction	Trick modifier 2 (superman, tabletop)
F	Boost — spends the meter you filled with tricks
R	Reset to the last checkpoint
C	Look back
V	Cycle camera
Esc	Pause
`	Debug overlay

A standard gamepad works too; the left stick bypasses the keyboard's input smoothing.

The one mechanic worth learning: preload and pump. Hold crouch on the approach to a lip and release it at the lip. Time it well and you leave the ground with substantially more vertical velocity than the ramp gave you. Release early and you go flat. There is a ~140ms window and it is the skill ceiling of the whole game.

Art direction

One committed palette: dawn-gold alpine. A low sun at 21.5° raking across the mountain from the east-southeast, cool violet-slate shadows, and a teal-shifted haze stacking the far ridges into flat paper layers. Every colour in the game is declared in src/npr/Palette.ts and nowhere else.

Three rules the code enforces structurally, not by convention:

There is no PBR to leak in. There is no MeshStandardMaterial anywhere in the project and no code path that could construct one. Every surface is a CelMaterial built from a RampPreset.

BMX_Racer