dsh-game-material-master

English | 中文 游戏素材大师

从一张角色设定图出发，批量做出游戏里真正要用的素材。

火山方舟 Seedream 负责生图，MiniMax（或本机 ComfyUI）负责图生视频，抠像、抽帧、 像素量化、合图全部在本机用 ffmpeg 完成——不需要任何系统图像库，素材也不会被传到第三方服务。 🆕 0.11.2 更新：生图尺寸与抠像底色修复 —— 图片任务默认跟随全局尺寸，也可切「自定义」只影响本任务； 全局尺寸支持 1K / 2K / 4K 与精确宽高，ComfyUI 工作流里写死的 Empty* 尺寸也会被自动注入。 新增可配置抠像背景色（绿 / 蓝 / 品红 / 青 / 黄 / 红 / 白 / 黑 + 自定义），图片、序列帧、八方向、地图整图、 45° 物件与两套 AI 生成素材入口都可选；默认提示词里的「绿幕 / #00FF00」会跟着底色替换，用户手写原文不改。 0.11.0 更新：两套地图编辑器补上 Agent 闭环 —— mapInspect / isoInspect 按区域读逐格、物件、整图、标记与通行性， mapRender / isoRender 同步出检查图（区域裁切、放大、可叠标记 / 网格 / 通行性 / 轮廓，返回本机绝对路径交给 read_image）； applyMapOps / applyIsoOps 新增 dryRun（只校验不写盘）与 ifRevision（旧版本直接拒绝，防覆盖）。 标记可带 类型 / 颜色 / 备注 / 标签（marker update，导出格式升到 @5 / @2）；整图支持移动 / 旋转、最小占格放宽到 1×1， 素材属性里可重画通行区域；45° 物件可复制；导入素材支持直接传本机路径；所有项目 / 任务都能一键复制 ID。 另外修掉「整图多格笔刷被标记 / 橡皮借用」的问题。wire 方法 184 → 188，新增自检 verify-map-agent。 0.10.0 更新：对话工具面收成一个 game_material（action 选 guide / intake / call / status / wait / review / approve / reviewMode / upload），常驻上下文从 49 KB 降到约 4 KB，流程与方法表改成按需读手册； 模块⑤换成全本地的 45° 地图编辑器（2:1 等距、4×4 自动连接、多格 / 高处物件、动画地块、标记层、环绕、 一键生成；还能「AI 生成素材」：自动开对话生成，整理好回链到「新增素材」确认导入）； 新增可选 ToAPIs 异步图片 / 视频后端（感谢 PR #7， 来自 @ToAPIs-2025）。 0.9.x 的 音效生成（Seed-Audio）与网络重试修复继续保留。 0.10.1 修复：45° 地图编辑器「一键生成 → 大陆」不再崩溃（高度场中点插值写到了不存在的格子上）。 0.10.2 更新：ToA

八个模块共用同一套「生成 → 验收 → 重跑」工作台。每个阶段都能单独重做，每份产物都能 逐项打「通过」；「审核模式」可以选 agent 自动审完就往下走，也可以选每一步停下来等你点头。 💡 模块⑤「45°地图编辑器」的几何由代码保证，内容由你导入。 2:1 等距的步进、菱形位置、物件底面中心、遮挡顺序全部由宿主算好； 界面只执行绘制计划，所以预览与导出不会错位。自动连接是严格的 4×4 = 16 块 （N/E/S/W 位序），物件可以高出一格（树冠 / 屋顶），地面与标记四周环绕。 一次模型调用都没有，也就不花钱。 💡 模块⑥「俯视地图编辑器」借鉴了 AsPJT/AsLib 的 RPG Map Maker，按它重做为一屏、纯图标、零术语。 左边是素材调色板与 12 个图标按钮，右边就是画布。「素材」点开是一张素材列表 + 一个「新增素材」： 新增时弹窗口填素材图 / 名字 / 格子大小 / 用法 / 会动吗（鼠标移上去都有解释），一步填完 属性就定下来了，之后只能删掉重来；尺寸不用你算，留空就按图片尺寸自动识别。 内置素材默认就在列表里（自带 4 张自动连接图 + 1 张道具，水自带 2 帧动画）， 同样可以删，删错了点「恢复默认素材」一键拿回来 —— 它的属性不允许改。 自己的图该怎么排？窗口右上角那颗「素材说明」点开是三页图文：普通图块 / 整格自动连接 / 拼块自动连接各一页，图上的网格会循环隐藏、显现，几列几行、第几块是哪一种接法一眼就能看出来。 想让自己的普通素材也动，新增时选「翻页图」—— 像手翻书，每一行是一页； 拼块自动连接素材不用设，它的变体本来就是帧，列表上直接标出「会动 N 帧」。 地图大小、格子大小都能随便填（宽高各填各的）； 四周环绕在数据层：自动连接会把上下、左右两边接起来。画布拖不出地图 —— 拖到边就停， 地图左上角对齐后不会再乱动，图外那片空白也画不上； 还能一键生成随机地形 / 迷宫 / 大陆。 一次模型调用都没有，也就不花钱。 🏷️ 八个模块的新建都先问一个名字：输入框里已经填好默认名（直接回车就用默认值），点取消则不会创建； 地图项目还能随时「重命名」。 ⚠️ 模块④「骨骼动画生成」仍是实验性功能，尚未完善：拆件质量取决于生图模型，自动装配与骨骼推导 对真实立绘经常需要人工校正（agent 视觉先验或手工拖放），导出的 Spine / DragonBones 产物也还没经过 足够的引擎侧验证。界面上该模块带「实验性」角标，并在每次进入时弹窗说明。本文只展示前三个模块。 如果你需要它、或者想一起把它做扎实，欢迎到 GitHub 仓库 参与开发， 或加入 QQ 群 1126382236（见文末「交流与反馈」）。 ① 八方向图生成

