Papercraft

Construire dans le navigateur des jeux, des pages, des animations et des vidéos en dioramas de papier : charnières, ombres douces et objectif macro à bascule, pour n'importe quel sujet.

Qu'est-ce que Papercraft ?

Un langage visuel réutilisable. Des cartes illustrées se dressent d'un sol imprimé, montent avec un léger dépassement et portent des ombres chaudes, cadrées comme un modèle en papier photographié. Three.js, ou Canvas, SVG et CSS. La génération d'images reste facultative.

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

Installed? Explore more Développement et programmation skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Que fait Papercraft ?

Un style, un sujet quelconque : un diorama pop-up vu de l'intérieur. Des cartes illustrées, imprimées à l'encre sur du papier cartonné fibreux et découpées, se dressent sur des charnières à partir d'un sol imprimé ; elles se lèvent avec un dépassement élastique et se stabilisent, projettent des ombres chaudes et douces sur le sol et les unes sur les autres, et sont vues à travers un objectif macro long plongeant dans le monde, avec une bande de mise au point tilt-shift peu profonde, comme si un modèle en papier réel était photographié. Tout ici provient d'un jeu de navigateur livré dans ce style et a été payé par des tours de critiques et des retours d'utilisateurs ; les chiffres sont des points de départ qui ont tenu, pas de la décoration. Le brief l'emporte toujours sur ces valeurs par défaut.

Cette compétence enseigne une méthode : ce qui fait reconnaître le style, comment construire et imprimer n'importe quelle pièce, comment l'éclairer, la cadrer, la déplacer et la vérifier. Vous écrivez vous-même les pièces de votre sujet. Le code dans assets/ est la plomberie que vous pouvez importer (papier, cartes, l'impression en couches, les charnières, la lumière, l'objectif, le champ de marche) plus des exemples travaillés d'un monde rural à lire, jamais un catalogue de pièces pour assembler un nouveau sujet.

1. Le modèle matériel (ce qui le fait ressembler à du papier)

