Community이미지github.com

Asset Forge

텍스트 프롬프트나 이미지로 게임 아트(컨셉 이미지, UI 아이콘, 일러스트레이션, PBR 텍스처가 포함된 .glb 3D 모델)를 로컬에서 무료로 생성합니다.

Asset Forge란 무엇인가요?

Asset Forge는 ComfyUI 기반으로 현재 시스템의 GPU를 활용하여 텍스트 프롬프트나 이미지로부터 게임 아트를 생성하는 AI 스킬입니다. 컨셉 이미지, UI 아이콘, 일러스트레이션 및 게임에 바로 사용 가능한 .glb 3D 모델(PBR 텍스처 포함)을 생성할 수 있으며, 모든 처리는 로컬에서 이루어져 유료 서비스로 데이터가 전송되지 않습니다. MCP 도구(asset-forge) 또는 명령줄 인터페이스로 사용할 수 있으며, 프롬프트만으로도 간단히 사용할 수 있습니다. 주요 기능으로 프로필 기반 생성, 비동기 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에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

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  <name> "<prompt>" -p icon --project <game folder>
python forge.py asset  <name> "<prompt>" -p prop_native_trellis2 --project <game folder>
python forge.py asset  <name> --image <picture> -p character_native --project <game folder>
python forge.py check  <model.glb>

종료 코드 0 = 정상, 2 = 완료되었지만 메시 검사 실패, 1 = 오류.

워크플로우

  1. list_profiles로 프로필을 선택하세요. 이미지 프로필은 그림(concept_prop, concept_character, icon, illustration)을 만들고, 에셋 프로필은 각각 세 가지 프리셋이 있는 3D 모델을 만듭니다(아래 참조). 소품에는 prop_native_trellis2를, 캐릭터에는 character_native를 사용하세요(각각 약 1분 소요). 프로필을 생략하면 소품 기본값이 사용됩니다. prop_lowpoly / character_lowpoly는 더 느린 UltraTex 파이프라인으로, 12GB 미만의 카드에서 사용하는 대체 수단입니다. 사용자가 요청하거나 GPU가 작은 경우에만 사용하세요. experimental로 표시된 프로필은 이 시스템에서 검증되지 않았습니다. 사용 시 그 점을 알리세요.
  2. 항상 게임 프로젝트 폴더를 전달하세요(project_dir / --project). 폴더 안의 assetforge.json 파일이 아트 스타일, 출력 폴더 및 프로필별 설정을 제공하므로 에셋의 일관성이 유지됩니다. 프로젝트에 이 파일이 없으면 생성할 것인지 물어보세요(forge.py init <dir>).
  3. 3D의 경우, 먼저 그림을 승인하세요. image_only: true로 generate_asset을 호출하고(약 1분), 이미지를 확인한 후에만 image_only 없이 다시 호출하세요(기본 프로필 기준 약 1분, UltraTex는 4-8분). 두 번째 호출은 승인된 이미지를 재사용하며 프롬프트가 필요하지 않습니다.
  4. 3D 작업은 비동기입니다. generate_asset은 작업 ID를 반환합니다. 상태가 queued나 running이 아닐 때까지 wait_seconds: 50으로 get_job을 반복 호출하세요. 한 번에 하나의 에셋만 실행하세요. GPU는 하나입니다.
  5. 결과를 확인하세요. 완료된 작업은 렌더링된 미리보기(정면 및 3/4 뷰)와 메시 검사 결과를 반환합니다. 미리보기를 보지 않고 성공을 보고하지 마세요.

프리셋

generate_asset에 preset을 전달하세요(명령줄에서는 --preset). 에셋의 용도에 따라 선택하고, 어떤 것을 사용했는지 알리세요.

프리셋용도비용
fast대략적인 배치, 배경 잡동사니, 원거리 또는 모바일 에셋: 가장 낮은 삼각형 수(소품 약 800개, 캐릭터 약 4,000개).1-2분
standard기본값. 3,000 삼각형 소품, 12,000 삼각형 캐릭터.약 1분 (native 기준, 측정됨); 4-5분 (UltraTex)
max카메라가 가까이 다가가는 주연 에셋: 완전한 형태 해상도와 가장 많은 텍스처 디테일(소품 8,000 삼각형).가장 오래 걸림; 아직 측정되지 않음

Native fast와 모든 max 시간은 추정치입니다. Native standard는 6개 주제에서 측정되었습니다. 16GB 미만의 카드에서는 일부 설정이 자동으로 제한되며, 결과에 limited_by_vram 아래에 나열됩니다.

같은 이름에 대해 프리셋이나 매개변수를 변경하면 모델은 다시 생성되지만 컨셉 이미지는 재사용됩니다. 동일한 설정은 캐시된 결과를 반환합니다.

스타일 프리셋

세트 전체에서 일관된 모양을 위해 style_preset을 전달하세요(list_profiles -> styles의 ID): 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 meshforce: true 및 새로운 seed로 다시 실행하세요.
decimation failed / mesh collapsedforce: true로 다시 실행하세요. 반복되면 tris를 높이세요.
flat sheet그림이 평평하게 인식되었습니다. 프롬프트에 "bulky, deep, solid"를 포함하여 이미지를 재생성하세요.

force: true와 prompt를 함께 사용하면 이미지도 재생성됩니다. force: true만 사용하고 프롬프트 없이 사용하면 이미지는 유지되고 3D 단계만 다시 수행합니다.

사용자 정의

  • 프로젝트별: assetforge.json 편집(스타일, 출력 폴더, profiles.<id>.params).
  • 호출별: params, 예: {"tris": 5000}. list_profiles는 각 프로필이 허용하는 매개변수를 보여줍니다.
  • 새 프로필: 프로젝트의 assetforge_profiles/ 폴더에 있는 기존 프로필을 extends하는 작은 JSON 파일. Asset Forge 폴더의 README를 참조하세요.
  • 모델 및 하드웨어: models 도구는 각 프로필이 필요한 것, 누락된 것 및 이 GPU에 적합한 것을 보고합니다. 다운로드는 크기가 큽니다. 설치 전에 사용자에게 물어보세요.

관련 스킬