一张正面设定图进去，八个方位一次做完：绿幕图 → 行走视频 → 序列帧 → 精灵整图 → 可操控预览。

① 的两种生成方式：转圈截帧（默认）/ 逐方向生图

八张方向图有两条产法，产物完全一样（images/ .png），所以后面四步不用换做法： 界面上那一排圆圈就是八个方位的截帧位置，底下的缩略条带是整圈候选帧——对着画面拖， 松手就重切那一张（并自动作废这个方位的行走视频与序列帧，避免新旧朝向混在一起）。 默认位置是「从正面开始、匀速转满一圈」的等分假设；模型实际转的方向或快慢不一样时， 直接拖圆圈，或点一下「转圈方向」重排。改变候选帧数（8~512）会自动重抽，并把拖过的位置按比例换算。 也可以直接用自己电脑上的视频（阶段①、②都能）

两处「要生成视频」的地方都不只有「调模型生成」一条路：手上已经有一段合适的视频时， 点选择本地视频把它选进来即可，产物和生成出来的完全一样，后面几步照旧走。 阶段①·转圈视频：选进来的是「角色原地匀速转一圈」的绿幕视频，导入后插件会立刻 自动抽候选帧并切出八个方向，接着拖圆圈调位置就行。 阶段②·某个方位的行走视频：每一格都能单独选自己的一段（固定机位、原地走）， 之后照旧在第 3 步「提取全部序列帧」。 支持 MP4 / MOV / M4V / WebM / MKV / AVI（按文件头认，不看扩展名），单个 ≤100MB； 这一段只在本机用 ffmpeg 处理，不会上传到任何模型。 换掉某一段视频时，它下游已经抽出来的帧与整图会自动作废，避免拿上一段视频的帧去合成。 中间图片都能存下来

一路生成下来的每一张图都能保存：八方向绿幕图、转圈候选帧与整圈条带、每段视频抽出来的 绿幕帧与手动选帧候选、抠完绿幕的帧、合成整图。界面里看得见的产物每张都有「保存」链接； 候选帧一抽就是 32~64 张，所以底部另有一个 保存全部图片（zip）——打成一个包，里面按项目 目录的结构摆好（images/…、turn/…、frames/…、keyed/…、out/sheet.png）。 生成出来的成片（转圈视频、八段行走视频）同样各自有一个「保存视频」链接。 怎么用

1. 新建项目 → 上传设定图，写提示词（转圈截帧用的是一份转圈视频提示词；逐方向生图是每个方位一份， 另有「统一附加提示词」八个方向共用）。 2. 生成转圈视频（默认路径）：角色原地匀速转一整圈，绿幕背景。视频到手后插件会自动抽候选帧 并切出八个方向，一般不需要你动手。逐方向生图（备选）则是一键生成全部：八个方位按依赖顺序 出绿幕全身图。逐张能看到用时、落到哪个模型；不满意就重新生成这一张，或展开编辑提示词只改它。 3. 生成全部视频：让角色在原方位原地走三步。这一步最贵、也最慢（单段