Obtenez ces points correctement à chaque exécution ; chaque ligne explique pourquoi. Les détails et plus de chiffres se trouvent dans references/look.md.

  1. Tout est une feuille plate avec une épaisseur. La forme ne provient que de la découpe, du pliage, de l'empilement et de l'emboîtement, jamais d'un volume sculpté. Épaisseur du carton 1,5 à 3 % de la hauteur du héros. Un plan d'épaisseur nulle se lit comme un autocollant, un plan épais comme une plaque de mousse.
  2. Mat mort. Lumière diffuse uniquement, terminaison douce (enveloppe ~0,3), pas de spéculaire, pas de reflets, pas de brillance. Les pixels écrêtés sous ~1 % (seules les petites fenêtres éclairées peuvent être écrêtées). Tout éclat à des angles rasants se lit comme du plastique ou du mouillé.
  3. Une clé chaude basse, ombres colorées douces. Clé latérale, à 45-65 degrés de l'axe de la caméra, 45-55 degrés vers le haut (20-35 seulement à l'heure dorée et au crépuscule) et légèrement vers la caméra, afin que les ombres tombent sur le côté et derrière, là où la caméra les voit (une clé derrière la caméra cache toutes les ombres). Un remplissage frontal à ~1/4-1/3 de la clé empêche les cartes faisant face à la caméra de devenir grises. Les ombres sont nettes là où une carte rencontre le sol et s'élargissent avec l'écart (pénombre ~0,2-0,3 x écart). Leur teinte provient du monde : un ambre chaud sur un sol chaud de jour, bleu lilas sur la neige, un bleu sarcelle profond sous l'eau, bleu marine la nuit ; les pièces elles-mêmes restent chaudes dans chacune. Jamais d'ombres grises ou noires, jamais de brouillard coloré ou de filtre sur le cadre. Chaque pièce debout touche visiblement le sol (assombrissement du contact) ; vérifiez les ombres avec la clé seule (look.md section 8b).
  4. Chaque impression est un petit collage de papier en couches. À l'intérieur de chaque silhouette épaisse : 3-5 encres en 3+ paliers de valeur plus un ornement, disposés en couches découpées de l'arrière vers l'avant sur une feuille de base avec une fibre discrète (jamais de feutre pelucheux ou de tissage) : d'abord la structure (membres, niveaux, rangées de bardeaux, cadres, panneaux, une bande), puis des motifs audacieux qui CONTRASTENT avec la base (feuilles et pétales, rivets et lignes de panneaux, écailles, festons, rayures, fenêtres). Chaque couche projette une ombre chaude courte et douce sur ce qui se trouve en dessous et montre une fine lèvre pâle sur ses bords éclairés ; les grandes couches ont également un bord de coupe pâle et uniforme. Cette paire est ce qui se lit comme du papier en couches au lieu d'un remplissage vectoriel. Rien de nu, fin ou pointu : pas de ligne en dessous de ~2-3 % de la pièce, motifs grands et comptables (les couronnes d'arbres de l'exemple rural portent 15-25 feuilles, chacune ~1/7 de la largeur de la couronne). L'illustration imprimée a été le plus grand bond de qualité dans le projet source (6 victoires à l'aveugle sur 6 contre des cartes unies). Kit : P.layer, P.parts, drawnPiece, P.marks, P.rim.
  5. Le bord de coupe. Une fine ligne brun foncé juste à la silhouette (l'épaisseur de la carte et le contour imprimé, ~1,5-2,5 px à l'écran), et un reflet pâle juste à l'intérieur uniquement sur les bords qui font face à la lumière. Jamais de bande pâle ou blanche uniforme tout autour (un halo d'autocollant), jamais brillant, jamais déchiré. Un pli n'est pas une coupe : les bases de charnières et les jonctions de panneaux n'ont pas de bord. Aucune carte n'est jamais vue de profil comme une fine lamelle.
  6. Un objectif macro plongeant dans le monde. Objectif long (champ vertical de 24 à 32 degrés), caméra inclinée de 40 à 55 degrés vers le bas, et le sol imprimé dépasse chaque bord du cadre : pas d'horizon, de ciel, d'arrière-plan, de bord de livre ou de table en vue (sauf si le brief est littéralement un livre ou une page dans une interface utilisateur). Une bande nette couvrant ~36-45 % de la hauteur du cadre sur la scène du héros (mesurée : measure.py focusHeight >= 0,35), flou croissant au-dessus et en dessous jusqu'à un rayon de 12-18 px en 1080p (modèle 3D 18 ; modèle 2D 9 en tant que sigma blur() du Canvas), piloté à la fois par la profondeur et la hauteur de l'écran. Les grandes pièces floues chevauchant le bord inférieur vendent l'échelle miniature.
  7. La propre palette du brief, construite à la manière du papier. Dérivez les couleurs de votre sujet, de l'ambiance et de l'heure de la journée (palettes.md section 3) : jamais les hexadécimaux de la scène d'exemple ou d'une palette de départ tels quels (des tests à l'aveugle ont copié les toits et les verts de l'exemple dans une station spatiale). Ce qui reste : une famille principale portée par les pièces, sur un sol pâle et atténué (~0.16-0.22 plus lumineux et ~0.16-0.25 moins saturé que les cartes), afin que les pièces portent la couleur ; chaque pièce a une ou deux accents qui contrastent avec sa base (rivets crème sur un dôme rouille, feuilles rouges sur un arbre orange), jamais ton sur ton. Sauge au lieu de vert de jeu vidéo, crème au lieu de blanc, encre chaude au lieu de noir. Saturation moyenne du cadre (HSV S) ~0.55-0.75. L'étalonnage réchauffe les couleurs écrites (un sol olive-kaki devient moutarde, un gris-bleu-vert sauge) : les auteurs rendent les sols et l'eau d'un ton plus bleu et plus gris et vérifient le cadre (measure.py --palette).
  8. Dense, épais, lisible. Un monde modèle complet, pas des accessoires sur une plaine : 100-250 pièces d'environ 20 sortes (cartes debout dont la base est dans le cadre) en groupes serrés de 4-8 pièces DIFFÉRENTES (l'exemple rural : un arbre, des buissons, un rocher, des fleurs, un animal ; un récif : une tête de corail, des éponges, du varech, un poisson ; une station : des caisses, une canalisation, une lampe, un robot), au maximum ~3 accessoires identiques en vue, la bande nette remplie (measure.py barePct <= ~55) et le sol ouvert principalement en dehors (chemins, eau, quelques clairières). Le sol reste plat : la hauteur provient de cartes parallèles imbriquées (3-5 voiles courbes décalées de ~10-15 % en valeur : collines, dunes, talus, congères) et d'affleurements, jamais d'un bloc de terrain surélevé (mechanisms.md section 8). Le héros est la figure d'échelle (3,6 unités en 3D, ~3,2 en 2D ; un brief de lieu uniquement garde quelques figures), 6-10 % de la hauteur du cadre : un petit MODÈLE en papier 3D (~10-20 cartes) lisible de tous les côtés et qui se tourne face à la direction où il marche (une carte frontale avec une carte de profil derrière pour chaque partie ; jambes et bras sur pivots qui oscillent avec la distance parcourue ; une inclinaison vers l'avant et un roulis dans les virages), jamais une seule carte plate, avec un visage lisible, des détails de costume, des proportions de jouet épaisses et des couleurs qui contrastent avec le sol, se tenant dans la bande nette (mechanisms.md section 12, motion.md section 8 ; le heroDoll de la scène d'exemple est un modèle). Les pièces sont épaisses par rapport à lui (tailles et disposition : worlds.md sections 8-9) ; un héros qui est lui-même un point de repère peut prendre 25-35 % du cadre ; les grands points de repère sont des aplats superposés coupés par le bord supérieur.
  9. Ce sur quoi on marche, en dessous ou à l'intérieur est CONSTRUIT en 3D, jamais un aplat debout. Une carte debout est uniquement pour les choses vues de face et contournées (arbres, buissons, accessoires, bestioles, collines d'arrière-plan lointaines). La hauteur praticable est une construction OUVERTE : un pont est des rampes de pont avec un panneau de couronnement (planches en travers) entre des côtés de parapet inclinés vers l'extérieur avec une arche découpée ; une jetée, un quai ou un belvédère est un pont de planches sur des poteaux (platform() avec une face de poteaux, les espaces découpés jusqu'à la base) ; les escaliers sont de fines marches de planches sur deux limons en escalier (hauteur de marche <= ~1/8 de la hauteur du héros) ; une passerelle est un pont de planches entre deux cartes latérales. Une boîte solide avec une face imprimée (terrace()) uniquement pour la maçonnerie construite nommée par le brief (un mur de quai, une scène), jamais pour le terrain naturel. Tout ce dans quoi on entre est un pli en boîte avec une ouverture ; l'eau, les chemins et les champs sont imprimés dans la page. La logique de marche lit la même construction : pieds sur le pont ; les parapets, les murs et l'eau arrêtent le héros (WalkField, mechanisms.md section 14).
  10. Le papier se déplace en tournant autour de plis. Monter rapidement avec 8-15 % de dépassement et un tremblement de 2-3 cycles, stable en ~1 s ; descendre plus doucement avec un petit claquement sur le sol ; décaler les parties de 0,05-0,1 s ; rien ne se met à l'échelle, ne s'étire ou ne s'estompe. Le mouvement continu (oscillation d'inactivité, oscillation de la marche) reste subtil : les utilisateurs ont réduit l'oscillation demandée par les critiques de 2 à 3 fois.
  11. Le son, s'il y en a, est doux, faible, terne et clairsemé. Des battements sonores, un par geste, espacés d'au moins ~0,5 s.

