CommunityProgramación y desarrollogithub.com

Papercraft

Construye en el navegador juegos, páginas, animaciones y vídeos como dioramas de papel: bisagras de cartulina, sombras suaves y un objetivo macro descentrable, para cualquier tema.

¿Qué es Papercraft?

Un sistema visual reutilizable. Las piezas ilustradas se levantan de un suelo impreso, suben con un pequeño rebote y proyectan sombras cálidas, encuadradas como una maqueta fotografiada. Sirve three.js o Canvas, SVG y CSS. No hace falta generar imágenes.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/xikhar/papercraft/tree/HEAD/skills/papercraft

Installed? Explore more Programación y desarrollo skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Preguntar en tu IA favorita

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

Documentación

¿Qué hace Papercraft?

Un estilo, cualquier tema: un diorama pop-up visto desde adentro. Tarjetas ilustradas, impresas con tinta en cartulina fibrosa y recortadas, se levantan del suelo impreso sobre bisagras; se elevan con un sobreimpulso elástico y se asientan, proyectan sombras cálidas y suaves sobre el suelo y entre sí, y se ven a través de un lente macro largo que mira hacia abajo dentro del mundo, con una banda de enfoque tilt-shift superficial, como si se fotografiara un modelo de papel real. Todo lo que viene aquí proviene de un juego de navegador enviado en este estilo y se pagó en rondas de crítica y comentarios de usuarios; los números son puntos de partida que se mantuvieron, no decoración. El brief siempre gana sobre estos valores predeterminados.

Esta habilidad enseña un método: qué hace que el estilo se lea, cómo construir e imprimir cualquier pieza, cómo iluminar, encuadrar, mover y verificar. Escribes las piezas de tu tema tú mismo. El código en assets/ es la fontanería que puedes importar (papel, tarjetas, la impresión en capas, bisagras, luz, lente, el campo de caminata) más ejemplos trabajados de un mundo campestre para leer, nunca un catálogo de partes para ensamblar un nuevo tema.

1. El modelo material (qué lo hace leer como papel)

