DKChan
665304cf14
卡片：reports/需求卡片-棋盘瓦片与立体表现重做批-2026-11-07.md（验收档中，9.5 日；T0–T8）——C 方向合并岩体/连续地面、D 布局左右侧栏、三关八色冻结、浮空数字＋双色引导线＋格面阴影圆、按脚底行分档的格件贴花、旧 terrain_* 63 件与色牌退役；五轮复核 52 条全处置，第五轮通过。 设计闭合：art-bible v3.50（§1.2/§3.2/§4.1/§6.3/§6.5/§8.2）；battle.md D 区布局与像素判据/层序；HUD框架 D 区/21px/提示条退役；术语表掩尘/裸土/浮空数字/色牌；asset-path-map/art-assets-checklist 旧瓦片与色牌退役；golden README 1036×548＋越格口径；game/tests/README 新增 6 条能力行（旧地形行保留，删行归写卡段后续）。 现状推进：待办清单条目状态→已写卡（删缺口属性）；roadmap 待编池→已写卡待编排；08-Alpha 现状→已写卡（待编排）。 凭据：pipeline_gate PASS（条目 34／总表 55／交叉核 1 链／卡片口径 2 张全过）；capability_audit 红项 0（能力行 120／套件 86）；run_all_gates.sh --docs 【验收通过】无新增红。
4.4 KiB
4.4 KiB
素材路径分工约定（asset-path-map）
- 定立：2026-09-26（用户立约指令「把哪些路径、哪些位置是干什么的确定好」）
- 效力：全仓素材批的路径判据单点；新素材批开工前对照，违例=实施缺陷
1. 目录分工总表
| 路径 | 角色 | 入 git | 游戏运行时引用 |
|---|---|---|---|
artwork/candidates/** |
候选原图与母版源档（PNG/.pxo/GIF/对比图/验收留底）——素材的原产地，游戏禁直接引用；随 artwork/ 整目录不入 git（design/art/candidates/ 已弃用，路径列入熵增闸退役名单） |
否（.gitignore 三行规则；*.md 指引例外） |
禁（res:// 路径禁指 candidates） |
game/assets/art/** |
游戏运行时素材唯一落地处（res://assets/art/...）——定稿素材从 artwork/candidates/ 拷贝入此，改名按圣经 §8.3 |
否（untracked，勿 git add；worktree 间需脚本拷贝同步） | 唯一合法引用源 |
game/assets/ui/icons/** |
UI 图标（状态图标批特例——唯一已提交入 git 的素材目录） | 是（状态图标入库特例） | 是 |
artwork/mockups/** |
混合样张/版式对比图（设计评审产物，非游戏素材；样张、关卡地图样张等实存于此） | 否 | 禁 |
2. 素材流（新素材批标准路径）
- 产出/候选：
artwork/candidates/对应子目录（如hero-idle/） - 验收定稿：用户拍板（候选目录留档不动）
- 入包：拷贝 →
game/assets/art/<语义子目录>/，改名§8.3域键式（如character_hero_portrait.png） - 接线：代码
res://assets/art/...引用（路径常量单点归UiKit.TEX_*）；装载一律UiKit.load_tex（exists 守卫——素材不入 git，缺位树回退），禁 preload - 提交：只提交代码/文档；PNG 与
.import（全局忽略）均不入 git - 整理（脚本链第四段：生成→验证→整理→入包）：定稿入包后当批清
artwork/candidates/子目录——保留定稿源 + 最相邻候选 2 版（默认策略，可按资产调整），其余打包归archive/；非素材残留（.url/.ogg/.ai/.swf 等）剔出；批量执行一律 dry-run 清单先行，经用户确认再动文件
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)） |
scene/ |
场景图（背景层 + 地面层 + 围墙层 + 可点物件层；营地场景图首批） | 营地 10 张：scene_camp_bg（背景层，不透明全幅=天空＋远山＋地面＋门洞小路）＋ scene_camp_wall（围墙层，透明底、门洞留透明缺口）＋ scene_camp_gate / forge / chest / notebook / dummy / board / campfire（七个可点物件）＋ scene_camp_tent（承载件，不可点）＋ scene_stage_bg_dungeon / scene_stage_bg_underdark / scene_stage_bg_deep_underdark（B 区战斗舞台背景层三关变体，✦ 插画级，顶部空区＋远景天然洞壁，不画近景地面，按 board_type 选图）＋ scene_stage_ground（B 区连续近景地面层，✦ 插画级，泥土/砂砾/碎石＋顶缘分隔带，跨关恒定）＋ scene_stage_plaza（B 区角色脚下小石台，48×12 九宫格件）——B 区战斗舞台背景与连续地面已入包；营地 10 张已入包（scene_camp_* 十件在役、TEX_CAMP_* 十键消费；用户游戏内终审如有置换，按本行键名同径替换） |
board/ |
棋盘地形材质（2026-11-07 重做后改程序化绘制，无入包地形 PNG）；seal_mark.png 现役用途=战末金蜡封徽记专用（战末弹层消费——棋盘侧贴图绘制路径已退役） | seal_mark.png（战末蜡封专用）；旧 terrain_* 63 件（16 墙瓦片＋5 地面变体×三关）随重做退役删除 |
4. 坐标/朝向等工程侧约定备查
- 素材基准朝向：角色/铲帧一律朝左入库，右向=运行时
flip_h（镜像帧不入包，right 变体留artwork/candidates/） - 挥铲握把锚：画布 (18,12)（三帧同位——以手为圆心旋转的预烤相位）
- 缩放纪律：圣经 §8.2 整数缩放为一般规则；棋盘小人 1.5× 系用户明示裁决的登记例外（注记见 art-bible §8.2）