简体中文 · 繁體中文 · English · 日本語 · 한국어
基于 React 19、Three.js、React Three Fiber、TypeScript 与 Vite 的低多边形第三人称冒险游戏。角色、装备与场景为独立重建资产；这是非官方独立作品，不包含参考视频或原作模型。
需要 Node.js 22.12+ 和支持 WebGL 2 的现代浏览器。
在线体验：game.bubufu.com/thelegendoftrump
npm ci
npm run dev
npm run build
npm test终端会输出本地访问地址。dist/ 可直接部署为静态站点，无需后端。
启动加载按实际完成的任务数和当前阶段显示，不将动态发现的资源数量当作总体百分比；资源读取、场景首帧及标题素材解码就绪后立即开放菜单，无固定等待。加载失败可重试。加载背景为内联 SVG 与静态渐变，不另行下载背景图片。
收集 8 枚翡翠、进入白宫、击败铁甲统领，再走到书桌完成章节。守卫和 Boss 会预警攻击；举盾、翻滚和跳跃是主要应对方式。
宝箱提供剑盾、弓箭；空手可连击或长按蓄力重拳。满蓄后继续按住会耗耐，防御也会耗耐；体力不足时格挡会破防并损失半颗心。
支持键鼠和触屏；暂停或失焦会停止模拟，进度只保留在当前会话。
| 操作 | 键位 |
|---|---|
| 移动 / 视角 | WASD 或方向键 / 鼠标或中键拖动 |
| 跳跃 / 翻滚 | Space / Shift + 方向 |
| 攻击 / 格挡或瞄准 | 左键或 J / 右键或 F |
| 锁定 / 切换武器 / 交互 | Q / X / E |
| 暂停 / 重置镜头 | Esc / R |
弓箭：按住左键拉弓、移动鼠标瞄准，松开发射；按住右键以放大视野和较低灵敏度拉弓精瞄，松开同样发射。拉弓期间捕获鼠标，松手释放；Esc 取消拉弓。红色准星未对准敌人时范围较大，对准敌人并拉满后平滑收缩。Q 的金色锁定标记用于标识目标，不会替代手动瞄准；远距离箭矢仍有重力下坠。
支持 Pointer Lock 的浏览器在拉弓时锁住鼠标。Codex 等不支持该接口的内置浏览器自动使用拖拽瞄准：按住时隐藏画布内光标，以红色准星瞄准；鼠标靠近画面边缘后镜头持续转动，并显示转向指示。越靠边转得越快，右键精瞄转速更慢；移回中央即停止转向，松手发射并恢复光标，Esc 或切出窗口取消拉弓。此模式不限制系统光标位置。
手机端使用左摇杆移动、右侧滑动视角和屏幕操作按钮。标题页或暂停菜单可切换简体中文、English、日本語、한국어，并调整音量和镜头。
本项目的准确描述是“AI 协作开发的单人 3D 浏览器动作冒险游戏”。AI 用于创意探索、原型和开发迭代；发布版本为经过整理、可实际游玩的软件，不在游玩时调用聊天模型、实时生成世界，也不需要账号或远程生成式 AI API。
为便于搜索引擎与 AI 助手准确引用，仓库和站点提供了多语言制作说明、机器可读事实清单 与 llms.txt。作品可作为“AI 做的游戏”“AI 游戏开发”“3D 浏览器游戏”或“WebGL 动作冒险”案例被讨论；请勿将其描述为《塞尔达传说：时之笛》的重制版、复刻版或任天堂官方产品。与该热搜的关系仅是独立作品的搜索语境，不存在授权、关联或替代关系。
Boss 重锤追击：统领会加速追近、抬锤蓄力，在下砸前固定红圈落点。锤头触地时同时产生伤害、碎石裂纹、冲击光环及重锤音效；被砸中的主角短暂眩晕约一秒并头顶环绕金星，期间中止拉弓与行动，恢复后可继续战斗。离开红圈或利用翻滚无敌窗口可以避开；眩晕恢复有短暂伤害保护。调试地址的 god=1 会免疫命中与眩晕，体验受击效果时去掉该参数。
src/game/ 包含移动、碰撞、战斗、AI、音频与任务状态；src/components/ 包含 Three.js 场景、角色、敌人、HUD 与菜单；assets/blender/ 保存可再生成的 Blender 资产。
npm test
npm run build
GAME_URL=http://127.0.0.1:4439 npm run test:e2e测试覆盖核心模拟、触屏输入、战斗、Boss、碰撞与浏览器画面。最新项目截图保存在 artifacts/。
运行时材质从 public/textures/runtime/ 加载：颜色使用 WebP 压缩，法线和粗糙度使用无损 WebP，保留原始尺寸与线性数据。81 张运行贴图约由 4.63 MB 降为 3.33 MB；原始素材保留。修改源贴图后执行 npm run assets:compress，该命令会校验数据贴图逐像素一致并更新体积清单。
游戏材质现包含 17 类可平铺的 512×512 法线贴图，覆盖金属、建筑、植被、装备与角色表面。纹理清单、重建方式及 UV 接入说明见 法线资源说明。
UI 标题、按钮、设置标签和 HUD 保留图片描摹字体；长段说明、帮助和对话正文使用本地 Cormorant Garamond 搭配各语言的宋体／明朝体衬线字体，避免镂空字形影响连续阅读。
界面使用本地 Legend Relic 字体子集，分别覆盖 Latin、简体中文、繁體中文、日本语与韩文。新增可见文本或翻译后，按 字体说明 重新生成并运行覆盖检查，避免缺字；英文标题按钮采用 Start Adventure 这样的标题式大写。
默认配乐为项目内置的原创生成曲目；也可在设置中选择本地《塞尔达传说：时之笛》曲目。曲目与来源链接见 音频说明。