2. Avant le code : rédigez le cahier des charges du papier

Écrivez ce bloc dans votre plan (ou un commentaire en haut du fichier principal) et remplissez chaque ligne avec des chiffres. Ensuite, auditez-le : "Écrirais-je ce cahier des charges exact pour une invite similaire ?" Si oui, poussez la palette, les motifs imprimés et les silhouettes vers le propre monde du sujet (un dôme martien reçoit des cartes rouille et oxyde avec des rivets imprimés et des lignes de panneaux ; un récif reçoit des cartes corail, varech et eau bleu sarcelle avec des bords festonnés ; jamais les valeurs par défaut rurales des modèles). Ce qui change avec le sujet : les silhouettes et les motifs imprimés, la palette et la lumière d'ambiance, les mécanismes qui construisent les formes, ce sur quoi le héros marche, la disposition et les sons propres du monde sous les rabats en papier. Ce qui ne change jamais : les lois 1 à 11.

SUJET      le monde et sa particularité (ce que seul ce projet a), et ce que le lecteur regarde en premier
PAPIER     papier par couche (carton / kraft / aquarelle / construction / soie / ondulé), quantité de fibres
PALETTE    4-7 hexadécimaux DÉRIVÉS de ce brief (palettes.md section 3), avec les rôles : sol clair/foncé, famille
           principale, 2 accents contrastés, encre, teinte d'ombre, brume ; aucun copié de l'exemple
LUMIÈRE    couleur + direction de la clé (azimut / élévation en degrés), rapport de remplissage frontal, teinte d'ombre,
           nuit / lumières pratiques
OBJECTIF   fov, inclinaison (40-55), bande nette % du cadre, flou max en px@1080, ce qui chevauche le bord inférieur
SOL        de quoi est fait le sol de ce monde et ses propres caractéristiques (plaques de pont, rides de sable,
           congères de neige, mousse, carreaux) ; eau seulement si le brief en a