Logra estos en cada ejecución; cada línea dice por qué. Los detalles y más números están en references/look.md.

  1. Todo es una hoja plana con grosor. La forma proviene solo de cortar, doblar, superponer y ranurar, nunca de volumen esculpido. Grosor de la tarjeta 1.5-3 % de la altura del héroe. Un plano de grosor cero se lee como una pegatina, uno grueso como cartón pluma.
  2. Mate muerto. Solo luz difusa, terminador suave (wrap ~0.3), sin especular, sin reflejos, sin brillo. Píxeles recortados por debajo de ~1 % (solo los paneles pequeños iluminados pueden recortarse). Cualquier brillo en ángulos rasantes se lee como plástico o mojado.
  3. Una clave baja cálida, sombras suaves coloreadas. Clave desde un lado, 45-65 grados fuera del eje de la cámara, 45-55 grados hacia arriba (20-35 solo en hora dorada y al anochecer) y un poco hacia la cámara, para que las sombras caigan de lado y detrás, donde la cámara las ve (una clave detrás de la cámara oculta cada sombra). Un relleno frontal a ~1/4-1/3 de la clave evita que las tarjetas frente a la cámara se vuelvan grises. Las sombras son nítidas donde una tarjeta toca el suelo y se ensanchan con la separación (penumbra ~0.2-0.3 x separación). Su tono proviene del mundo: un ámbar cálido en suelo cálido de día, lila-azul en nieve, un verde azulado profundo bajo el agua, azul marino de noche; las piezas mismas se mantienen cálidas en cada una. Nunca sombras grises o negras, nunca una niebla o filtro coloreado sobre el encuadre. Cada pieza erguida toca visiblemente el suelo (oscurecimiento de contacto); verifica las sombras solo con la clave (look.md sección 8b).
  4. Cada impresión es un pequeño collage de papel en capas. Dentro de cada silueta robusta: 3-5 tintas en 3+ pasos de valor más un adorno, colocados como capas cortadas de atrás hacia adelante sobre una hoja base con una fibra tranquila (nunca fieltro de felpa o una trama): estructura primero (miembros, niveles, hileras de tejas, marcos, paneles, una banda), luego motivos audaces que CONTRASTAN con la base (hojas y pétalos, remaches y líneas de paneles, escamas, festones, rayas, ventanas). Cada capa deja caer una sombra cálida corta y suave sobre lo que está debajo y muestra un labio pálido delgado en sus bordes iluminados; las capas grandes también un borde cortado pálido uniforme. Ese par es lo que se lee como papel en capas en lugar de un relleno vectorial. Nada desnudo, delgado o puntiagudo: ninguna línea por debajo de ~2-3 % de la pieza, motivos grandes y contables (las copas de los árboles del ejemplo campestre llevan 15-25 hojas, cada una ~1/7 del ancho de la copa). La ilustración impresa fue el mayor salto de calidad en el proyecto fuente (6 de 6 victorias ciegas sobre tarjetas lisas). Kit: P.layer, P.parts, drawnPiece, P.marks, P.rim.
  5. El borde cortado. Una línea delgada de color marrón oscuro justo en la silueta (el grosor de la tarjeta y el contorno impreso, ~1.5-2.5 px en pantalla), y un reflejo pálido justo dentro de ella solo en los bordes que miran hacia la luz. Nunca una banda pálida o blanca uniforme alrededor (un halo de pegatina), nunca brillante, nunca rasgado. Un pliegue no es un corte: las bases de bisagra y las uniones de paneles no tienen borde. Ninguna tarjeta se ve de canto como una astilla fina como un cuchillo.
  6. Un lente macro que mira hacia abajo dentro del mundo. Lente largo (FOV vertical de 24-32 grados), cámara 40-55 grados hacia abajo, y el suelo impreso se extiende más allá de cada borde del encuadre: sin horizonte, cielo, fondo, borde de libro o mesa a la vista (a menos que el brief sea literalmente un libro o una página dentro de una interfaz de usuario). Una banda nítida que cubre ~36-45 % de la altura del encuadre en la escena del héroe (medido: measure.py focusHeight >= 0.35), desenfoque que crece arriba y abajo hasta un radio de 12-18 px a 1080p (plantilla 3D 18; plantilla 2D 9 como sigma blur() de Canvas), impulsado tanto por la profundidad como por la altura de la pantalla. Grandes piezas desenfocadas que se superponen al borde inferior venden la escala en miniatura.
  7. La paleta del propio brief, construida a la manera del papel. Deriva los colores de tu tema, estado de ánimo y hora del día (palettes.md sección 3): nunca los hexágonos de la escena de ejemplo o de una paleta inicial tal como están (las pruebas ciegas copiaron los techos y verdes del ejemplo en una estación espacial). Lo que se mantiene: una familia principal que llevan las piezas, sobre un suelo pálido y apagado (~0.16-0.22 más brillante y ~0.16-0.25 menos saturado que las tarjetas), para que las piezas lleven el color; cada pieza tiene uno o dos acentos que contrastan con su base (remaches crema en un domo oxidado, hojas rojas en un árbol naranja), nunca tono sobre tono. Salvia en lugar de verde de videojuego, crema en lugar de blanco, tinta cálida en lugar de negro. Saturación media del encuadre (HSV S) ~0.55-0.75. La gradación calienta los colores escritos (un suelo caqui oliva se convierte en mostaza, un verde azulado grisáceo en salvia): el autor fundamenta y el agua un paso más azul y gris y verifica el encuadre (measure.py --palette).
  8. Denso, robusto, legible. Un mundo modelo completo, no utilería sobre un llano: 100-250 piezas de ~20 tipos (tarjetas erguidas cuya base está en el encuadre) en grupos apretados de 4-8 piezas DIFERENTES (el ejemplo campestre: un árbol, tarjetas de arbustos, una roca, flores, un animal; un arrecife: una cabeza de coral, esponjas, algas, un pez; una estación: cajas, un tramo de tuberías, una lámpara, un robot), como máximo ~3 accesorios idénticos a la vista, la banda nítida empaquetada (measure.py barePct <= ~55) y el suelo abierto principalmente fuera de ella (caminos, agua, algunos claros). El suelo permanece plano: la altura proviene de tarjetas paralelas anidadas (3-5 velas curvas escalonadas ~10-15 % en valor: colinas, dunas, bancos, ventisqueros) y afloramientos, nunca un bloque elevado de terreno (mechanisms.md sección 8). El héroe es la figura de escala (3.6 unidades en 3D, ~3.2 en 2D; un brief solo de lugar mantiene algunas figuras), 6-10 % de la altura del encuadre: un pequeño MODELO de papel 3D (~10-20 tarjetas) que se lee desde todos los lados y se gira para mirar hacia donde camina (una tarjeta frontal con una tarjeta de perfil detrás para cada parte; piernas y brazos sobre pivotes que oscilan con la distancia caminada; una inclinación hacia adelante y un balanceo en las curvas), nunca una tarjeta plana única, con una cara legible, detalle de disfraz, proporciones robustas de juguete y colores que contrastan con el suelo, de pie en la banda nítida (mechanisms.md sección 12, motion.md sección 8; el heroDoll de la escena de ejemplo es un modelo). Las piezas son robustas en comparación con él (tamaños y diseño: worlds.md secciones 8-9); un héroe que es en sí mismo un punto de referencia puede ocupar 25-35 % del encuadre; los puntos de referencia altos son planos en capas cortados por el borde superior.
  9. Lo que se camina, debajo o dentro se CONSTRUYE en 3D, nunca un plano erguido. Una tarjeta erguida es solo para cosas que se ven de frente y se rodean (árboles, arbustos, accesorios, bichos, colinas de fondo lejanas). La altura transitable es una construcción ABIERTA: un puente son rampas de cubierta con un panel de corona (tablones a través) entre lados de parapeto inclinados hacia afuera con un arco cortado; un embarcadero, muelle o mirador es una cubierta de tablones sobre postes (platform() con una cara de postes, los huecos cortados hasta la base); las escaleras son escalones delgados de tablón sobre dos largueros escalonados (contrahuella <= ~1/8 de la altura del héroe); una pasarela es una cubierta de tablones entre dos tarjetas laterales. Una caja sólida con una cara impresa (terrace()) solo para mampostería construida que el brief nombre (un muro de muelle, un escenario), nunca para terreno natural. Cualquier cosa en la que se entre es un pliegue de caja con una abertura; el agua, los caminos y los campos se imprimen en la página. La lógica de caminata lee la misma construcción: pies en la cubierta; los parapetos, muros y agua detienen al héroe (WalkField, mechanisms.md sección 14).
  10. El papel se mueve rotando sobre pliegues. Se eleva rápido con 8-15 % de sobreimpulso y un temblor de 2-3 ciclos, quieto para ~1 s; cae más suavemente con un pequeño golpe en el suelo; escalona las partes 0.05-0.1 s; nada escala, estira o se desvanece. El movimiento continuo (balanceo inactivo, cabeceo al caminar) permanece sutil: los usuarios redujeron el cabeceo solicitado por la crítica en 2-3 veces.
  11. Sonido, si lo hay, es suave, bajo, sordo y escaso. Solapas basadas en ruido, una por gesto, al menos ~0.5 s de diferencia.

