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