DKChan
0341bdc2a9
依据＝reports/提案-营地场景图美术生成方案-2026-10-22.md §12 分层元素描述表／§11 修订清单第 2·4·7·9 条， 以及 reports/提案-营地色彩与氛围脚本-2026-10-23.md（色彩与氛围依据，色值为候选未拍板）： - art-bible §2.8：承载元素中景改木围墙（密排竖木桩／桩顶削尖／不透缝无横木），承载件由床铺换为帐篷 - art-bible §6.2：场景构成补「中景带自底部往上约 2/3 处起」＋「近景可覆盖围墙、门洞必须留空」；交付形态承载件改帐篷； 新增「色彩与氛围依据」指路（指 reports 脚本，本节不复述色值）与「待裁」三项（环境子板色值／门扇门洞高宽比／帐篷落地尺寸） - art-bible §7.5：七物件名与「近景可覆盖中景、门洞除外」口径同步 - asset-path-map §3：scene_camp_bed → scene_camp_tent - art-assets-checklist §3.5：承载件素材名同步改 tent - camp.md（design/gdd/ux/）：v2.1，物件表与纵深段按帐篷／木围墙口径重写，画法与尺寸口径回指 art-bible §6.2 术语表 43/56、02-系统清单 82、08-Alpha 106/200、art-status-checklist 32 五处经核对已在前批落地，本次零改动。 文档域闸 tools/run_all_gates.sh --docs 全绿。
38 lines
3.7 KiB
Markdown
38 lines
3.7 KiB
Markdown
# 素材路径分工约定（asset-path-map）
|
||
|
||
- 定立：2026-09-26（用户立约指令「把哪些路径、哪些位置是干什么的确定好」——状态记录 161）
|
||
- 效力：全仓素材批的路径判据单点；新素材批开工前对照，违例=实施缺陷
|
||
|
||
## 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 的素材目录） | **是**（2026-09-24 批特例） | 是 |
|
||
| `artwork/mockups/**` | 混合样张/版式对比图（设计评审产物，非游戏素材；样张 v3、关卡地图样张等实存于此）——2026-10-06 对账更正：原写的 `production/mockups/**` 系废路径 | 否 | 禁 |
|
||
|
||
## 2. 素材流（新素材批标准路径）
|
||
|
||
1. **产出/候选**：`artwork/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 固化段——脚本链第四段：生成→验证→整理→入包）**：定稿入包后当批清 `artwork/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)） |
|
||
| `scene/` | **场景图**（背景层 + 可点物件层；2026-10-22 新增，营地场景图首批） | `scene_camp_bg`（背景）＋ `scene_camp_gate / forge / chest / notebook / dummy / board / campfire`（七个可点物件）＋ `scene_camp_tent`（承载件，不可点） |
|
||
| `board/` | 砖面/封印印记（三关换皮 + 封印印记件；2026-10-06 对账更正——旧 `board_floor/wall/pillar_dungeon_*` 命名退役） | terrain_floor_<board_type>_<n>.png（三关地面系）、seal_mark.png |
|
||
|
||
## 4. 坐标/朝向等工程侧约定备查
|
||
|
||
- 素材基准朝向：角色/铲帧一律朝**左**入库，右向=运行时 `flip_h`（镜像帧不入包，right 变体留 `artwork/candidates/`）
|
||
- 挥铲握把锚：画布 (18,12)（三帧同位——以手为圆心旋转的预烤相位）
|
||
- 缩放纪律：圣经 §8.2 整数缩放为一般规则；棋盘小人 1.5× 系 2026-09-26 用户明示裁决（豁免注记归 art-bible 批另落）
|