pocket voxel — TypeScript 游戏站模板

pocket voxel 是一个将 Game Boy 经典角色扮演游戏以体素立体模型形式呈现的开源项目，其核心定位是“ROM 驱动”：你需要提供自己拥有的正版美版一代 ROM，工具链会先校验 SHA-1，再在本地完成解码、体素化与打包，整个过程不提交任何 ROM 派生字节。项目在浏览器中提供了一个完整的 Web Player，你可以直接拖入 ROM 开始游玩，也可以生成 PSP 或 PS Vita 的安装包。它并非简单的模拟器外壳，而是将游戏逻辑移植为 TypeScript，运行在嵌入式 QuickJS 虚拟机中，渲染层则用 Rust 重写了 DramaticShape Voxel Mod 的体素渲染器，因此画面带有手工雕刻般的像素风格。

项目的技术结构相当独特：游戏状态（世界、战斗、脚本、存档）全部位于 guest 端，Rust 核心只负责管理保留场景，如体素区块、实体公告板、战斗舞台等。这种“核心与 guest 分离”的架构让同一份游戏包可以运行在多种硬件上，且每个平台拥有独立的渲染后端，但共享同一份绘制指令列表。桌面端通过帧哈希锁定画面，PSP 与 Vita 则通过质量阶梯（如粗雕树木、地面分块烘焙）来适配性能，而非修改游戏逻辑。项目还附带了一个桌面流媒体功能，能让 PSP 中的卧室电脑屏幕显示 Mac 的实时桌面，但该功能默认关闭，且需要自行配置 FFmpeg。

需要明确的是，这不是一个开箱即用的通用游戏模板，而是面向特定硬件的深度技术项目。如果你只想在浏览器里体验体素化宝可梦，Web 构建已经足够；但若要生成 PSP/Vita 包，则需要安装对应的交叉编译工具链，并理解质量阶梯与帧预算的概念。项目文档（docs/VOXEL.md）详细记录了架构决策与确定性保证，但上手门槛较高，建议先阅读 README 中的“How it works”部分，再决定是否深入。