拾形 · 碎片修复:把碎掉的陶瓷杯亲手拼回原形
一款 3D 碎片复原微信小游戏:观察完整器物、看它碎裂成立体碎片,再亲手拼回原形。从陶瓷杯 MVP 长成 35 件器物、三种节奏、收藏小馆与排行榜的完整版本。本文记录玩法设计、零依赖技术路线与踩坑记录。
导语: 有一种很朴素的解压方式——把一件完整的东西看着它碎掉,再一块一块亲手拼回去。「拾形 · 碎片修复」把这个体验做成了一款微信小游戏:碎片是真正的 3D 立体碎片,方向要自己转,位置要自己找。它从「一个陶瓷杯」的 MVP 出发,长成了现在的样子。

左:首页 · 一间安静的修复小馆 右:器物图鉴 · 35 件器物逐关解锁
玩法:三段式节奏,方向即难度
从陶瓷杯 MVP 一路验证下来的核心循环,只有三步:
- 观察:先看完整的器物——台面上缓缓旋转,轮廓和花纹方向就是线索。
- 碎裂:器物裂成带厚度的立体碎片,沿受控抛物线飞散落到台面上——每一块落在预设散落位,绝不随机乱飞。
- 拼装:点选碎片 → 移动到位 → 用旋转调整朝向 → 位置差、朝向角、深度全部进入容差后自动吸附归位。碎片靠近轮廓时,边缘会亮起来。
正式版在此基础上做了大量手感打磨:双指旋转、张合调深度,屏幕上实时标出「位置差 5.5 / 朝向 44° / 深度需前 2 步」这样的量化反馈,还有「声震反馈」「放大查看」「整理托盘」等辅助能力——碎片只吸附位置、不自动转正,「方向判断」始终是核心难度与成就感来源。

左:拼装中,位置差 / 朝向 / 深度量化提示 右:完好如初 · 三星结算
拼完那一刻,器物「完好如初」:记录片数与专注时长,给出星级评价,云端成绩自动保存——还会解锁只属于这件器物的小小回应。
技术:零外部依赖,手写 WebGL 渲染器
这个项目最「轴」的决定是:不用 Cocos、不用 Three.js、不用 Blender,甚至没有任何外部模型文件。
- 手写轻量 3D 渲染器:原生 WebGL1,双管线——3D 光照管线渲染器物与碎片,2D 纹理管线渲染标题/按钮/进度 UI。列主序
mat4/mat3+vec3矩阵库自己写,含矩阵求逆。 - 几何全部程序化生成:杯体是带壁厚的中空圆柱壳;每块碎片是扇环侧面 + 两个径向断裂面,断裂面单独着色模拟「内胎」质感。这直接规避了「伪 3D 碎片」(拿平面贴图装立体)的问题。
- 受控碎裂动画:每块碎片的落点是预设散落位 + 抛物线高度,而不是随机物理模拟——保证任何一次碎裂都不会飞出屏幕或卡进台面。
- 竖屏优先:散落半径、相机参数与视场按竖屏比例逐一验证,碎片始终在屏内。
整个工程就是标准微信小游戏结构(game.js 入口 + game.json + project.config.json),导入微信开发者工具的「小游戏」tab 即可运行,真机扫码即玩。
工程与测试:三道测试关卡
代码按职责拆成 8 个模块(math3d / meshgen / gl / camera / input / ui / game / main)。测试分三层:node --check 全量语法校验;check.js 逻辑自检(矩阵/几何/法线/吸附/竖屏可见性)20/20 通过;headless_test.js 用 mock 微信环境跑完整流程(开始→观察→碎裂→逐块拼装→通关→重置)16/16 通过。
踩坑记录:三个被测试抓住的真 Bug
- 真机必崩:
math3d.mat3少写了create(),渲染函数一上真机直接崩——单测里补上后过关。 - 旋转按钮失效:松手后选中态被清零,导致旋转按钮对着空气操作——改成「点选持久选中,吸附成功或点空白才清除」。
- 碎片飞出屏幕:最初的散落半径 2.05 配原相机参数,竖屏下碎片跑出可视区——收窄半径 + 后拉相机 + 调视场,三档竖屏比例全部回归验证。
从 MVP 到正式版
陶瓷杯 MVP 只验证了一件事:「真 3D 碎片 + 方向判断」这个核心循环有没有吸引力。答案是肯定的——于是它长成了现在的完整版:
- 35 件器物图鉴:从青边釉瓷碗、海蓝手作陶杯、青花描金花瓶,到微笑发条机器人、暖光古铜提灯——从简单轮廓到细腻立体挑战,逐关解锁。
- 三种修复节奏:轻松拼装(无倒计时慢慢修)、限时挑战(复原最外观)、好友比赛(轻松通关 5 件解锁)。
- 收藏小馆:修复完成的器物可以摆进自己的展柜,拖空底座后松手吸附,暖光展柜与真实大理石底座随时切换。
- 藏品档案:每件器物都有原创小记与专属互动——比如青边釉瓷碗的故事:「老街早点铺总把第一碗热粥留给早起的人。碗沿那一圈蓝,像天还没亮时窗外的颜色。」
- 修复排行榜与展台外观:以收藏数量与修复积分记录耐心;展台纸色、底座材质用挑战解锁,纯装饰、不加数值。

左:藏品档案 · 原创故事与解锁互动 右:收藏小馆 · 布置自己的展柜

左:设置 · 参考模型 / 虚线 / 声震按自己的节奏开关(v2.2.28) 右:展台外观 · 纸色与底座材质

修复排行榜 · 以收藏数量与修复积分记录耐心
接下来
游戏已进入提审阶段。后续计划:更多器物与碎裂模板持续创作、限时挑战与好友比赛的赛季化打磨、以及收藏小馆的场景扩展。
游戏的体验入口会在审核通过后更新到项目页——敬请期待。
评论 0
登录后即可参与评论,理性发言,友好交流。