Files
gplan-2/design/art/asset-path-map.md
T
DKChan 0aa85ddb87 docs: 八敌立绘逐键定档 + 方案二排版批(美术线自立批讨论稿定稿,纯文档 + 管线脚本常量)
源委=P0 收口讨论批(2026-10-06,用户令「讨论期只改文档」)——派生自 3549 次
可读性实测(24 糊/32 可读/48 清楚/64 细节完整)与用户三体型约束(钩爪恐魔>灰矮人、
灰矮人<熊地精、食人魔酋长>熊地精)+ 定档总图用户确认。

① 八敌站桩源档由「全敌共用 48」改逐键定档(tools/pixelize_candidates.py 新增
   STANDEE_TIER_H:地精36/巨蜘蛛38/灰矮人46/钩爪恐魔58/熊地精62/食人魔酋长74/
   蛛化卓尔90/灰矮人石君王94;主角 48 不变,显示一律 ×2 整数 NEAREST=72–188)。
   旧 f_enemy=48/max_h 系数退役(它把普通怪压到 21–24px、全员低于可读门槛);
   SIZES 明确降级为「中间分辨率表」(决定中间图多细,不决定最终体量),并纠注
   ogre_chief=192 系分辨率选择非 Boss 档归属。派生管线 = pixel-1 紧裁 → 等比缩
   至各自档高 → dom_block_resize 块内众数降采样(禁走 recon / 重跑 remove_bg)。
② 排版改方案二:B 区 252→270(≈1/3 屏)/ C·D 548→530,扫雷盘 438×438 原尺寸
   不缩、格子不变(压缩由面板空档吸收);站桩内部重排=立绘双脚落石台上缘、血条
   +状态/名字行落底排全场一线;大体档(drider/duergar_king)头部探出盒顶压进光
   柱区,血条仍落底、意图徽标压胸;「血条悬浮头顶 + 盒内居中」排式退役。
③ 体量语义修订(character-design §5.2):强度先验 → 生物体型,小块精英与大体普
   通怪并存;§5.1 新增主角描边例外(深褐 40,19,13,浅砖面对比更高);§5.5 登记
   钩爪恐魔「宽≥高」豁免(58 高窄条长臂束状剪影,待样张批复验)。
④ 定值单点纪律(art-bible §8 头注):数字定值只落 §4.1 主色板 + §8.2,其余章指
   路禁复述;§4.1 新增色板 48 色上限 + 新色须与既有任一色 RGB 三通道差 ≥8。
⑤ §8.3 归档纪律(图片不入 git / 过程稿归档+对象存储 / 主文档禁引 artwork 散路径)
   + 三检查器挂点(色板检查器 / 路径核对器 / standee_asset_check 硬闸升级规格)。
⑥ 方向:=ission:24 rectifikace 地形色值对齐 §4.1(岩石 #8B755B→#C9AF83、地面
   #564232→#B39A78,两处提示词同步);生图渠道改为「远程对话式正主 + 本地
   ComfyUI 备选」;地形瓦片改拼表制正主(三步法),分张降为回退路径。
⑦ 对账更正:asset-path-map 废路径 production/mockups → artwork/mockups;
   art-status-checklist 格子样张 ⬜→✅、受击反馈/弹道 ⬜→◐(共 ✅4/◐8/⬜3)。
⑧ 06 新登记四条:站桩帧动画(Alpha 定版闸前)/ 主角描边素材侧复核 / 3349 草稿
   dry-run 整理 / 口号型条款机检化(三档标注格式已拍板)。

纯文档 + 1 个 Python 常量表改动,未出图未动引擎代码;重产与实装归后续任务书批。
doc 三闸/冒烟未跑(讨论批:非 loop 批且用户未点名,两入口铁规)。
2026-10-07 01:51:09 +08:00

3.4 KiB
Raw Blame History

素材路径分工约定(asset-path-map)

  • 定立:2026-09-26(用户立约指令「把哪些路径、哪些位置是干什么的确定好」——台账 161)
  • 效力:全仓素材批的路径判据单点;新素材批开工前对照,违例=实施缺陷

1. 目录分工总表

路径 角色 入 git 游戏运行时引用
design/art/candidates/** 设计侧源档(母版 PNG/.pxo/GIF/对比图/验收留底)——素材的原产地与档案库,游戏禁直接引用。目录按需创建(首批候选入库时建,2026-10-06 对账注:当前两 worktree 均未建立,非路径作废) 否(.gitignore 三行规则;*.md 指引例外) 禁(res:// 路径禁指 candidates)
game/assets/art/** 游戏运行时素材唯一落地处(res://assets/art/...)——定稿素材从 candidates 拷贝入此,改名按圣经 §8.3 否(untracked,勿 git add;worktree 间需脚本拷贝同步) 唯一合法引用源
game/assets/ui/icons/** UI 图标(状态图标批特例——唯一已提交入 git 的素材目录) 是(2026-09-24 批特例) 是
artwork/mockups/** 混合样张/版式对比图(设计评审产物,非游戏素材;样张 v3、关卡地图样张等实存于此)——2026-10-06 对账更正:原写的 production/mockups/** 系废路径 否 禁

2. 素材流(新素材批标准路径)

  1. 产出/候选:candidates 对应子目录(如 hero-idle/)
  2. 验收定稿:用户拍板(候选目录留档不动)
  3. 入包:拷贝 → game/assets/art/<语义子目录>/,改名 §8.3 域键式(如 character_hero_portrait.png)
  4. 接线:代码 res://assets/art/... 引用(路径常量单点归 UiKit.TEX_*);装载一律 UiKit.load_tex(exists 守卫——素材不入 git,缺位树回退),禁 preload
  5. 提交:只提交代码/文档;PNG 与 .import(全局忽略)均不入 git
  6. 整理(2026-10-06 P2-1 固化段——脚本链第四段:生成→验证→整理→入包):定稿入包后当批清 candidates 子目录——保留定稿源 + 最相邻候选 2 版(默认策略,可按资产调整),其余打包归 archive/;非素材残留(.url/.ogg/.ai/.swf 等)剔出;批量执行一律 dry-run 清单先行,经用户确认再动文件(2026-10-06 用户惯例)

3. game/assets/art 语义子目录

子目录 内容 现役
character/ 角色棋盘帧 + B 区立绘 character_hero_idle/walk(棋盘 32×32 朝左基准)、character_hero_portrait(B 区立绘 46×48)+ character_enemy_<键> 八敌
fx/ 特效帧 shovel_swing_f0/f1/f2(挥铲三帧,握把锚 (18,12))
board/ 砖面/旗印记(三关换皮 + 封印旗;2026-10-06 对账更正——旧 board_floor/wall/pillar_dungeon_* 命名退役) terrain_floor_<board_type>_.png(三关地面系)、flag_seal.png

4. 坐标/朝向等工程侧约定备查

  • 素材基准朝向:角色/铲帧一律朝左入库,右向=运行时 flip_h(镜像帧不入包,right 变体留 candidates)
  • 挥铲握把锚:画布 (18,12)(三帧同位——以手为圆心旋转的预烤相位)
  • 缩放纪律:圣经 §8.2 整数缩放为一般规则;棋盘小人 1.5× 系 2026-09-26 用户明示裁决(豁免注记归 art-bible 批另落)