Asset Forge 是做什么的?
Asset Forge 利用本机GPU将文本转换为图像,再转换为可用于游戏的3D模型(底层基于ComfyUI,自动启动)。所有处理均在本地完成,无需付费服务。
如何调用
优先使用**asset-forge MCP工具**(当可用时):
list_profiles、generate_image、generate_asset、get_job、check_mesh、models、forge_status。
否则,在 Asset Forge 目录下使用命令行;每条命令输出一个JSON对象:
python forge.py profiles
python forge.py image <名称> "<提示词>" -p icon --project <游戏文件夹>
python forge.py asset <名称> "<提示词>" -p prop_native_trellis2 --project <游戏文件夹>
python forge.py asset <名称> --image <图片> -p character_native --project <游戏文件夹>
python forge.py check <模型.glb>
退出码 0 = 成功,2 = 完成但网格检查失败,1 = 错误。
工作流程
- 选择配置文件:使用
list_profiles查看。图像配置文件生成图片(concept_prop、concept_character、icon、illustration);资源配置文件生成3D模型,每个有三个预设(见下文)。道具使用prop_native_trellis2,角色使用character_native(各约一分钟);省略配置文件则使用道具默认值。prop_lowpoly/character_lowpoly是较慢的UltraTex管线,适用于12GB以下显存的显卡——仅在用户要求或GPU较小的情况下使用。标记为experimental的配置文件未在本机上验证——如果使用请告知用户。 - 始终传递游戏项目文件夹(
project_dir/--project)。其中的assetforge.json提供了美术风格、输出目录和每个配置文件的设置,确保资源风格一致。如果项目没有该文件,请提供创建选项(forge.py init <目录>)。 - 对于3D模型,先审核图片。 调用
generate_asset并设置image_only: true(约一分钟),查看生成的图片,然后再次调用(不带image_only,默认配置文件约一分钟,UltraTex需4-8分钟)。第二次调用会复用已审核的图片,无需提供提示词。 - 3D任务是异步的。
generate_asset返回一个任务ID;反复调用get_job并设置wait_seconds: 50,直到状态不再是queued或running。每次只运行一个资源任务——因为只有一个GPU。 - 查看结果。 已完成的任务会返回渲染预览图(正面和四分之三侧面视图)以及网格检查结果。未查看预览图之前,不要报告成功。
预设
通过generate_asset的preset参数传递(命令行中使用--preset)。根据资源用途选择,并说明使用了哪种预设。
| 预设 | 用途 | 耗时 |
|---|---|---|
fast | 用于初稿、背景杂物、远处或移动端资源:三角面数最低(道具约800个,角色约4000个)。 | 1-2分钟 |
standard | 默认值。道具3000个三角面,角色12000个三角面。 | 约1分钟(原生,已测量);4-5分钟(UltraTex) |
max | 摄像机靠近的精选资源:完整形状分辨率,最多纹理细节(道具8000个三角面)。 | 最长;尚未测量 |
原生fast和所有max的耗时为估算值;原生standard已在六个样本上测量。在16GB以下显存的显卡上,部分设置会自动限制;结果会在limited_by_vram下列出。
更改同一名称的预设或任何参数会重新生成模型,但复用概念图;完全相同的设置会返回缓存结果。
风格预设
为保持一套资源外观一致,可传入style_preset(ID见list_profiles -> styles):realistic_pbr、hand_painted、toon、lowpoly_flat、voxel。对同一游戏的所有资源使用相同的风格预设,或在项目的assetforge.json中设置一次。这些风格预设为实验性功能;请告知用户,并检查预览图。*_native配置文件能应用大部分风格设置;结果中的style_ignored会列出配置文件无法应用的风格。
编写提示词
- 仅描述主体:物品是什么、材质、颜色、磨损程度、比例。配置文件会自动添加构图、光照和背景。
- 每个资源一个物体。成对物体或物体加零散碎片应作为独立资源处理。
- 粗壮优于精巧。细线、笼子、蕾丝、真实孔洞和发丝般细的尖刺会在3D步骤中损坏——要求使用粗手柄、实心杆代替链条、刻痕代替孔洞。
- 角色:仅描述人物和服装,不包含手持物品。武器作为道具单独生成。
当结果显示为 failed_check
文件已生成但不应直接使用。problems会说明原因。
| 问题 | 修复方法 |
|---|---|
shattered mesh | 薄部件破裂。重新运行,添加force: true和params: {"thin": 0.9}。若再次失败,重新生成图片,要求部件更厚实、更实心。 |
spiky mesh | 重新运行,添加force: true和新的seed。 |
decimation failed / mesh collapsed | 重新运行,添加force: true;若重复出现,增加tris值。 |
flat sheet | 图片被识别为平面。在提示词中加入“粗壮、深邃、实心”后重新生成图片。 |
force: true与prompt一起使用时,会重新生成图片;force: true不带prompt则保留图片,仅重新执行3D步骤。
自定义
- 按项目:编辑
assetforge.json(风格、输出目录、profiles.<id>.params)。 - 按调用:使用
params,例如{"tris": 5000}。list_profiles显示每个配置文件可接受的参数。 - 新建配置文件:在项目的
assetforge_profiles/文件夹中新建一个小的JSON文件,extends已有配置文件。详见 Asset Forge 文件夹中的README。 - 模型和硬件:
models工具报告每个配置文件需要什么、缺少什么以及适合当前GPU的配置。下载文件较大——请先询问用户再安装。