DISPOSITION la propre ligne directrice du sujet (une allée, un couloir, un courant, une piste de ski, un chenal),
           points de repère, position du héros, groupes et clairières, types de pièces (15-25)
MOUVEMENT  mécanismes utilisés, timing de montée/descente, décalage, amplitude d'oscillation au repos,
           comportement de la caméra
SON        aucun | rabats + pas (+ musique) ; niveaux
INTERDIT   les indices (`look.md` section 12) + tout ce que cette pièce ne doit pas devenir
AQ         les images / tailles que vous allez capturer et ce que chacune doit montrer

3. Choisissez le chemin de construction

Ne lisez que ce dont la tâche a besoin, quand elle en a besoin (tous les fichiers dans references/). Le minimum avant la première image :

  • Scène ou jeu 3D : commencez par assets/templates/popup-3d/ (harness.js tel quel + votre propre scene.js) ; lisez three-js.md sections 1, 3, 5, 8, procedural-art.md 0, 3, 4, mechanisms.md 5, 7, 8, 12, 14, look.md 5, 8b, 11 et palettes.md 3.
  • Scène 2D, illustration, side-scroller : commencez par assets/templates/popup-2d/ (harness-2d.js tel quel + votre propre scene.js) ; la même lecture avec web-2d.md sections 2-3 au lieu de three-js.md.
  • Page Web ou interface utilisateur d'application, HUD, menus : paper-ui.md, web-2d.md sections 4-5 (CSS et SVG), palettes.md 3.
  • Vidéo : motion.md section 11, puis le chemin 2D ou 3D et sa capture step().
  • Un moteur non navigateur (Godot, Unity, Unreal, Blender) : engines.md (notes de portage, non testé) et scripts/paper_textures.py pour les fichiers de texture.

Ensuite, au fur et à mesure des questions :

QuestionLireKit
Vos pièces : accessoires, personnages, bâtiments, créatures, machines, plantesprocedural-art.mdprintCard + P.layer / P.parts ou drawnPiece
Vos constructions : croix, plis en boîte, plates-formes, aplats superposés, ponts, quais, escaliersmechanisms.md (14: sol construit)hinge, crossCard, layeredCard, boxFold, platform, WalkField
Minutage, ressorts, marionnettes, caméramotion.mdFlapSpring, windSway, FixedClock (lib/paper-motion.js)
Mondes infinis, une caméra qui suit le héros, compositionworlds.mdle remplissage dans l'exemple scene.js
Couleur ; son et musiquepalettes.md; sound.mdassets/palettes.json; lib/paper-sound.js
Planification, mesure, critique, finitionprocess.mdscripts/measure.py, scripts/ab_sheet.py

Écrivez vos propres pièces. assets/lib/ est la plomberie que tout projet dans ce style peut importer (pour la copier dans votre propre dossier : three-js.md section 1, web-2d.md section 3). Chaque CHOSE dans votre monde (arbres ou corail, maisons ou dômes, ponts ou portiques, créatures, le héros) que vous concevez pour votre sujet avec les recettes dans les références. assets/examples/ et les scènes des modèles sont un monde rural construit de cette façon : lisez-les pour voir comment une recette devient du code, n'assemblez jamais une base martienne ou un récif à partir de ces pièces dans une nouvelle palette ; remplacez la scène, gardez le harnais. Une construction de examples/built-ground.js (bridge, stairs, ramp ; terrace pour la maçonnerie construite uniquement) peut être importée lorsqu'elle correspond, avec vos impressions via paints ; la plupart des briefs ont besoin des leurs (une jetée sur pilotis, un pont de corde affaissé, un portique), construites de la même manière avec platform, boxFold, makeCard et hinge.

4. Flux de travail

  1. Cahier des charges et cible. Remplissez le cahier des charges papier. Si vous avez une image cible (fournie par l'utilisateur ou générée), mesurez-la avec scripts/measure.py ; sinon, les chiffres du cahier des charges sont la cible.
  2. Prouvez le matériau sur une carte de test avant de construire le contenu : une carte imprimée debout sur un sol imprimé, sous la lumière et l'objectif finaux (3D : ?test, une fois que votre scène bifurque sur H.flags.TEST : three-js.md section 1). Vérifiez : mat, ombre de contact chaude, le bord de coupe (ligne sombre + reflet du côté éclairé), fibre

… [tronqué pour la traduction]

Skills associés