打造独一无二的Stack-chan脸:网页Face Editor眼睛嘴巴自定义完全指南
打造独一无二的Stack-chan脸:网页Face Editor眼睛嘴巴自定义完全指南
Stack-chan 是一款由 JavaScript 驱动的 M5Stack 嵌入式超可爱机器人,而它的 Web Face Editor(Shape Face编辑器)让你无需编写代码,就能在浏览器里自由设计机器人的脸:调整眼睛的形状与位置、自定义嘴巴的开合尺寸、挑选表情和配色,几分钟就能打造独一无二的 Stack-chan 脸。
什么是 Shape Face 编辑器?
Shape Face 编辑器是 Stack-chan Web Tools 提供的一个网页工具,专门用来设计 Stack-chan 的 Shape 型 Face(矢量脸)。与图片头像不同,Shape Face 由眼睛、嘴巴和区域等几何参数描述,生成后能自动跟随表情、眨眼、视线、口型开合和主题色变化,效果非常灵动。
它的工作台布局分为两部分:
- 左侧预览区:一块 320×240 的仿真屏幕,眼睛和嘴巴都支持直接拖拽定位;
- 右侧参数面板:按"基本设置、Face 区域、左眼、右眼、嘴巴"分组,提供精确数值输入。
打开 Web Tools 首页后,点击 Shape Face Editor(Shape Face编辑器) 卡片即可进入(导航栏同样有入口)。
五步完成一张自定义脸
第一步:设置名称、表情与配色
在右侧"基本设置"卡片中:
| 参数 | 说明 |
|---|---|
| 名称 | 给这张脸起个名字(最长 64 字符),保存时会用作文件名 |
| 初始表情 | 支持 8 种:普通、高兴、生气、难过、困倦、困惑、冷、热 |
| 主色 / 背景色 | 用颜色选择器分别设置脸部主色和背景色 |
| 口部初始开度 | 0~1 的滑块,控制嘴巴刚启动时张开多少 |
第二步:划定 Face 区域
在"Face 区域"中设置脸的左、上、宽、高。坐标以 Face 区域左上角为原点,且整个 Face 区域不能超出 320×240 的屏幕范围,编辑器会自动帮你把数值限制在合法区间内。
第三步:定制眼睛
每只眼睛(左眼/右眼)可以独立调整:
- 瞳孔形状:
circle(圆形)或roundRect(圆角矩形),一眼就能看出"呆萌"和"灵动"两种风格差异; - 位置:X / Y 坐标,也可以直接在预览画布上拖拽;
- 尺寸:圆形用瞳孔半径(2~40),圆角矩形用宽、高、圆角 R;
- 眼睑:宽度和高度为只读项,系统会自动保持"恰好盖住瞳孔"的大小,保证眨眼睛时不穿帮。
第四步:定制嘴巴
嘴巴卡片里可以:
- 勾选/取消 "绘制嘴巴",彻底隐藏嘴巴;
- 调整 X、Y 位置;
- 设置四个尺寸参数:张开的宽、闭合的宽、闭合的高、张开的高——这四个值定义了嘴巴从闭合到张开的完整动画范围,口型跟随语音时的效果就是由它们决定的。
第五步:保存与加载
顶部工具栏提供四个快捷操作:
- 加载 Shape Face(文件夹图标):打开已有的
.stackchan-face.json文件继续编辑; - 恢复默认布局(回转图标):一键回到标准脸;
- 保存 JSON(下载按钮):把当前脸导出为
.stackchan-face.json文件; - 在 MOD 中使用:把脸直接送进 Blockly 块编辑器,一步到位。
💡 另外,编辑器每次修改都会自动保存到浏览器草稿(localStorage 中的 stackchan-face-editor-draft-v1),中途关掉页面再回来,上次的进度还在。
把自定义脸装进 MOD
点击"在 MOD 中使用"后,会带着你的脸数据跳转到块编辑器。在右侧 Assets 栏可以看到 Face 已标记为"使用中",Build 后生成代码会自动包含 FaceBase.template 实现和 robot.ui.setFace 调用——你的脸就嵌入到普通 MOD 的资源里(assets/*.stackchan-face.json),不需要专用运行时或专用固件。
在预览区下方的"生成的 Face 实现"折叠面板中,你可以随时查看这张脸对应的生成代码,方便进阶开发者接手改造。
换上不同风格的自定义脸后,Stack-chan 就能以全新的面貌与同伴"模仿互动":
进阶:了解 Face 资产格式
.stackchan-face.json 采用格式标识 tech.stackchan.face(当前版本 1),字段规范有完整文档,机器校验用的 JSON Schema 也在仓库中,方便你手写或批量生成脸:
- 资产格式说明:docs/specs/face-asset.md
- JSON Schema:docs/specs/face-asset.schema.json
- 编辑器页面与状态管理源码:web/src/features/face-editor/
- 默认脸的参数定义与校验逻辑:web/editor/face-assets.mjs
- 草稿/项目间传递的存储逻辑:web/face-editor/face-editor-storage.mjs
总结
| 想做的事 | 用哪个功能 |
|---|---|
| 快速换一种眼睛风格 | 瞳孔形状切换 circle / roundRect |
| 让嘴巴会"说话" | 四个口型尺寸参数 |
| 个性化配色 | 主色 + 背景色 |
| 换脸不写代码 | "在 MOD 中使用"一键送入块编辑器 |
| 备份与分享 | 保存为 .stackchan-face.json |
从打开编辑器到装进 MOD,全程不超过五分钟。现在就去给你的 Stack-chan 设计一张独一无二的脸吧!🎨



