CommunityImagengithub.com

Asset Forge

Genera arte de videojuegos localmente y de forma gratuita: imágenes conceptuales, íconos de UI, ilustraciones y modelos 3D listos para el juego (.glb con texturas PBR) a partir de un texto o una imagen. Úsalo cuando el usuario solicite crear, generar, regenerar o corregir un activo de juego, modelo 3D, accesorio, modelo de personaje, ícono o imagen conceptual, o para verificar un archivo .glb.

¿Qué es Asset Forge?

Asset Forge es una herramienta de generación de activos para videojuegos que convierte texto o imágenes en modelos 3D listos para usar y arte conceptual, ejecutándose localmente en la GPU sin enviar datos a servicios de pago. Soporta perfiles para imágenes (conceptos, íconos, ilustraciones) y modelos 3D (accesorios, personajes), con tres niveles de detalle (rápido, estándar, máximo) y presets de estilo como PBR realista, pintado a mano, toon o voxel. Integra ComfyUI en segundo plano y proporciona herramientas MCP y una CLI basada en Python para gestionar trabajos asíncronos, verificar mallas y personalizar parámetros por proyecto. Es especialmente útil para desarrolladores o diseñadores que necesitan iterar rápidamente en activos de juego manteniendo consistencia de estilo a través de archivos de configuración de proyecto.

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

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

¿Qué hace Asset Forge?

Asset Forge convierte texto en imágenes y en modelos 3D listos para el juego en la GPU de esta máquina (ComfyUI por debajo; se inicia automáticamente). No se envía nada a un servicio de pago.

Cómo invocarlo

Prefiere las herramientas MCP asset-forge cuando estén disponibles: list_profiles, generate_image, generate_asset, get_job, check_mesh, models, forge_status.

De lo contrario, usa la línea de comandos desde la carpeta de Asset Forge; cada comando imprime un objeto JSON:

python forge.py profiles
python forge.py image  <nombre> "<prompt>" -p icon --project <carpeta del juego>
python forge.py asset  <nombre> "<prompt>" -p prop_native_trellis2 --project <carpeta del juego>
python forge.py asset  <nombre> --image <imagen> -p character_native --project <carpeta del juego>
python forge.py check  <modelo.glb>

Código de salida 0 = ok, 2 = finalizado pero la malla falló la verificación, 1 = error.

Flujo de trabajo

  1. Elige un perfil con list_profiles. Los perfiles de imagen crean imágenes (concept_prop, concept_character, icon, illustration); los perfiles de activo crean modelos 3D con tres preajustes cada uno (ver más abajo). Usa prop_native_trellis2 para accesorios y character_native para personajes (aproximadamente un minuto cada uno); omitir el perfil da el valor predeterminado de accesorio. prop_lowpoly / character_lowpoly son el pipeline UltraTex más lento, la alternativa en tarjetas de menos de 12 GB; úsalos solo si el usuario lo solicita o la GPU es pequeña. Los perfiles marcados como experimental no han sido verificados en esta máquina: indícalo si usas uno.
  2. Pasa siempre la carpeta del proyecto del juego (project_dir / --project). Su assetforge.json proporciona el estilo artístico, la carpeta de salida y configuraciones por perfil, para que los activos sean coherentes. Si el proyecto no tiene uno, ofrécete a crearlo (forge.py init <dir>).
  3. Para 3D, aprueba la imagen primero. Llama a generate_asset con image_only: true (aproximadamente un minuto), mira la imagen, y solo entonces llámalo de nuevo sin image_only (aproximadamente un minuto con los perfiles predeterminados, 4-8 con UltraTex). La segunda llamada reutiliza la imagen aprobada; no se necesita prompt.
  4. Los trabajos 3D son asíncronos. generate_asset devuelve un id de trabajo; llama a get_job con wait_seconds: 50 repetidamente hasta que el estado no sea queued o running. Ejecuta un activo a la vez: solo hay una GPU.
  5. Mira el resultado. Un trabajo finalizado devuelve una vista previa renderizada (frente y vista de tres cuartos) y una verificación de la malla. No reportes éxito sin mirar la vista previa.

