¿Qué hace forge3d?
Puedes escribir buena geometría 3D. Lo que no puedes hacer solo es medir una imagen, ver qué produjo tu código y mantener un modelo completo a la vista mientras le prestas toda la atención a cada parte. forge3d proporciona esas tres capacidades: mide la referencia, muestra cada construcción junto a ella y divide el modelo en partes que se esculpen y verifican por separado dentro de un mismo marco compartido. Un modelo construido fuera de esto no tiene nada que lo verifique contra la referencia.
F3D="<carpeta de este SKILL.md>/scripts/f3d.py"
python3 "$F3D" doctor
Usa la ruta absoluta del lanzador al iniciar un nuevo shell. Trabaja en la carpeta de trabajo actual. Para adjuntar un archivo de escritorio, usa la ruta indicada en "Archivos mencionados por el usuario" y cópialo a la carpeta de trabajo si está en otro lugar. Entrecomilla ambas rutas de archivo. Para una construcción no supervisada, decide los detalles de diseño rutinarios a partir del dibujo. Construye a partir de la referencia: no busques en otras carpetas modelos anteriores para reutilizar, a menos que el usuario señale uno.
Al revisar un modelo existente, trabaja sobre una copia. Reconstruye la parte solicitada contra sus vecinos terminados, inspecciónala en la escena ensamblada y conserva la geometría aprobada. Una revisión de rostro puede usar el cabello y el cuerpo existentes en todo momento. Reconstruir cada parte descartaría el trabajo aprobado por el usuario.
Blender ya está aquí. f3d ejecuta un Blender headless privado (el módulo bpy, en ~/.cache/forge3d; establece F3D_HOME si un sandbox prohíbe esa carpeta). Nunca instales, descargues ni busques una aplicación de Blender. Cada construcción guarda un .blend que se abre en la aplicación Blender; python3 "$F3D" python script.py ejecuta cualquier script de Python de Blender.
Los comandos f3d tardan de 5 a 120 s. Ejecútalos en primer plano y espera a que terminen en una sola llamada (Codex: yield_time_ms de 120000 o más), en lugar de sondear. Mantén los archivos de trabajo en la carpeta de trabajo, no en /tmp.
Convenciones en todas partes: metros, Z hacia arriba, el sujeto está en z = 0 en x = y = 0 y mira hacia -Y; +X es la derecha del espectador en vista frontal. Un sujeto de referencia mide 1.0 de alto a menos que pases --height.
Una imagen de referencia es un dibujo de diseño, no un conjunto de fotografías. Una hoja de giro son tres dibujos que concuerdan aproximadamente y hacen trampa libremente: el perfil dibuja un ojo que es el mismo ojo que muestra la vista frontal, los arcos y las orejas miran al espectador en cada vista, una cola se sienta en el mismo lado del papel tanto adelante como atrás. Dice qué partes hay, de qué tamaño, dónde, qué colores, qué detalles. Construye eso como un objeto 3D consistente.
Qué ruta
- Un personaje, una criatura, cualquier cosa hecha de varias partes -> la ruta de partes a continuación.
- Un objeto simple de pocas formas (una taza, una espada, una caja, un accesorio low-poly) -> un script con el kit y
python3 "$F3D" build model.py --ref refs; consulta references/modeling.md. - Blockbench -> además de cualquiera de las anteriores, consulta "Blockbench" más abajo.
- Sin imagen de referencia, o solo una vista, y puedes generar imágenes -> primero crea una hoja de giro (frente, lado mirando a la izquierda, espalda; ortográfica, misma escala, línea de suelo común, fondo blanco liso, luz plana, sin texto); indicaciones en references/reference-and-gen3d.md.
La ruta de partes
En orden, sin saltarse ninguna: (1) f3d ref, y espera a que termine; (2) haz un inventario; (3) blockout.py y f3d blockout; (4) f3d next, una y otra vez: nombra los subagentes a generar, y esta habilidad los solicita: constructores, luego revisores independientes, luego reparadores; (5) model.py, f3d build, entrega. Tu propio trabajo es el diseño y las notas; construir y juzgar son trabajo de los agentes.
1. Medir la referencia
python3 "$F3D" ref sheet.png -o refs (30 a 90 s) recorta el sujeto, divide una hoja de giro en vistas, coloca cada vista en una cuadrícula de coordenadas e informa si el sujeto está dibujado con contornos de tinta. Espera a que termine antes de escribir nada: cada paso posterior se mide a partir de sus imágenes, y la geometría escrita desde la hoja sin procesar mientras tanto tendría que rehacerse. Abre refs/overview.png y verifica los nombres de las vistas; si son incorrectos, vuelve a ejecutar con --views front,right,back (orden de lectura; right significa que el sujeto mira a la IZQUIERDA en esa imagen, left significa que mira a la DERECHA, skip ignora una imagen, por ejemplo, una segunda pose de la espalda).
2. Hacer inventario
Enumera las partes en tu respuesta: cada cosa que sea su propio material o que se desprendería en una sola pieza. Para un personaje, típicamente de 9 a 14. Un personaje tiene un cuerpo, y es una parte: body es el cuello, torso, caderas y las piernas hasta las caderas como un sólido continuo, la base sobre la que descansa todo lo demás. La ropa son partes sobre él (on="body"): una falda o chaqueta construida sin el cuerpo debajo es un tubo vacío. Luego cabeza (el rostro le pertenece), cabello (el cabello largo o detallado son dos partes: hair_front con flequillo y mechones laterales, hair_back), cada prenda, cada accesorio, brazos y manos, zapatos, cola. Divide donde cambia el material, donde una cosa se superpone a otra, donde algo se repite (los pares son una parte). Para cada parte, decide la verdad 3D una vez donde las vistas hacen trampa: cuántas hay, dónde realmente se sienta, hacia dónde realmente mira. Cuando la ropa cubre una articulación, nombra la ranura que posee la anatomía subyacente. Por ejemplo, coloca los brazos y muñecas en la ranura del cuerpo o brazo y el puño en la ranura de la manga. Ambos muslos deben unirse a la pelvis, incluido el lado oculto en el perfil. Cuando otra ranura proporciona las piernas inferiores o medias, conéctala a la anatomía con on= para que la herramienta verifique ambos lados de forma independiente.
3. Blockout
Escribe blockout.py: el modelo completo como formas de marcador de posición aproximadas, sin pintar, cada una en el lugar correcto y con el tamaño correcto, cada una asignada a una ranura. Este es el contrato que hace que las partes construidas por separado encajen. Lee las posiciones y tamaños de refs/<vista>_grid.png.
# blockout.py
from forge3d import kit as k
head = k.sphere(radii=(0.215, 0.20, 0.225), at=(0, 0.005, 0.635))
k.slot("head", head, review="face", note="Cabeza chibi con orejas pequeñas. Coincide con las aberturas de los ojos dibujados, la mirada, las cejas y la boca. Dale forma a la mejilla, nariz y mandíbula desde el perfil. El cabello cubre parte de la frente.")
skirt = k.cyl(r=0.235, r2=0.085, h=0.20, at=(0, 0, 0.17))
k.slot("skirt", skirt, on="torso", note="Falda acampanada azul marino, plisada, con una banda bordada en oro cerca del dobladillo alrededor de todo y un volante de enagua blanco festoneado debajo.")
bows = [k.box(size=(0.07, 0.10, 0.09), at=(sx * 0.275, 0.09, 0.645)) for sx in (-1, 1)]
k.slot("bows", bows, on="hair", note="Par de lazos de cinta azul claro con una cuenta dorada. Cada dibujo los muestra mirando al espectador; en 3D se sientan en los lados de la cabeza mirando hacia afuera y un poco hacia adelante.")
- Formas:
k.sphere(radii=),k.box,k.cyl,k.loft,k.sweep(path, r=): lo aproximado está bien. on=: la(s) ranura(s) sobre la(s) que descansa o de la(s) que cuelga una parte. Una parte se construye contra la parte terminada sobre la que se asienta, así que nombra solo sobre qué descansa realmente y mantén las cadenas cortas.note=: todo lo que el constructor de la parte sabrá más allá de las imágenes. Di qué es, sus materiales y colores, cada característica que lleva, y la verdad 3D que decidiste donde las vistas hacen trampa. Una nota vaga obtiene una parte vaga.review=asigna una verificación focal cuando el nombre de la ranura es ambiguo. Usafacepara la parte que lleva la expresión,hairpara mechones detallados yjointpara el cuerpo que posee la conexión cadera-pierna. Usadetailpara otra característica priorizada por el usuario. Las partes ordinarias comparten la revisión del ensamblaje. Los nombres habituales de cabeza, cabello y cuerpo ya seleccionan sus verificaciones. Asigna un solo propietario para el rostro.
python3 "$F3D" blockout blockout.py --ref refs # 10 s -> parts/: plan.json, overview.png, una orden de trabajo por ranura
Abre parts/overview.png y parts/blockout_compare.png. Cada parte de la referencia necesita una ranura de aproximadamente el tamaño correcto en el lugar correcto (IoU de contorno alrededor de 0.8 es suficiente). Corrige y vuelve a ejecutar hasta que se cumpla.
4. Construir y revisar con f3d next
python3 "$F3D" next # imprime el estado de cada parte y los agentes exactos a generar ahora
Esta habilidad solicita explícitamente subagentes. Haz lo que imprime f3d next, luego ejecútalo de nuevo, hasta que imprima DONE:
- Para una construcción compleja basada en referencia en Codex, comienza con
gpt-6.2-astracomo líder. Cuando la cuenta ofrezcagpt-6.2-soly la herramienta de generación acepte un modelo por agente, configúralo para los constructores de partes. Mantén al líder en la planificación, el ensamblaje y la inspección final. Una sesión liderada por Sol también puede ejecutar todo el flujo de trabajo. Si el cliente no expone la selección del modelo para un subagente, deja el modelo sin establecer y usa su valor predeterminado. - Despacha hasta tres trabajos independientes a la vez. Para un nuevo constructor o revisor, usa
spawn_agent,fork_turns: "none", el nombre de la tarea impresa, el esfuerzo y el mensaje. Espera a que un trabajador informe, luego pregunta anextpor trabajos listos. Dale a cada parte un solo propietario activo. Envía las reparaciones a su constructor original confollowup_taskcuando esté disponible. El revisor se mantiene independiente. - Cada constructor inspecciona el ajuste y el renderizado. Un rostro o cabello detallado recibe una mirada cercana independiente y, después de una reparación, una verificación enfocada. Un cuerpo o detalle especificado recibe una verificación independiente. Otras partes comparten la revisión del ensamblaje a menos que su informe de construcción indique un problema estructural. Mantén los cruces de cabello dibujados y verifica cada muslo en el corte de cadera ajustado incluso cuando la prenda exterior lo cubra.
f3d reviewensambla las ranuras terminadas para sus imágenes. Solicita reparaciones por propietario. Su segunda pasada verifica esos hallazgos y las regresiones de reparación. Construye la entrega una vez que las partes se estabilicen. Inspecciona cualquier hallazgo pendiente en el límite en la escena final guardada.
Solo donde no exista una herramienta de subagente: construye cada parte tú mismo a partir de su breve descripción (references/parts.md; para un modelo cuboide "Construcción de una parte cuboide" en references/blockbench.md), sigue el mismo cronograma de next y usa references/review.md para las verificaciones visuales.
5. Ensamblar y entregar
# model.py
from forge3d import kit as k
parts = k.assemble() # cada parte terminada en su ranura; formas de marcador de posición grises para el resto
k.outline() # el contorno de tinta del dibujo alrededor de cada pieza separada (cuando f3d ref reportó arte lineal)
k.export("out/name.glb") # también .fbx .obj .stl .usdz .bbmodel
python3 "$F3D" build model.py --ref refs (uno o dos minutos) lintza el modelo, renderiza out/model_sheet.png y out/model_compare.png, y guarda out/model.blend. Después de que f3d next diga DONE, mira tú mismo una vez: python3 "$F3D" view out/model.blend --views az40el10,az-40el10,az140el10,az0el-50 --tile 1024 --cols 2 (la última es desde abajo). Maneja los hallazgos de diseño en blockout.py, vuelve a ejecutar f3d blockout y sigue f3d next para reajustar las ranuras afectadas. En el límite de revisión, compara los hallazgos listados con la construcción final guardada antes de la entrega.
Hecho significa: f3d next imprime DONE; un lint limpio; vistas de tres cuartos en las que cada característica dibujada está completa y exactamente una vez y nada está flotando, hueco o enterrado; IoU de contorno de aproximadamente 0.85 o más en cada vista, excepto donde decidiste que una vista hace trampa.
Entrega lo que se pidió: la exportación, el .blend, un render de presentación (k.stage, k.camera, k.render con el motor EEVEE predeterminado, consulta references/modeling.md). Informa al usuario los números finales, muestra la imagen de comparación y una vista de tres cuartos, y di claramente qué está simplificado, qué dejaron abierto las revisiones y qué diferencias de vista dejaste a propósito.
Para un personaje con rostro visible, renderiza python3 "$F3D" portrait out/name.blend desde el archivo escenificado final. Inspecciona la expresión, la profundidad del ojo, las sombras de la mejilla y la boca con el cabello, materiales y luces reales. La hoja incluye recortes de referencia alineados, primeros planos frontal, de perfil y de ambos tres cuartos. Si la escena tiene varias ranuras de rostro, elige una con --slot.
Cuando el rostro se vea demasiado ancho, estrecho o plano, usa portrait out/name.blend --form para comparar los planos de la mandíbula y la mejilla desnudos. Para cada punto de referencia sin obstruir, pasa --span Z LEFT_X RIGHT_X usando sus coordenadas de referencia frontal medidas. La herramienta informa el ancho de la malla allí y marca los dos puntos finales de referencia.
Blockbench
Pregunta (o infiere) qué tipo de modelo Blockbench se desea; son productos diferentes:
- Modelo de malla (el más cercano a la referencia; formas suaves con la textura real; formato Generic Model): termina el modelo como se indicó anteriormente, luego
k.export("out/name.bbmodel")en el script, opython3 "$F3D" bb mesh model.py --ref refs -o out/name.bbmodel. Cada objeto se convierte en una malla editable con nombre. - Modelo cuboide diseñado (cajas en huesos con una textura pixel-art; lo que necesitan los mods de Minecraft, entidades Bedrock / Java y animadores). Un sujeto de varias partes sigue la ruta de partes con una línea adicional en el blockout,
bb.plan(height=80, format="bedrock"): luego cada parte se construye como cuboides en huesos ybb.assemble()las une. Un mob o accesorio simple es un solo script conbb.Model. - Modelo vóxel (estatua bloqueada de cualquier modelo, muchos cuboides, sin rig):
python3 "$F3D" bb voxelize model.py --ref refs --height 48 -o out/name.bbmodel.
Con solo "hazlo en Blockbench", haz el modelo cuboide: es para lo que sirve Blockbench, y un sujeto mecánico, bloqueado o pixel-art le sienta bien. Haz el modelo de malla solo para un dibujo suave y curvilíneo (una figura chibi, un animal) o cuando se solicite. Di cuál hiciste y que el otro está disponible.
Prueba el archivo en la aplicación real cuando Blockbench esté instalado: python3 "$F3D" bb check out/name.bbmodel lo abre en un Blockbench oculto privado (sin conexión, perfil propio), informa qué se cargó, guarda la propia vista de Blockbench y puede ejecutar los exportadores de Blockbench (--export bedrock:out/name.geo.json).
API, formatos y guía de pixel-art: references/blockbench.md. Léelo antes de escribir un script de Blockbench.
Cosas que salen mal
- Falta una parte en el...