Minecraft-style voxel game made with Muse Spark

# MC · Three.js 生存简版

基于 Three.js + Vite + TypeScript 从零还原的类 MC 体素游戏（生存简版）。

## 玩法

- 体素无限地形：丘陵 / 沙滩 / 海洋 / 橡树 / 煤矿 / 铁矿 / 雪山
- 第一人称：WASD 移动、空格跳、Shift 疾跑、鼠标视角（指针锁定）
- 左键按住挖掘（按硬度读条），右键放置方块
- 数字键 1-9 / 滚轮切换快捷栏（滚轮待接），E 打开背包，Q 丢弃选中
- 对着工作台右键打开 3×3 合成，E 背包内 2×2 合成
- 合成链：原木→木板→木棍→工作台→火把/木镐/木剑→圆石→石器→熔炉
- 生存：20 血 / 20 饥饿，疾跑跳跃消耗饥饿，高饥饿回血，空饥饿掉血，摔落伤害，死亡掉落
- 昼夜循环（10 分钟一天），夜晚刷僵尸（追踪+近战），白天燃烧，击杀掉腐肉 + XP
- 掉落物磁吸拾取，自动存档（localStorage，12 秒一次 + 切后台/关闭时），主菜单继续游戏
- F 开关飞行调试，云 / 星空 / 太阳月亮 / 挖掘粒子 / 受伤红屏 / WebAudio 合成音效

## 运行

```bash
npm install
npm run dev
```

浏览器打开输出的地址，点击「开始新世界」即玩。可填种子，留空随机。

## 操作

| 按键 | 动作 |
|---|---|
| WASD / 空格 / Shift | 移动 / 跳 / 疾跑 |
| 鼠标左键按住 | 挖掘 |
| 鼠标右键 | 放置 / 对工作台打开合成 |
| E | 背包（2×2 合成） |
| Q | 丢弃选中物品 1 个 |
| 1-9 | 切换快捷栏 |
| F | 飞行开关 |
| ESC | 暂停（自动保存） |
| 苹果/面包/腐肉 | 在背包里点它（或 Shift+点）吃掉 |

## 目录

```
src/
  main.ts            游戏装配 + 主循环
  config.ts          常量数值
  world/             方块注册 / 地形生成 / Chunk / 网格化 / 体素射线
  player/            控制 / AABB 物理 / 玩家（血量饥饿挖掘放置）
  entities/          僵尸 / 掉落物
  systems/           昼夜 / 音效 / 存档
  ui/                HUD / 背包合成面板 / 菜单 / 合成匹配
  utils/             程序化纹理图集 / 噪声 / 输入
```

## 后续可扩展

- 骷髅弓箭手 / 蜘蛛（继承 `entities/mob.ts`）
- 熔炉烧炼（铁矿→铁锭→铁器）
- 村民 / 红石 / 下界传送门
- 联机、真实材质包、触屏操作