kimi-minicraft

本项目由 Kimi K3 编写。

简单的网页版 MC 体素沙盒游戏：Three.js 渲染 + 零依赖 Node.js WebSocket 服务器，支持局域网多人联机。随机地形、树木、第一人称移动、破坏与放置方块、多人同图实时同步。

运行

需要 Node.js（零依赖，无需 npm install）：

node server.js          # 默认端口 8123，可用 node server.js 端口 修改

• 本机打开 http://127.0.0.1:8123
• 局域网其他玩家打开 http://<主机局域网IP>:8123（如提示防火墙放行请允许）

输入昵称点击进入。连不上服务器时自动进入单机模式。

Docker

docker build -t kimi-minicraft .
docker run -d -p 8123:8123 --name kimi-minicraft kimi-minicraft

改端口用 -p 9000:8123，或覆盖启动命令 docker run -p 9000:9000 kimi-minicraft 9000。

操作

电脑：WASD 移动，空格跳跃，鼠标控制视角；左键破坏，右键放置；数字键 1-7 或滚轮切换方块，Esc 释放鼠标

手机/平板：左侧虚拟摇杆移动，右半屏拖动转视角；「挖」「放」「跳」按钮操作；点按热键栏切换方块；竖屏会提示旋转，需横屏游玩（桌面浏览器可用 ?mobile=1 调试触屏模式）

联机原理

• 服务器启动时生成随机世界种子，各客户端用同一种子生成完全相同的地形
• WebSocket 同步增量数据：玩家位置（10Hz）、方块破坏/放置、进出通知
• 后加入的玩家会收到开服以来的全部方块修改记录，自动补齐世界状态

文件

• server.js — 静态文件托管 + WebSocket 联机服务器（Node 零依赖）
• index.html / main.js — 游戏客户端（Three.js）
• textures/ — 方块纹理
• lib/three.module.js — Three.js r160

许可

• 代码：MIT
• 方块纹理来自 Minetest Game，许可 CC BY-SA 3.0
• 渲染库 three.js，MIT 许可