Community图像github.com

Asset Forge

在本地免费生成游戏美术资源——从文本提示词或图片创建概念图、UI图标、插画以及可用的3D模型(.glb格式,含PBR纹理)。适用于用户需要创建、生成、重新生成或修复游戏资源、3D模型、道具、角色模型、图标或概念图,或检查.glb文件时。

Asset Forge 是什么?

Asset Forge 是一款本地化游戏资源生成工具,无需付费服务,完全在本地GPU上运行(底层基于ComfyUI,自动启动)。它能够将文本提示词或图片转换为2D图像和游戏就绪的3D模型(.glb格式,附带PBR纹理),支持多种预设配置,包括概念道具、概念角色、图标、插画等不同用途。工具通过MCP工具接口或命令行方式调用,所有命令均以JSON格式输出结果,便于集成到AI工作流中。3D生成过程分为两步:先生成概念图供审核,再异步生成3D模型,支持fast、standard、max三种预设,分别对应不同的三角面数精度和生成时间。Asset Forge还提供了丰富的自定义选项,包括风格预设(写实PBR、手绘风、卡通风、低多边形平面、体素风格)、项目级配置文件(assetforge.json)以及参数调整功能,并内置了网格检查机制和常见问题修复建议,确保生成的3D模型质量可靠。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Noamcelermajer/comfyui-text-to-3d-mcp/tree/main/skills/asset-forge

Installed? Explore more 图像 skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

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 = 错误。

工作流程

  1. 选择配置文件:使用list_profiles查看。图像配置文件生成图片(concept_prop、concept_character、icon、illustration);资源配置文件生成3D模型,每个有三个预设(见下文)。道具使用prop_native_trellis2,角色使用character_native(各约一分钟);省略配置文件则使用道具默认值。prop_lowpoly / character_lowpoly 是较慢的UltraTex管线,适用于12GB以下显存的显卡——仅在用户要求或GPU较小的情况下使用。标记为experimental的配置文件未在本机上验证——如果使用请告知用户。
  2. 始终传递游戏项目文件夹(project_dir / --project)。其中的assetforge.json提供了美术风格、输出目录和每个配置文件的设置,确保资源风格一致。如果项目没有该文件,请提供创建选项(forge.py init <目录>)。
  3. 对于3D模型,先审核图片。 调用generate_asset并设置image_only: true(约一分钟),查看生成的图片,然后再次调用(不带image_only,默认配置文件约一分钟,UltraTex需4-8分钟)。第二次调用会复用已审核的图片,无需提供提示词。
  4. 3D任务是异步的。 generate_asset返回一个任务ID;反复调用get_job并设置wait_seconds: 50,直到状态不再是queued或running。每次只运行一个资源任务——因为只有一个GPU。
  5. 查看结果。 已完成的任务会返回渲染预览图(正面和四分之三侧面视图)以及网格检查结果。未查看预览图之前,不要报告成功。

预设

通过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的配置。下载文件较大——请先询问用户再安装。

相关技能