O que Asset Forge faz?
Asset Forge transforma texto em imagens e em modelos 3D prontos para jogos na GPU desta máquina (ComfyUI por baixo dos panos; é iniciado automaticamente). Nada é enviado para um serviço pago.
Como chamá-lo
Prefira as ferramentas MCP asset-forge quando estiverem disponíveis:
list_profiles, generate_image, generate_asset, get_job, check_mesh, models, forge_status.
Caso contrário, use a linha de comando a partir da pasta do Asset Forge; cada comando imprime um objeto JSON:
python forge.py profiles
python forge.py image <nome> "<prompt>" -p icon --project <pasta do jogo>
python forge.py asset <nome> "<prompt>" -p prop_native_trellis2 --project <pasta do jogo>
python forge.py asset <nome> --image <imagem> -p character_native --project <pasta do jogo>
python forge.py check <modelo.glb>
Código de saída 0 = ok, 2 = terminou mas a malha falhou na verificação, 1 = erro.
Fluxo de trabalho
- Escolha um perfil com
list_profiles. Perfis de imagem geram figuras (concept_prop,concept_character,icon,illustration); perfis de asset geram modelos 3D com três predefinições cada (veja abaixo). Useprop_native_trellis2para props echaracter_nativepara personagens (cerca de um minuto cada); omitir o perfil usa o padrão de prop.prop_lowpoly/character_lowpolysão o pipeline UltraTex mais lento, o fallback em placas com menos de 12 GB – use-os apenas se o usuário pedir ou se a GPU for pequena. Perfis marcados comoexperimentalnão foram verificados nesta máquina – diga isso se usar um. - Sempre passe a pasta do projeto do jogo (
project_dir/--project). Oassetforge.jsondela fornece o estilo artístico, a pasta de saída e configurações por perfil, mantendo os assets consistentes. Se o projeto não tiver um, ofereça-se para criar um (forge.py init <dir>). - Para 3D, aprove a imagem primeiro. Chame
generate_assetcomimage_only: true(cerca de um minuto), veja a imagem e só então chame novamente semimage_only(cerca de um minuto com os perfis padrão, 4-8 com UltraTex). A segunda chamada reutiliza a imagem aprovada; nenhum prompt é necessário. - Jobs 3D são assíncronos.
generate_assetretorna um id de job; chameget_jobcomwait_seconds: 50repetidamente até que o status não sejaqueuedourunning. Execute um asset por vez – há apenas uma GPU. - Veja o resultado. Um job concluído retorna uma pré-visualização renderizada (vista frontal e vista três quartos) e uma verificação da malha. Não relate sucesso sem olhar a pré-visualização.
Predefinições
Passe preset para generate_asset (--preset na linha de comando). Escolha de acordo com a finalidade
do asset e diga qual usou.
| Predefinição | Use para | Custo |
|---|---|---|
fast | Bloqueio, desordem de fundo, assets distantes ou para dispositivos móveis: a menor contagem de triângulos (cerca de 800 para um prop, 4.000 para um personagem). | 1-2 minutos |
standard | O padrão. Props com 3.000 triângulos, personagens com 12.000 triângulos. | cerca de 1 minuto (nativo, medido); 4-5 minutos (UltraTex) |
max | Assets principais que a câmera vê de perto: resolução total da forma e o máximo de detalhes de textura (props com 8.000 triângulos). | mais longo; ainda não medido |
Os tempos de fast nativo e todos os tempos de max são estimados; o standard nativo foi medido em seis assuntos. Em placas com menos de 16 GB, algumas configurações são limitadas automaticamente; o
resultado as lista em limited_by_vram.
Alterar a predefinição ou qualquer parâmetro para o mesmo nome regenera o modelo, mas reutiliza a imagem conceitual; configurações idênticas retornam o resultado em cache.
Predefinições de estilo
Para uma aparência consistente em um conjunto, passe style_preset (ids em list_profiles ->
styles): realistic_pbr, hand_painted, toon, lowpoly_flat, voxel. Use o mesmo
para todos os assets de um jogo, ou defina uma vez no assetforge.json do projeto. São
experimentais; diga isso e verifique a pré-visualização. Os perfis *_native respeitam a maioria das
configurações de estilo; o style_ignored no resultado lista quaisquer que o perfil não conseguiu aplicar.
Escrevendo prompts
- Descreva apenas o sujeito: o que é, materiais, cores, desgaste, proporções. O perfil adiciona enquadramento, iluminação e fundo.
- Um objeto por asset. Pares, ou um objeto com detritos soltos, são assets separados.
- Robusto vence delicado. Fios finos, gaiolas, rendas, buracos reais e espinhos finos como cabelo quebram na etapa 3D – peça cabos grossos, uma barra sólida em vez de uma corrente, marcas gravadas em vez de buracos.
- Personagens: pessoa e roupa apenas, sem itens segurados. Faça armas como props.
Quando o resultado diz failed_check
O arquivo é escrito, mas não deve ser usado como está. problems explica o porquê.
| Problema | Correção |
|---|---|
shattered mesh | Partes finas se quebraram. Execute novamente com force: true e params: {"thin": 0.9}. Se falhar de novo, regenere a imagem com partes mais grossas e sólidas. |
spiky mesh | Execute novamente com force: true e uma nova seed. |
decimation failed / mesh collapsed | Execute novamente com force: true; se repetir, aumente tris. |
flat sheet | A imagem foi lida como plana. Regenere a imagem com "volumoso, profundo, sólido" no prompt. |
force: true junto com um prompt regenera a imagem também; force: true sem
um prompt mantém a imagem e refaz apenas a etapa 3D.
Personalização
- Por projeto: edite
assetforge.json(estilo, pasta de saída,profiles.<id>.params). - Por chamada:
params, ex.:{"tris": 5000}.list_profilesmostra o que cada perfil aceita. - Novo perfil: um pequeno arquivo JSON na pasta
assetforge_profiles/do projeto queextendsum existente. Veja o README na pasta do Asset Forge. - Modelos e hardware: a ferramenta
modelsinforma o que cada perfil precisa, o que está faltando e o que é adequado para esta GPU. Os downloads são grandes – pergunte ao usuário antes de instalar.