江湖 · 战场背景重绘(东方武侠水墨淡彩)
任务(用户原话):了解原游戏所有战场的背景图,按名称与其本身背景图的元素布置, 在原图位置上把这些元素绘制成东方武侠风格;原图分「场地背景 + 前景模块」两层结构, 新图也按此结构;交付全部战场重绘 + HTML 预览对比表。 决策:D-067~D-070(盘点与范围)、D-078~D-080(风格定案 / 出图策略 / 入库时机), 见 docs/game-design-decisions.md。最后更新:2026-10-26。
1. 结论先说
| 项 | 结果 |
|---|---|
| 战场总数 | 203 张(tb_battlemap,含演武场 100 层、4 个试炼、灵兽牧场、练功木桩) |
| 实际显示的唯一背景组合 | 23 种(按场地层归并为 17 个场景族) |
| 模块结构 | 原图实际是三层:远景层 FarBg + 场地层 MidBg + 前景层 NearBg |
| 需重绘图层 | 62 张(远景 21 / 场地 21 / 前景 20) |
| 已重绘 | 61 张;battlebg_icefg1 alpha 全为 0(全透明空图),重绘后仍不可见,保持原样 |
| 画风 | 水墨淡彩:水墨笔触 + 花青/赭石淡设色 + 宣纸质感(D-078) |
| 题材改造 | 题材级替换、位置不动(D-068):斗技场→中式擂台、哥特彩窗→中式宫阙、骑士雕像→道童石俑、骷髅荒冢→乱葬岗墓碑、罗马拱券→牌楼月洞门 |
| 交付 | _preview_battle_bg.html(原图 vs 重绘,含 203 张战场清单;图片全部内嵌 base64,单文件自包含约 10MB);素材库 tools/battleground/out/final/ |
| 入库 | 尚未覆盖游戏素材,按 D-080 等预览表认可后再执行 |
2. 为什么要归并成 62 张
client/src/game/assets.js 的 battleBg() 对每个槽位数组按顺序取第一张存在的图, 所以配置里写了 2~3 个变体的地图,永远只显示变体 1。把 203 张地图按 「(far, mid, near) 实际取到的三元组」归并,只得到 23 种组合、62 个图层文件。
86 张原图里有 24 张永远不会显示(变体 2/3、bg_test2、已随 D-045 下线的村庄图等), 按 D-069 不重绘。完整清单位于 tools/battleground/out/layers.json(脚本生成,勿手改)。
场景族与战场对应(17 族):
| 族 | 战场名(前几例) | 等级 | 地图数 |
|---|---|---|---|
| forest | 青竹驿 / 临渊城营地 / 鼠妖巢穴 / 一线生路 | 2–100 | 6 |
| darkforestg | 幽篁入口 / 寒杉幽径 / 邪祟巢穴 | 1–35 | 7 |
| darkforest | 苦行古道 / 雪林小径 | 46–83 | 3 |
| cave | 阴湿石窦 / 崩石洞窟 / 废矿场 / 迷魂洞 | 4–90 | 18 |
| ruins | 荒草陷坑 / 山魈巢寨 / 高原废城 | 10–80 | 12 |
| graveyard | 乱葬岗上层/下层 / 埋骨荒滩 | 19–64 | 11 |
| fall | 荒草野径 / 赤霄城郊 | 12–85 | 2 |
| lab | 临渊暗河 / 邪祟聚落 / 心魔试炼 | 15–100 | 3 |
| citysquare | 临渊法坛 / 临渊城外围 / 赤霄关 / 沙埋孤村 | 31–79 | 9 |
| desert | 流沙迷障 / 残破哨岗 / 风化石林 / 赤霄旱海 | 25–60 | 14 |
| volcano | 赤霄火滩 / 仙泪湖 / 地火之域 / 熔岩湖 | 56–99 | 9 |
| ice | 仙神陨落处 / 落星湖 | 86–94 | 2 |
| snow | 雪岭古道起点/终点 / 苍白雪径 | 88–95 | 3 |
| throne | 白玉绝顶 / 天裂终局 / 破军·求生·御法试炼 | 98–100 | 5 |
| castle | 练功木桩 | 99 | 1 |
| arena | 演武场·第 1–100 层 | 101–110 | 100 |
| battebg_bridge | 灵兽牧场 | 0 | 1 |
3. 三层在游戏里怎么叠(合成规则照抄 stage.js)
远景 far → 铺满 1120×384(原图即被拉伸,保持原有构图)
场地 mid → 铺满 1120×384,透明区露出远景
前景 near → 宽度铺满、高度按原比例、底部对齐(贴底遮挡带)
所以:
- 远景层必须重绘。场地层有 20%~40% 是透明的,旧远景会从镂空处露出来,
不换就会出现「上半截还是暗黑绿色旧森林」的割裂(首轮样张实测)。
- 透明通道必须逐像素还原,否则整张变成不透明方图,镂空与羽化边全丢。
- 前景层原图只有 34~155px 高,直接按原尺寸送进模型会糊成一条 —— 先按「短边保底 64」
等比放大再出图,最后缩回原始尺寸。
4. 管线(tools/battleground/)
| 脚本 | 作用 |
|---|---|
inventory.py | 扫 tb_battlemap + i18n + 背景目录 → out/layers.json(场景族 / 23 组合 / 62 图层 / 每层被哪些战场用) |
prompts.py | 17 族的提示词库:STYLE 风格锚 + 每族 far/mid/near 三段「原图有什么 → 换成什么中式对应物 → 色调」,含同族第二变体(cave2/desert2/snow2/volcano2)的差异化描述 |
gen.py | ComfyUI img2img(Z-Image Turbo):底层图 + 提示词 + denoise;自动按 8 的倍数对齐尺寸、短边保底、出图后居中裁回原尺寸;plan/one/sample/batch 四个子命令,batch 支持断点续跑与跳过全透明层 |
post.py | 水墨淡彩调色(降饱和、黑场抬到墨色、宣纸混入、纸纹)+ 还原原图 alpha + 细线清理(开运算) |
compose.py | 按游戏规则合成舞台图(旧版/重绘各一套)+ 逐图层上下对比图;顺带叠角色与怪物示意,方便判断「背景能不能承托角色」 |
qa.py | 体检:SSIM 结构保持、地平线偏移、明度差、色相漂移 → out/qa.md,嫌疑图出并排对照 |
build_preview.py | 生成 _preview_battle_bg.html(场景族对比 + 203 张战场清单 + 搜索)。图片压成 JPEG 后以 base64 内嵌,HTML 自包含:早先用相对路径引用 out/thumb/*.png,通过 GUI 预览或被单独拷出去打开时图片全部显示不出来 |
import_bg.py | 入库(默认 dry-run):校验尺寸/通道 → 备份 → 覆盖;--rollback <时间戳> 回滚 |
出图参数(D-078 定案)
| 层 | denoise | 理由 |
|---|---|---|
| 远景 far | 0.73 | 保留天际线/山形结构,只换题材与画风 |
| 场地 mid | 0.72 | 题材级替换,但不能给模型太多自由发挥空间(0.78 时它在地面堆碎石杂草,见第 5 节第 9 条) |
| 前景 near | 0.82 | 前景是最「西幻」的部分(木桩、断剑、紫色晶簇),要换得狠一些 |
远景层暖色清理(D-085,2026-10-26)
地面变干净之后,远景层里 AI 点的暖色(红光、火把、雪脊晚霞)反而最扎眼。 处理:12 个冷色族的远景层做连续暖色抑制 —— 暖色度 = R − max(G,B),按 0.62 削减并转青。
- 先用 HSV 阈值法(色相 0~32°/232~255°,饱和 >55),漏掉了雪脊上的粉橙(饱和度只有 30~55);
- 改成连续公式后没有硬阈值、也没有斑块边缘硬边;黄绿(
R≈G>B)几乎不受影响; - 火山 / 沙漠 / 秋野 / 擂台的暖色是主题色,不处理。
场地层重建:AI 只画贴图,地面靠程序铺装(D-083,2026-10-26)
用户第二轮反馈(castle 有大木架、cave2 山石太多、darkforest 左侧有树、 darkforestg 不该有树、fall 物品太多)并明确要求: 每个 midbg 都应该是干净清爽的地面,不该有过多大物品、树木。
三次尝试证明 img2img 根本生成不出「纯地面」:
| 做法 | 结果 |
|---|---|
| 整张 mid 送 img2img(denoise 0.72) | AI 把原图的树/木架/山石一起画出来 |
| 提高 denoise 到 0.82 | 它反而新添建筑、栏杆、树 |
| 只裁地面区送 img2img | 它把宽条带当场景条,又画了栅栏、木桩、帐篷 |
最终方案(tools/battleground/gen_ground_tex.py):
- AI 只生成一张四方连续的地面贴图(512×512,提示词封锁任何物件,17 族各一张)
- 程序铺装:横向镜像平铺 2 次(只有 2 个周期,人眼不觉得重复)→ 纵向压缩当透视
→ 叠两层 fBm 噪声补质感 → 9px 高斯 30% 混合揉掉接缝
- 水墨调色 + 去紫 + 按族做均值色彩匹配(
GROUND_TINT,避免所有地面被拉成同一片灰白) - 地平线以上 alpha 置 0 → 露出远景层的水墨山水;交界处 26px 渐变
- 地平线比例按族目测写死在
gen_ground.py的TOPS表(17 族 21 层)
结果:地面只有连续材质(青石缝 / 砖缝 / 沙纹 / 雪坡 / 冰裂),没有任何树木、木架、 山石、墓碑、栅栏;上半部交给远景层,层次变成「远景山水 + 干净地面 + 前景遮挡带」。
注意:这条路线不再使用out/raw/里的 mid 生成图,post.py的clean_ground/kill_purple对场地层也就不再生效(调色已内置在gen_ground_tex.py里)。
前景层改为程序化水墨化(D-082,2026-10-26)
前景遮挡带(near,20 张,原图只有 26~155px 高)不走 AI 重绘:
- 送进模型后 AI 会往剪影里塞苔藓、橙色斑点、黑枝,比原图更脏(雪丘上长苔藓);
- 低 denoise 也不行 —— 会保留原图的硬边高对比,调色后成了「暗底上的亮块」;
- 程序化 = 原图水墨调色 + 去紫 + 0.5px 柔化 + 还原剪影,干净且与三层风格统一。
代价:前景的内容不换题材(紫晶还是晶体形状,只是被拉成青绿)。实测在 1120×384 舞台上, 它只是贴底 40~64px 的遮挡带,观感上不违和;真要换题材需要单独手工处理。
场地层「干净化」(D-081,2026-10-26 用户反馈后重做)
战斗时角色与怪物都站在场地层,旧版这一层是大片连续地面 + 少量大装饰; 第一版(denoise 0.78)把它画成了「碎石 + 杂草 + 枯枝 + 树影」的野地,抢视线也不好读。 四件事一起改:
- 描述改两段式:
画面上部是<装饰:竹林/岩壁/墓碑/木栏>,地面是连续完整的<材质>,
每族一个 ground 字段(青石板 / 沙丘纹 / 积雪坡面 / 白玉石板…)。
- 干净约束(
CLEAN_TEMPLATE):画面中部(角色活动区)不许有任何散落物件,
杂物只能退到左右两角,每角最多 1~2 个大型装饰当路标。
- 负向词分层(
NEG_MID):碎石堆 / 乱石堆 / 杂草丛生 / 枯枝 / 藤蔓缠绕 / 密集纹理 /
落叶铺满 / 石笋群…只在场地层加。
- denoise 0.78 → 0.72:少给自由发挥空间。
第二轮用户点名 cave2 / darkforestg / snow1 / volcano1 / volcano2 五张「中间内容太多」后追加:
- 这五张在
VARIANT里单独覆盖场地层描述,显式写「画面中部没有任何<该族最常见杂物>」; - 负向词补
零散岩石 / 小石块 / 散落物 / 水洼 / 亮斑 / 碎屑; - 新增
clean_ground()后处理(GROUND_CLEAN名单):画面 y=0.30 以下做中值滤波 9 + 大半径低通,
按 smoothstep 垂直渐变叠回,把散落小物件擦成柔和色块,上半部装饰带不受影响。
另外低 denoise 会把原图的紫色晶体带留下来(纯西幻元素), 新增 kill_purple() 后处理:色相 289~360°(紫→品红,实测原图森林地面「粉灰」落在这一段) 拉到青绿并降饱和;只作用于场地层,不动夜景与幽蓝洞窟。
统一后处理:饱和度 0.92 / 对比 0.94 / 黑场 0.085 / 提亮 0.035 / 宣纸混入 0.10 / 纸纹 0.045; 透明通道开运算:场地 5×5、前景 3×3(远景不动)。
常用命令
python tools/battleground/inventory.py # 重新盘点(改了地图配置后必跑)
python tools/battleground/gen.py plan # 看待画清单
python tools/battleground/gen.py one --layer battlebg_forest1 --denoise 0.78 --seed 7 # 单张重出
python tools/battleground/gen.py batch --slots far,mid,near --seed 1 # 全量
python tools/battleground/post.py # 后处理(读 out/raw → 写 out/final)
python tools/battleground/compose.py --layers # 合成 + 逐层对比
python tools/battleground/qa.py # 体检
python tools/battleground/build_preview.py # 出预览表
python tools/battleground/import_bg.py # 入库检查(加 --apply 才真正覆盖)
5. 踩过的坑(下一批别再踩)
- 尺寸不是 8 的倍数:原图有 241 / 156 / 263 高,latent 必须 8 的倍数。
用 round 会向下取整(241→240),出图后中央裁剪就会错位 → 一律 ceil, 并在裁剪前兜底 resize。
- 前景层太扁:41~48px 高按原尺寸出图等于把 4M 像素的模型喂一条 100k 像素的图,
出来全是糊块。短边保底 64 等比放大是必要条件。
- 透明通道不能重新生成:AI 出图一律 RGB,透明必须从原图 alpha 还原,
否则镂空、羽化边、贴底遮挡关系全变。
- 原图镂空边缘的蛛丝:暗黑原图里是「蛛网」装饰,水墨化后变成刺眼白线,
武侠竹林里也讲不通 → alpha 开运算(场地 5×5 / 前景 3×3)只吃掉 1~2px 细线。
- 洞窟被画成山水:提示词只写「岩壁剪影」时,模型按山水画理解,
生成了带亭子的山景。改写成「洞窟内部、头顶岩顶、不见天空/远山/建筑」后才对。 → 凡是室内/地下场景,提示词必须显式封杀天空与建筑。
- 调色过灰会毁掉场景区分度:首版用饱和 0.82 + 宣纸混入 0.16,
结果森林/洞窟/废墟/墓地全部变成同一种灰青,17 族分不出来。 调到饱和 0.92 + 宣纸 0.10 后恢复。
- QA 阈值要按实测定:denoise 0.78 的 SSIM 天然落在 0.14~0.35(结构按设计被改造),
拿 0.8 当「几乎没改」的阈值会把正常图全标成嫌疑。地平线检测在淡彩重调色后 本身就有 10~30% 漂移,只能抓极端值。
- 前景遮挡带别交给 AI:26~155px 高的小图,模型会往剪影里塞杂点(雪丘上长苔藓),
低 denoise 又保留硬边高对比。这类层走程序化调色最稳(见 D-082)。
- 并行任务线会改同一批文件:本仓库同时有别的任务线在改
docs/game-design-decisions.md
与 client/src/style.css,写台账时撞过两次「文件已变更」,改完必须重新读一次磁盘。
6. 体检与视觉验收
out/qa.md:61 张逐层指标(SSIM / 明度 / 地平线 / 色相)。当前 44 张被打标,
绝大多数是算法口径问题而非画错:远景层原图下半是纯色留白,SSIM 天然极低; 前景层不透明区只占 4%~38%,SSIM 天然偏高。真正需要复看的是被标「明度偏 +0.28 以上」 或「色相偏 110° 以上」的极少数。
- 逐层对照:
out/layers_cmp/<图层名>_cmp.png(上原图、下重绘)。 - 舞台对照:
out/stage/<族>_<n>_orig.png与_new.png。 - 首轮重出记录(seed 1 → seed 3):
battlebg_cavebg1/battlebg_cavebg2:首轮把洞窟画成带亭子的山水 → 改提示词重出battlebg_cave1:首轮把暗河水面画成石阶地面 → 改提示词重出battlebg_castlebg1:首轮过暗 → 改提示词(月洞门 + 墙头天光)重出
仍可继续打磨的点(不影响交付)
| 场景族 | 现象 | 可选的下一步 |
|---|---|---|
| lab | 室内远景偏暗、原图的绿色发光窗消失 | 提示词补「幽绿灯火窗」,denoise 提到 0.78 |
| castle / cave | 画面里残留少量原图暖色斑块 | 提高到 0.8 再重出,或后处理局部去色 |
| battebg_bridge | 草地偏空,原图的大树被镂空吃掉一部分 | 远景层重出时强调「近景大树」 |
| desert | 原图强烈的树影投射在新图里变淡 | 需要更强的光影提示词,或改用 ControlNet 保结构 |
7. 入库(D-080,等你认可预览表后再执行)
python tools/battleground/import_bg.py # 只检查:尺寸/通道是否与原图一致
python tools/battleground/import_bg.py --apply # 备份 + 覆盖
python tools/battleground/import_bg.py --rollback <时间戳> # 回滚
覆盖前会把整个 client/public/assets/static/background/ 备份到 .backup/background-<时间戳>/ 并写 MANIFEST.txt,回滚按目录还原。 素材目录按 D-003 不入 git。