¿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
- 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). Usaprop_native_trellis2para accesorios ycharacter_nativepara personajes (aproximadamente un minuto cada uno); omitir el perfil da el valor predeterminado de accesorio.prop_lowpoly/character_lowpolyson 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 comoexperimentalno han sido verificados en esta máquina: indícalo si usas uno. - Pasa siempre la carpeta del proyecto del juego (
project_dir/--project). Suassetforge.jsonproporciona 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>). - Para 3D, aprueba la imagen primero. Llama a
generate_assetconimage_only: true(aproximadamente un minuto), mira la imagen, y solo entonces llámalo de nuevo sinimage_only(aproximadamente un minuto con los perfiles predeterminados, 4-8 con UltraTex). La segunda llamada reutiliza la imagen aprobada; no se necesita prompt. - Los trabajos 3D son asíncronos.
generate_assetdevuelve un id de trabajo; llama aget_jobconwait_seconds: 50repetidamente hasta que el estado no seaqueuedorunning. Ejecuta un activo a la vez: solo hay una GPU. - 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 para | Coste |
|---|---|---|
fast | Bloqueo, 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 |
standard | El predeterminado. Accesorios de 3.000 triángulos, personajes de 12.000 triángulos. | aproximadamente 1 minuto (nativo, medido); 4-5 minutos (UltraTex) |
max | Activos 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é.
| Problema | Solución |
|---|---|
shattered mesh | Partes 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 mesh | Vuelve a ejecutar con force: true y una nueva seed. |
decimation failed / mesh collapsed | Vuelve a ejecutar con force: true; si se repite, aumenta tris. |
flat sheet | La 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_profilesmuestra qué acepta cada perfil. - Nuevo perfil: un pequeño archivo JSON en la carpeta
assetforge_profiles/del proyecto queextendsuno existente. Consulta el README en la carpeta de Asset Forge. - Modelos y hardware: la herramienta
modelsreporta qué necesita cada perfil, qué falta y qué se adapta a esta GPU. Las descargas son grandes: pregunta al usuario antes de instalar.