2. Antes del código: escribe la especificación del papel

Escribe este bloque en tu plan (o un comentario en la parte superior del archivo principal) y llena cada línea con números. Luego audítalo: "¿Escribiría esta especificación exacta para cualquier indicación similar?" Si es así, empuja la paleta, los motivos impresos y las siluetas hacia el propio mundo del tema (un domo de Marte obtiene tarjetas de óxido y óxido con remaches impresos y líneas de paneles; un arrecife obtiene tarjetas de coral, algas y agua verde azulada con bordes festoneados; nunca los valores predeterminados campestres de las plantillas). Lo que cambia con el tema: siluetas y motivos impresos, paleta y luz de ambiente, qué mecanismos construyen las formas, sobre qué camina el héroe, el diseño y los sonidos propios del mundo debajo de las solapas de papel. Lo que nunca cambia: leyes 1-11.

SUJETO     el mundo y su giro (qué tiene solo este proyecto), y qué mira primero el lector
PAPEL      papel por capa (cartulina / kraft / acuarela / construcción / tissue / corrugado), cantidad de fibra
PALETA     4-7 hex DERIVADOS de este brief (palettes.md sección 3), con roles: suelo claro/oscuro, familia principal,
           2 acentos contrastantes, tinta, tinte de sombra, neblina; ninguno copiado del ejemplo
LUZ        color de clave + dirección (acimut / elevación grados), relación de relleno frontal, tinte de sombra, noche / luces prácticas
LENTE      fov, inclinación (40-55), banda nítida % del encuadre, desenfoque máximo px@1080, qué se superpone al borde inferior
SUELO      de qué está hecho el piso de este mundo y sus propias características (placas de cubierta, ondas de arena, ventisqueros, musgo,
           azulejos); agua solo si el brief la tiene
