VoxelCraft V13.9.0 · Item Presentation

VoxelCraft 是一个直接运行在浏览器中的开放世界体素沙盒游戏。电脑、手机、平板和安装后的 PWA 使用同一份客户端、同一套世界格式与协议 v3 权威联机服务器。

• 在线游戏：https://yyh-0428.github.io/voxelcraft/
• 项目仓库：https://github.com/yyh-0428/voxelcraft

V13.9.0 重点

本版本重构了地面掉落和背包图标系统，解决“掉落物像悬浮贴纸”“物品侧面完全消失”“部分图标精细、部分只是粗糙色块”的不一致问题。

地面掉落

• 方块掉落使用缩小的六面 3D 方块模型。
• 工具、食物、符文和材料使用带像素轮廓厚度的 3D 物品模型。
• 移除永远面向摄像机的 Sprite 掉落方式。
• 掉落会旋转、浮动、落地反弹、在水中减速并产生轻量阴影。
• 根据堆叠数量显示 1–5 个错位副本。
• 附近相同物品自动合并，并遵守真实最大堆叠数。
• 不同耐久、词缀和元数据的物品不会错误合并。
• 靠近玩家后产生磁吸和缩小动画，确认进入背包后才消失。

背包和快捷栏

• 所有图标统一裁切透明边界、等比缩放、像素量化、描边和阴影。
• 方块、工具、装备、食物和材料拥有一致的可视占位比例。
• 稀有和传奇物品使用更克制的槽位边框。
• 带词缀物品显示轻量扫光。
• 为 36 个原本使用纯色矩形兜底的后期物品补充原创图标，包括盾牌、铁甲、蓝图、钥匙、核心、符文、矿粉、机器框架、电路板、罐体和钢板。
• 背包、快捷栏、配方、装备槽、机器槽、转化桌和鼠标拖动物品共用同一图标来源。

性能

• 同 ID 掉落共享几何、纹理和材质。
• 稀有掉落使用低成本光环网格，不为每件物品创建动态点光源。
• 160 个掉落实体的浏览器压力样本中，首次创建约 27–40 ms，单次逻辑更新约 0.8 ms。
• 继续保留 V13.6.4 的正式网格同步和 V13.7 的移动端性能预设。

保留的完整系统

• V13.8 等价交换转化桌、个人知识和 EMC。
• V13.7 跨设备迁移、后台省电、WebGL 恢复和身份接管。
• V13.6.4 稳定的方块挖掘与放置网格路径。
• 动物、词缀、信号、工业自动化、Boss、模组生命周期和 VoxelCode IDE。

在线游玩

打开：https://yyh-0428.github.io/voxelcraft/

推荐最新版 Chrome、Edge、Firefox 或 Safari。手机可以直接在浏览器游玩，也可以添加到主屏幕。

GitHub Pages 更新

发布包中的 index.html 是完整单文件客户端。覆盖仓库根目录文件即可更新网站：

git add index.html README.md
git commit -m "Update VoxelCraft to V13.9.0"
git push

V13.9 使用缓存名：

voxelcraft-v13-9-0-shell

发布后请关闭旧页面并强制刷新。安装过 PWA 的设备可重新打开应用；仍显示旧版时清除该站点缓存与旧 Service Worker。

联机部署

GitHub Pages 只能托管静态网页，不能运行 server.js。多人联机必须使用独立部署的 Node.js WebSocket 权威服务器：

GitHub Pages 客户端 ── wss:// ── VoxelCraft 权威服务器

V13.9 继续使用协议 v3。V13.9 服务器接受 V13.8.x–V13.9.x 客户端，但正式发布仍建议网页和服务器一起更新。

可将服务器部署到 Render、Railway、Fly.io、自建 VPS，或其他支持长期 WebSocket 的 Node.js 平台。HTTPS 游戏页面应连接 wss:// 地址；本地开发可使用 ws://127.0.0.1:8080。

操作方式

电脑

• WASD：移动
• Space：跳跃
• Shift：冲刺
• 鼠标左键：挖掘或攻击
• 鼠标右键：放置或交互
• 数字键/滚轮：切换快捷栏
• E：背包
• Esc：暂停

手机和平板

• 左侧虚拟摇杆移动，右侧区域控制视角。
• 动作按钮用于跳跃、挖掘、放置、潜行和冲刺。
• 可以直接点击快捷栏选择物品。
• “下一物品”按钮继续保留。
• 设置中可切换左手布局、按钮大小和透明度。

存档安全

世界保存在当前浏览器的 IndexedDB 中。清除网站数据、无痕模式、浏览器卸载或系统存储回收可能删除本地世界。重要世界应定期导出世界文件或整机迁移包。

测试摘要

• 基础逻辑：25/25
• 地面 Sprite：0
• 方块 3D 掉落和带厚度物品模型：通过
• 1–5 副本堆叠与附近合并：通过
• 36 个旧兜底图标：全部替换
• 真实 Chromium 图标与掉落专项：页面错误 0，控制台错误 0
• 真实 WebGL 2 掉落场景：通过
• 160 个掉落实体单次更新：约 0.8 ms
• V13.8 等价交换：通过
• V13.7 设备迁移和身份接管：通过
• V13.6.4 参考网格同步：通过
• V13.5 动物、词缀和信号：通过
• Chromium 全流程 E2E：通过
• WebGL 2：通过
• GLB：20/20

完整结果见 V13_9_TEST_REPORT.md。

界面预览

• tests/V13_9_ITEM_GRID.png：统一后的代表性物品图标。
• tests/V13_9_DROPPED_ITEMS_WEBGL.png：真实 WebGL 2 地面掉落模型。

问题反馈

请在 https://github.com/yyh-0428/voxelcraft/issues 提交：设备、系统、浏览器版本、游戏版本、单机/联机、复现步骤、截图或录屏，以及控制台错误。

许可证

仓库尚未声明开源许可证。在添加正式 LICENSE 之前，默认保留全部权利。