CommunityImagemgithub.com

Asset Forge

Gere arte de jogos localmente e gratuitamente – imagens conceituais, ícones de UI, ilustrações e modelos 3D prontos para jogos (.glb com texturas PBR) a partir de um prompt de texto ou de uma imagem.

O que é Asset Forge?

Asset Forge é uma ferramenta que transforma texto ou imagens em arte de jogos e modelos 3D prontos para uso, executando tudo localmente na GPU da máquina (com ComfyUI como backend, iniciado automaticamente). Nada é enviado para serviços pagos. A ferramenta suporta múltiplos perfis — desde imagens conceituais e ícones até modelos 3D de alta qualidade com texturas PBR — e oferece presets como `fast`, `standard` e `max` para controlar o nível de detalhe e o tempo de geração. O fluxo de trabalho recomendado inclui: escolher um perfil, aprovar a imagem gerada antes de prosseguir para a etapa 3D, e usar chamadas assíncronas para jobs 3D. A ferramenta também oferece estilos visuais (realista, pintado à mão, cartoon, lowpoly, voxel) e permite personalização por projeto via arquivo `assetforge.json`, além de perfis customizados. É útil para desenvolvedores de jogos que precisam criar, regenerar ou corrigir assets visuais localmente, sem depender de APIs externas.

Funciona com~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 Imagem skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

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

  1. 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). Use prop_native_trellis2 para props e character_native para personagens (cerca de um minuto cada); omitir o perfil usa o padrão de prop. prop_lowpoly / character_lowpoly sã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 como experimental não foram verificados nesta máquina – diga isso se usar um.
  2. Sempre passe a pasta do projeto do jogo (project_dir / --project). O assetforge.json dela 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>).
  3. Para 3D, aprove a imagem primeiro. Chame generate_asset com image_only: true (cerca de um minuto), veja a imagem e só então chame novamente sem image_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.
  4. Jobs 3D são assíncronos. generate_asset retorna um id de job; chame get_job com wait_seconds: 50 repetidamente até que o status não seja queued ou running. Execute um asset por vez – há apenas uma GPU.
  5. 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çãoUse paraCusto
fastBloqueio, 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
standardO padrão. Props com 3.000 triângulos, personagens com 12.000 triângulos.cerca de 1 minuto (nativo, medido); 4-5 minutos (UltraTex)
maxAssets 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ê.

ProblemaCorreção
shattered meshPartes 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 meshExecute novamente com force: true e uma nova seed.
decimation failed / mesh collapsedExecute novamente com force: true; se repetir, aumente tris.
flat sheetA 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_profiles mostra o que cada perfil aceita.
  • Novo perfil: um pequeno arquivo JSON na pasta assetforge_profiles/ do projeto que extends um existente. Veja o README na pasta do Asset Forge.
  • Modelos e hardware: a ferramenta models informa 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.

Habilidades Relacionadas