DISEÑO     la propia línea principal del tema (un carril, un corredor, una corriente, una pista de esquí, un canal), puntos de referencia, posición del héroe,
           grupos y claros, tipos de piezas (15-25)
MOVIMIENTO mecanismos utilizados, sincronización de subida / bajada, escalonamiento, amplitud de balanceo inactivo, comportamiento de la cámara
SONIDO     ninguno | solapas + pasos (+ música); niveles
PROHIBIDO  las señales (`look.md` sección 12) + cualquier cosa en lo que esta pieza no debe convertirse
QC         los fotogramas / tamaños que capturarás y qué debe mostrar cada uno

3. Elige la ruta de construcción

Lee solo lo que la tarea necesita, cuando lo necesita (todos los archivos en references/). Lo mínimo antes del primer fotograma:

  • Escena o juego 3D: comienza desde assets/templates/popup-3d/ (harness.js tal cual + tu propio scene.js); lee three-js.md secciones 1, 3, 5, 8, procedural-art.md 0, 3, 4, mechanisms.md 5, 7, 8, 12, 14, look.md 5, 8b, 11 y palettes.md 3.
  • Escena 2D, ilustración, side-scroller: comienza desde assets/templates/popup-2d/ (harness-2d.js tal cual + tu propio scene.js); la misma lectura con web-2d.md secciones 2-3 en lugar de three-js.md.
  • Página web o interfaz de usuario de aplicación, HUD, menús: paper-ui.md, web-2d.md secciones 4-5 (CSS y SVG), palettes.md 3.
  • Video: motion.md sección 11, luego la ruta 2D o 3D y su captura step().
  • Un motor que no sea de navegador (Godot, Unity, Unreal, Blender): engines.md (notas de portabilidad, no probado) y scripts/paper_textures.py para archivos de textura.

Luego, a medida que surjan preguntas:

PreguntaLeeKit
Tus piezas: accesorios, personajes, edificios, criaturas, máquinas, plantasprocedural-art.mdprintCard + P.layer / P.parts o drawnPiece
Tus construcciones: cruces, pliegues de caja, plataformas, planos en capas, puentes, muelles, escalerasmechanisms.md (14: suelo construido)hinge, crossCard, layeredCard, boxFold, platform, WalkField
Sincronización, resortes, títeres, cámaramotion.mdFlapSpring, windSway, FixedClock (lib/paper-motion.js)
Mundos infinitos, una cámara que sigue al héroe, composiciónworlds.mdel relleno en el ejemplo scene.js
Color; sonido y músicapalettes.md; sound.mdassets/palettes.json; lib/paper-sound.js
Planificación, medición, crítica, finalizaciónprocess.mdscripts/measure.py, scripts/ab_sheet.py

Escribe tus propias piezas. assets/lib/ es la fontanería que cada proyecto en el estilo puede importar (para copiarla en tu propia carpeta: three-js.md sección 1, web-2d.md sección 3). Cada COSA en tu mundo (árboles o coral, casas o domos, puentes o grúas, criaturas, el héroe) la diseñas para tu tema con las recetas en las referencias. assets/examples/ y las escenas de las plantillas son un mundo campestre construido de esa manera: léelos para ver cómo una receta se convierte en código, nunca ensambles una base de Marte o un arrecife a partir de esas partes en una nueva paleta; reemplaza la escena, mantén el arnés. Una construcción de examples/built-ground.js (bridge, stairs, ramp; terrace solo para mampostería construida) puede importarse cuando encaje, con tus impresiones a través de paints; la mayoría de los briefs necesitan las suyas propias (un muelle sobre pilotes, un puente de cuerda combado, una grúa), construidas de la misma manera en platform, boxFold, makeCard y hinge.

4. Flujo de trabajo

  1. Especificación y objetivo. Completa la especificación del papel. Si tienes una imagen objetivo (proporcionada por el usuario o generada), mídela con scripts/measure.py; de lo contrario, los números de la especificación son el objetivo.
  2. Prueba el material en una tarjeta de prueba antes de construir contenido: una tarjeta impresa de pie sobre un suelo impreso, bajo la luz y el lente finales (3D: ?test, una vez que tu escena se bifurca en H.flags.TEST: three-js.md sección 1). Verifica: mate, sombra de contacto cálida, el borde cortado (línea oscura + reflejo del lado iluminado), fibra

… [truncado para traducción]

Skills relacionados