Preajustes

Pasa preset a generate_asset (--preset en la línea de comandos). Elige según para qué sea el activo, y di cuál usaste.

PreajusteÚsalo paraCoste
fastBloqueo, desorden de fondo, activos distantes o móviles: el menor recuento de triángulos (aproximadamente 800 para un accesorio, 4.000 para un personaje).1-2 minutos
standardEl predeterminado. Accesorios de 3.000 triángulos, personajes de 12.000 triángulos.aproximadamente 1 minuto (nativo, medido); 4-5 minutos (UltraTex)
maxActivos principales a los que la cámara se acerca: resolución completa de la forma y el máximo detalle de textura (accesorios de 8.000 triángulos).el más largo; aún no medido

Los tiempos rápidos nativos y todos los máximos son estimaciones; el estándar nativo fue medido en seis sujetos. En tarjetas de menos de 16 GB, algunas configuraciones se limitan automáticamente; el resultado las lista bajo limited_by_vram.

Cambiar el preajuste o cualquier parámetro para el mismo nombre regenera el modelo pero reutiliza la imagen conceptual; configuraciones idénticas devuelven el resultado en caché.

Preajustes de estilo

Para una apariencia coherente en un conjunto, pasa style_preset (ids en list_profiles -> styles): realistic_pbr, hand_painted, toon, lowpoly_flat, voxel. Usa el mismo para cada activo de un juego, o configúralo una vez en el assetforge.json del proyecto. Son experimentales; indícalo y verifica la vista previa. Los perfiles *_native respetan la mayoría de las configuraciones de estilo; el style_ignored del resultado lista aquellas que el perfil no pudo aplicar.

Redacción de prompts

  • Describe solo el sujeto: qué es, materiales, colores, desgaste, proporciones. El perfil añade encuadre, iluminación y fondo.
  • Un objeto por activo. Pares, o un objeto más escombros sueltos, son activos separados.
  • Robustez supera delicadeza. Cables finos, jaulas, encajes, agujeros reales y púas finas como cabellos se rompen en el paso 3D: pide mangos gruesos, una barra sólida en lugar de una cadena, marcas grabadas en lugar de agujeros.
  • Personajes: solo persona y vestimenta, sin objetos sostenidos. Haz las armas como accesorios.

Cuando el resultado dice failed_check

El archivo se escribe pero no debe usarse tal cual. problems explica por qué.

ProblemaSolución
shattered meshPartes delgadas se rompieron. Vuelve a ejecutar con force: true y params: {"thin": 0.9}. Si falla de nuevo, regenera la imagen con partes más gruesas y sólidas.
spiky meshVuelve a ejecutar con force: true y una nueva seed.
decimation failed / mesh collapsedVuelve a ejecutar con force: true; si se repite, aumenta tris.
flat sheetLa imagen se leyó como plana. Regenera la imagen con "voluminoso, profundo, sólido" en el prompt.

force: true junto con un prompt regenera también la imagen; force: true sin un prompt mantiene la imagen y solo rehace el paso 3D.

Personalización

  • Por proyecto: edita assetforge.json (estilo, carpeta de salida, profiles.<id>.params).
  • Por llamada: params, por ejemplo {"tris": 5000}. list_profiles muestra qué acepta cada perfil.
  • Nuevo perfil: un pequeño archivo JSON en la carpeta assetforge_profiles/ del proyecto que extends uno existente. Consulta el README en la carpeta de Asset Forge.
  • Modelos y hardware: la herramienta models reporta qué necesita cada perfil, qué falta y qué se adapta a esta GPU. Las descargas son grandes: pregunta al usuario antes de instalar.

Skills relacionados