1. 目录约定
| 目录 | 放什么 |
|---|---|
art-source/ | 2D 源图,全分辨率,走 LFS,不进 Cocos 工程。一级目录 = bundle,文件名 = 配表 id |
model-source/ | 3D 源:building/(建筑与各阶段)、armor/(时装部件)、weapon/、character/(男女素体)、anim/(动作库)、kit/quaternius/(CC0 套件) |
action-source/ | 动作库里没有、另外生成的动作 |
tools/art/ | 会话工具、导入、预览、纸娃娃烘焙、地图生成与烘焙、字体 |
- 资源键 =
<bundle>_<路径把 / 换成 _>,登记在config/tables/assets.csv。代码与配表只写键。 - 源图只要求比例。
import.ts比例差 1% 以内自动裁,更多就拒收;按res缩到实际要发的分辨率(UI 图标 25%、场景物件 50%、整张地图 100%),再按format存成 PNG、调色板 PNG(中位切分 + 两轮 k-means、不抖动)或 JPEG。 npm run art从assets.csv生成出图清单art-source/MANIFEST.md:919 项全部有源图。- 交图之后:PNG 放到表里写的路径 →
npm run art:import(顺带量包围盒写进asset_boxes.csv、生成金属染色遮罩、加载画面和网页图标)→node client/tools/gen-meta.mjs→ 提交。
统一风格写在清单头:以《八方旅人》为基准,2026-11-11 起要「厚重而不是清新」;左上方来光;轮廓用同色相的深色,不用纯黑。
2. 协作:只靠文件
写代码的 Agent(需求方)不自己生图。出图交给美术工(只在 art-source/ 里干活),出 3D 模型交给模型工(只在 model-source/ 里干活)。两边都不改代码和配表、不提交、不互相发消息,一切经过会话目录里的文件:
<会话>/request-01.md 需求方:要做什么、交付到哪、可核对的验收标准
<会话>/claim-01 工人:接单时间
<会话>/views/ 输入图
<会话>/out/ 交付物
<会话>/response-01.md 工人:最后写(写了就代表交付完)
<会话>/request-02.md 需求方:不达标就返修
<会话>/DONE 需求方:一句结论
node tools/art/session.ts new <slug>开会话;「最新的 request 没有同号的 response」就是待办。- 不轮询:
node tools/art/trigger.ts start --space all注册文件事件监听(fs.watch),有新需求时叫醒对应的工人,空闲时大家都结束回合,不跑等待循环、不发心跳。失败的批次不自动重试,免得付两次钱。 - 亲自验收:需求方必须自己打开图、量尺寸、合成到场景里看,不能只信 response。工人的 response 要写量到的数,没验证的写「没验证」,结论只能是完成 / 部分完成 / 卡住。
从 2026-11-05 到 11-12,磁盘上有 21 个美术会话、16 个模型会话,大致的时间线:
| 日期 | 做了什么 |
|---|---|
| 11-05 | 男女主角原画、砍树挖矿关键帧;后来 3D 烘焙那条路走通了,这批 2D 方案都收掉了 |
| 11-06 | 铁剑、男主便装、靴子的多视图与 3D 建模;整身自动蒙皮效果不好,改成分部件 |
| 11-09 | 伐木屋、大地图建筑三批(每批 5 栋)、地图图标与名牌 |
| 11-10 | 女主便装、四套时装(白蓝紫金,每套 12 个部件)、时装特效 |
| 11-11 | 加载画面关键美术、村中心 4 个成长阶段、144 件家园摆设 |
| 11-12 | 11 座建筑的 44 个成长阶段、手绘地面与植被 |
3. 角色:从 3D 素体烘成像素图
角色走过两条被放弃的路:程序化拼几何体,和 2D 分块叠图,都不够好。现在是纸娃娃(tools/art/paperdoll/):一套 3D 素体穿上 3D 部件,按动作库摆姿势,烘成像素图。
- 素体:VRoid 的男女样例素体(CC0),VRM 人形骨架,两个性别共用。比例改到约 4.5 头身(头 ×1.31、腿 ×0.71……),直接烘进网格。游戏里每个角色约 3000 个三角面的预算。
- 部件上身:原画 → Tripo 多视图生成部件 → 按试穿图量对齐框 → 包围盒对齐、轮廓配准 4 轮 → 删掉陷进身体 2.5 厘米以上的面 → 从素体传递蒙皮权重(Abdrashitov 等 2023 的方法 [1]),每类部件只认几根骨头 → 袖口领口留 4 厘米皮肤。最后自动质检。
- 工具和武器:2026-11-08 起全部是 3D 模型(斧、镐、锤、鱼竿、七把职业武器),登记握把、朝向、长度和尖端;弓弦是代码加的,Tripo 做不出细线。
- 动作:Quaternius 的通用动作库 UAL(CC0)重定向到 VRM 骨架。免费库里没有挖矿、钓鱼、锻造、拉弓,就拿相近的动作截一段改速度:挖矿是过肩投掷的前半段,钓鱼是提灯待机,射手是手枪射击。剑、斧、匕首的横扫是 Meshy 按文字生成的(3 积分一段)。
- 像素化:4 倍尺寸渲染,4×4 块过半覆盖才出一个像素,线性空间平均颜色再转 sRGB,角色量化到 16 级,描 1 像素
#1a1416轮廓。烘焙由bake3d.mjs驱动无头 Edge 完成。
烘出两种东西:
| 陪伴小窗 / 战斗卡 | 大地图 | |
|---|---|---|
| 类型 | anim:逐帧图 + rig | sheet:8 方向图集 + rig |
| 相机 | 正交,侧前方 | 正交俯视,8 个方向 |
| 尺寸 | 512×512 一帧,人高 384 | 一格 200 像素,人高约 156 |
| 有哪些 | 26 个动作:3 种待机、9 种工作、7 个职业各自的待机和攻击 | 跑动 22 帧、待机、工作、职业待机与攻击 |
| 帧率 | 工作 15 fps,钓鱼 8,攻击 20 | 跑动 24 fps,攻击 14 |
现在有 17 个角色外观:男女便装、七个职业装、八套时装。
时装:分部件、带深度
时装改成分部件自由搭配之后,不再为每一套烘一张整图。每个部件(头、上衣、裤子、鞋、背饰、武器、副手)单独烘出彩色图集 + 深度图集(灰度 0–255 对应 3 米深),男女各一套;游戏里在 Worker 中逐像素保留最近的那一层合成,身体往后推一点,免得贴身的衣服被身体穿透。四档:白「见习旅人」、蓝「林间游侠」、紫「星辉秘术」、金「曜日圣骑」;紫金两档带特效。现在全部免费。
4. 建筑与环境
- 建筑:美术先画原画和四视图 → 模型工(后来需求方自己跑脚本)用 Tripo 多视图生成 →
model-source/building/<id>/raw.glb。每个约 1.3–1.4 万面,三张 4096 贴图(颜色、ORM、法线),一个 55 积分;64 个建筑与阶段模型共约 3500 积分。单张原画生成会把画里的人也做进模型里,所以用四视图。Tripo 的房子正面朝 +X,摆的时候转 -90°。 - 成长阶段:12 座建筑各 5 个阶段(村中心 4 个新阶段 + 原模型,其余 11 座 44 个),越往后越大越气派。
- 摆设:9 组 × 16 件手绘贴片,每件带影子图和一个顺序表,后面的是前面的「进化版」。
- 植被与地面:44 张手绘贴片(树、石、草,每米 80 像素、脚底锚点)、12 张无缝地面纹理(俯视平涂,不带方向光,影子由烘焙从 alpha 投)。早期整片用 Quaternius 的 CC0 套件(自然、村庄模块、道具)先顶上,后来按「八方旅人风」分批换成手绘。
- 加载画面:一张关键美术裁成 16:9、缩到 1280×720 预先模糊好存 JPEG,图标和标题字是调色板 PNG。
5. 许可证
- 字体:Noto Sans SC,OFL 1.1,子集化后改名 IdleHD Sans。
- Quaternius 的套件与动作库、VRoid 样例素体:CC0。
- tripo-go 客户端:MIT,源码随仓库。
- Tripo、Meshy 生成物的授权条款仓库里没有专门记录。
参考
- Abdrashitov et al., Robust Skin Weights Transfer via Weight Inpainting, SIGGRAPH Asia 2023 Technical Communications
- Quaternius(CC0 模型与动作库):https://quaternius.com/
- Tripo:https://www.tripo3d.ai/