CommunityCodierung & Entwicklunggithub.com

Papercraft-Diorama

Spiele, Webseiten, Animationen und Videos im Browser als Aufklapp-Dioramen aus Karton bauen: Scharniere, weiche Schatten, Tilt-Shift-Makro, für jedes Thema.

Was ist Papercraft-Diorama?

Ein wiederverwendbares Papier-Look. Illustrierte Karten stehen auf Scharnieren von einem gedruckten Boden auf, überschwingen leicht und werfen warme Schatten, gerahmt wie ein fotografiertes Modell. Three.js oder Canvas, SVG und CSS. Bildgenerierung ist optional.

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

Installed? Explore more Codierung & Entwicklung skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Was macht Papercraft-Diorama?

Ein Stil, jedes Motiv: ein von innen gesehenes Pop-up-Diorama. Illustrierte Karten, mit Tinte auf faserigem Karton gedruckt und ausgeschnitten, stehen auf Scharnieren von einer bedruckten Grundfläche auf; sie schnellen mit einem federnden Überschwingen hoch, kommen zur Ruhe, werfen warme, weiche Schatten auf den Grund und aufeinander und werden durch ein langes Makroobjektiv gesehen, das in die Welt hinabschaut, mit einem flachen Tilt-Shift-Fokusband, als wäre ein echtes Papiermodell fotografiert worden. Alles hier stammt von einem ausgelieferten Browserspiel in diesem Stil und wurde durch Kritikerrunden und Nutzerfeedback bezahlt; die Zahlen sind Ausgangspunkte, die sich bewährt haben, keine Dekoration. Das Briefing gewinnt immer gegen diese Vorgaben.

Diese Fähigkeit lehrt eine Methode: Was den Stil lesbar macht, wie man jedes Stück konstruiert und druckt, wie man es beleuchtet, einrahmt, bewegt und überprüft. Ihre eigenen Motivteile schreiben Sie selbst. Der Code in assets/ ist die Infrastruktur, die Sie importieren können (Papier, Karten, den Schichtdruck, Scharniere, Licht, Objektiv, das Lauffeld), plus ausgearbeitete Beispiele aus einer ländlichen Welt zum Lesen – niemals ein Katalog von Teilen, um ein neues Motiv daraus zusammenzusetzen.

1. Das Materialmodell (was es als Papier lesbar macht)

Richten Sie diese Punkte bei jedem Durchlauf korrekt ein; jede Zeile sagt warum. Details und weitere Zahlen finden Sie in references/look.md.

  1. Alles ist eine flache Platte mit Dicke. Form entsteht nur durch Schneiden, Falten, Schichten und Stecken, niemals durch skulptierte Volumen. Kartondicke 1,5-3 % der Höhe des Helden. Eine Ebene ohne Dicke wirkt wie ein Aufkleber, eine dicke wie Schaumstoffplatte.
  2. Tot matt. Nur diffuses Licht, weicher Terminator (Wrap ~0,3), kein Glanz, keine Reflexionen, kein Gloss. Abgeschnittene Pixel unter ~1 % (nur kleine beleuchtete Flächen dürfen übersteuern). Jeglicher Glanz bei streifendem Einfallswinkel wirkt wie Plastik oder nass.
  3. Ein warmes, niedriges Grundlicht, weiche farbige Schatten. Licht von der Seite, 45-65 Grad von der Kameraachse, 45-55 Grad aufwärts (20-35 nur bei goldener Stunde und Dämmerung) und etwas zur Kamera hin, sodass Schatten seitlich und dahinter fallen, wo die Kamera sie sieht (ein Licht von hinter der Kamera versteckt jeden Schatten). Ein frontales Fülllicht mit ~1/4-1/3 des Grundlichts verhindert, dass kamerazugewandte Karten grau werden. Schatten sind scharf, wo eine Karte den Boden berührt, und werden mit dem Abstand breiter (Halbschatten ~0,2-0,3 x Abstand). Ihr Farbton stammt aus der Welt: ein warmes Bernstein auf warmem Boden bei Tag, lila-blau auf Schnee, ein tiefes Blaugrün unter Wasser, nachtblau bei Nacht; die Teile selbst bleiben in jeder Umgebung warm. Niemals graue oder schwarze Schatten, niemals ein farbiger Nebel oder Filter über dem Bild. Jedes stehende Stück berührt sichtbar den Boden (Abdunklung der Kontaktstelle); überprüfen Sie die Schatten mit dem Grundlicht allein (look.md Abschnitt 8b).
  4. Jeder Druck ist eine kleine geschichtete Papiercollage. Innerhalb jeder klobigen Silhouette: 3-5 Farben in 3+ Wertstufen plus eine Verzierung, angeordnet als geschnittene Schichten von hinten nach vorne auf einem Basisbogen mit einer ruhigen Faser (niemals Plüschfilz oder ein Gewebe): zuerst die Struktur (Glieder, Stufen, Schindelreihen, Rahmen, Paneele, ein Band), dann kräftige Motive, die mit der Basis KONTRASTIEREN (Blätter und Blütenblätter, Nieten und Paneellinien, Schuppen, Muschelfransen, Streifen, Fenster). Jede Schicht wirft einen kurzen, weichen, warmen Schatten auf das, was darunter liegt, und zeigt auf ihren beleuchteten Kanten eine dünne, helle Lippe; große Schichten zusätzlich eine gleichmäßige helle Schnittkante. Dieses Paar ist es, was als geschichtetes Papier und nicht als Vektorfüllung wirkt. Nichts Nacktes, Dünnes oder Spitzes: keine Linie unter ~2-3 % des Stücks, Motive groß und zählbar (die Baumkronen des Landschaftsbeispiels tragen 15-25 Blätter, jedes ~1/7 der Kronenbreite). Gedruckte Illustration war der größte Qualitätssprung im Quellprojekt (6 von 6 blinden Siegen gegen einfache Karten). Werkzeug: P.layer, P.parts, drawnPiece, P.marks, P.rim.
  5. Die Schnittkante. Eine dünne, dunkelbraune Linie direkt an der Silhouette (die Dicke des Kartons und die gedruckte Kontur, ~1,5-2,5 px auf dem Bildschirm), und eine helle Hervorhebung unmittelbar innerhalb nur an den Kanten, die dem Licht zugewandt sind. Niemals ein gleichmäßig helles oder weißes Band ringsherum (ein Aufkleber-Heiligenschein), niemals leuchtend, niemals ausgefranst. Eine Falte ist kein Schnitt: Scharnierbasen und Paneelverbindungen erhalten keine Kante. Keine Karte wird jemals von der Kante als messerdünner Splitter gesehen.
  6. Ein Makroobjektiv, das in die Welt hinabblickt. Langes Objektiv (24-32 Grad vertikales Sichtfeld), Kamera 40-55 Grad nach unten geneigt, und der bedruckte Boden läuft über jeden Rand des Bildes hinaus: kein Horizont, Himmel, Hintergrund, Buchkante oder Tisch in Sicht (es sei denn, das Briefing ist buchstäblich ein Buch oder eine Seite innerhalb einer Benutzeroberfläche). Ein scharfes Band, das ~36-45 % der Bildhöhe auf der Szene des Helden bedeckt (gemessen: measure.py focusHeight >= 0,35), Unschärfe wächst ober- und unterhalb auf 12-18 px Radius bei 1080p (3D-Vorlage 18; 2D-Vorlage 9 als Canvas-blur()-Sigma), gesteuert durch Tiefe sowie Bildschirmhöhe. Große unscharfe Stücke, die den unteren Rand überlappen, verkaufen den Miniaturmaßstab.
  7. Die eigene Palette des Briefings, auf Papierart aufgebaut. Leiten Sie die Farben von Ihrem Motiv, der Stimmung und der Tageszeit ab (palettes.md Abschnitt 3): niemals die Hex-Werte der Beispielszene oder einer Startpalette, wie sie sind (Blindtests kopierten die Dächer und Grüns des Beispiels in eine Raumstation). Was bleibt: eine Leitfamilie, die die Stücke tragen, auf einem hellen, gedämpften Grund (~0,16-0,22 heller und ~0,16-0,25 weniger gesättigt als die Karten), sodass die Stücke die Farbe tragen; jedes Stück hat einen oder zwei Akzente, die mit seiner Basis kontrastieren (cremefarbene Nieten auf einer rostfarbenen Kuppel, rote Blätter auf einem orangefarbenen Baum), niemals Ton-in-Ton. Salbeigrün statt Videospielgrün, Creme statt Weiß, warme Tinte statt Schwarz. Mittlere Bildsättigung (HSV S) ~0,55-0,75. Die Gradation wärmt geschriebene Farben (ein oliv-khaki Boden wird senfgelb, ein grau-blaugrün Salbei): Autor setzt Böden und Wasser einen Schritt blauer und grauer und überprüft das Bild (measure.py --palette).
  8. Dicht, klobig, lesbar. Eine vollständige Modellwelt, keine Requisiten auf einer Ebene: 100-250 Stücke von ~20 Arten (stehende Karten, deren Basis im Bild ist) in dichten Gruppen von 4-8 VERSCHIEDENEN Stücken (das Landschaftsbeispiel: ein Baum, Buschkarten, ein Felsen, Blumen, ein Tier; ein Riff: ein Korallenkopf, Schwämme, Seetang, ein Fisch; eine Station: Kisten, eine Rohrleitung, eine Lampe, ein Roboter), höchstens ~3 identische Requisiten im Blick, das scharfe Band gepackt (measure.py barePct <= ~55) und der offene Boden meist außerhalb (Wege, Wasser, ein paar Lichtungen). Der Boden bleibt flach: Höhe kommt von ineinander verschachtelten parallelen Karten (3-5 gebogene Segel, abgestuft ~10-15 % im Wert: Hügel, Dünen, Uferböschungen, Schneeverwehungen) und Felsvorsprüngen, niemals ein erhöhter Geländeblock (mechanisms.md Abschnitt 8). Der Held ist die maßstabsgetreue Figur (3,6 Einheiten in 3D, ~3,2 in 2D; ein reines Ortsbriefing behält ein paar Figuren), 6-10 % der Bildhöhe: ein kleines 3D-Papier-MODELL (~10-20 Karten), das von jeder Seite lesbar ist und sich in die Laufrichtung dreht (eine frontale Karte mit einer Profilkarte dahinter für jedes Teil; Beine und Arme auf Drehpunkten, die sich mit der zurückgelegten Strecke schwingen; eine Vorwärtsneigung und eine Drehneigung in Kurven), niemals eine flache Karte, mit einem lesbaren Gesicht, Kostümdetails, klobigen spielzeugartigen Proportionen und Farben, die mit dem Boden kontrastieren, stehend im scharfen Band (mechanisms.md Abschnitt 12, motion.md Abschnitt 8; die heroDoll der Beispielszene ist ein Modell). Stücke sind klobig im Vergleich zu ihm (Größen und Layout: worlds.md Abschnitte 8-9); ein Held, der selbst ein Wahrzeichen ist, darf 25-35 % des Bildes einnehmen; hohe Wahrzeichen sind geschichtete Flächen, die von der oberen Kante beschnitten werden.
  9. Was betreten, darunter oder hinein gegangen wird, ist in 3D GEBÄUT, niemals eine stehende Fläche. Eine stehende Karte ist nur für Dinge, die von vorne gesehen und umgangen werden (Bäume, Büsche, Requisiten, Kreaturen, entfernte Hintergrundhügel). Betretbare Höhe ist eine OFFENE Konstruktion: Eine Brücke ist eine Decksrampe mit einer Kronenplatte (Bohlen quer) zwischen nach außen geneigten Brüstungsseiten mit einem ausgeschnittenen Bogen; ein Steg, Pier oder Aussichtspunkt ist ein Plankendeck auf Pfosten (platform() mit einer Pfostenfläche, die Lücken bis zur Basis ausgeschnitten); Treppen sind dünne Plankenstufen auf zwei gestuften Wangen (Steigung <= ~1/8 der Höhe des Helden); ein Gehweg ist ein Plankendeck zwischen zwei Seitenkarten. Eine solide Box mit bedruckter Fläche (terrace()) nur für gemauertes Bauwerk, das das Briefing nennt (eine Kaianlage, eine Bühne), niemals für natürliches Gelände. Alles, was betreten wird, ist eine Boxfalte mit einer Öffnung; Wasser, Wege und Felder sind in die Seite gedruckt. Die Lauf-Logik liest dieselbe Konstruktion: Füße auf dem Deck; Brüstungen, Wände und Wasser stoppen den Helden (WalkField, mechanisms.md Abschnitt 14).
  10. Papier bewegt sich durch Drehung um Knicke. Schnell aufschnellen mit 8-15 % Überschwingen und einem 2-3-maligen Nachzittern, nach ~1 s still; weicher fallen mit einem kleinen Aufklatschen auf dem Boden; Staffelung der Teile um 0,05-0,1 s; nichts skaliert, dehnt sich oder blendet ein. Kontinuierliche Bewegung (Leerlauf-Schwanken, Lauf-Wippen) bleibt subtil: Nutzer reduzierten von Kritikern gefordertes Wippen um das 2-3-fache.
  11. Sound, falls vorhanden, ist weich, leise, dumpf und sparsam. Rauschbasierte Klappen, eine pro Geste, mindestens ~0,5 s auseinander.

2. Vor dem Code: Schreiben Sie die Papier-Spezifikation

Schreiben Sie diesen Block in Ihren Plan (oder einen Kommentar am Anfang der Hauptdatei) und füllen Sie jede Zeile mit Zahlen. Überprüfen Sie ihn dann: „Würde ich diese genaue Spezifikation für eine ähnliche Aufforderung schreiben?“ Wenn ja, verschieben Sie die Palette, gedruckten Motive und Silhouetten in die eigene Welt des Motivs (eine Mars-Kuppel bekommt rost- und oxidfarbene Karten mit gedruckten Nieten und Paneellinien; ein Riff bekommt Korallen-, Kelp- und tealfarbene Wasser-Karten mit Wellenkanten; niemals die ländlichen Voreinstellungen der Vorlagen). Was sich mit dem Motiv ändert: Silhouetten und gedruckte Motive, Palette und Stimmungslicht, welche Mechanismen die Formen bauen, worauf der Held geht, das Layout und die eigenen Geräusche der Welt unter den Papierklappen. Was sich nie ändert: Gesetze 1-11.

SUBJECT    die Welt und ihre Besonderheit (was nur dieses Projekt hat) und was der Betrachter zuerst sieht
STOCK      Papier pro Schicht (Karton / Kraftpapier / Aquarellpapier / Tonpapier / Seidenpapier / Wellpappe), Fasermenge
PALETTE    4-7 Hex-Farben ABGELEITET von diesem Briefing (palettes.md Abschnitt 3), mit Rollen: Grund hell/dunkel, Leitfamilie,
           2 kontrastierende Akzente, Tinte, Schattenton, Dunst; keine aus dem Beispiel kopiert
LICHT      Schlüssellicht Farbe + Richtung (Azimut / Elevation Grad), frontales Füllverhältnis, Schattenton, Nacht / praktische Lichter
LINSE      Sichtfeld, Neigung (40-55), scharfes Band % des Bildes, maximale Unschärfe px@1080, was den unteren Rand überlappt
BODEN      woraus der Boden dieser Welt besteht und seine eigenen Merkmale (Deckplatten, Sandripple, Schneewehen, Moos,
           Fliesen); Wasser nur, wenn das Briefing es vorsieht
LAYOUT     die eigene führende Linie des Motivs (eine Gasse, ein Korridor, eine Strömung, eine Skipiste, ein Kanal), Wahrzeichen, Position
           des Helden, Gruppen und Lichtungen, Arten von Stücken (15-25)
BEWEGUNG   verwendete Mechanismen, Timing von Aufstehen / Fallen, Staffelung, Amplitude des Leerlaufschwankens, Kameraverhalten
SOUND      keiner | Klappen + Schritte (+ Musik); Pegel
VERBOTEN   die Erkennungszeichen (`look.md` Abschnitt 12) + alles, was dieses Stück nicht werden darf
QA         die Bilder / Größen, die Sie aufnehmen werden, und was jedes zeigen muss

3. Wählen Sie den Bau-Pfad

Lesen Sie nur, was die Aufgabe benötigt, wenn sie es benötigt (alle Dateien in references/). Das Minimum vor dem ersten Bild:

  • 3D-Szene oder Spiel: Beginnen Sie mit assets/templates/popup-3d/ (harness.js wie es ist + Ihr eigenes scene.js); lesen Sie three-js.md Abschnitte 1, 3, 5, 8, procedural-art.md 0, 3, 4, mechanisms.md 5, 7, 8, 12, 14, look.md 5, 8b, 11 und palettes.md 3.
  • 2D-Szene, Illustration, Side-Scroller: Beginnen Sie mit assets/templates/popup-2d/ (harness-2d.js wie es ist + Ihr eigenes scene.js); dieselbe Lektüre mit web-2d.md Abschnitte 2-3 statt three-js.md.
  • Webseite oder App-UI, HUD, Menüs: paper-ui.md, web-2d.md Abschnitte 4-5 (CSS und SVG), palettes.md 3.
  • Video: motion.md Abschnitt 11, dann den 2D- oder 3D-Pfad und dessen step()-Erfassung.
  • Eine Nicht-Browser-Engine (Godot, Unity, Unreal, Blender): engines.md (Portierungshinweise, ungetestet) und scripts/paper_textures.py für Texturdateien.

Dann, wenn Fragen auftauchen:

FrageLesenWerkzeug
Ihre Stücke: Requisiten, Charaktere, Gebäude, Kreaturen, Maschinen, Pflanzenprocedural-art.mdprintCard + P.layer / P.parts oder drawnPiece
Ihre Konstruktionen: Kreuze, Boxfalten, Plattformen, geschichtete Flächen, Brücken, Piers, Treppenmechanisms.md (14: gebauter Boden)hinge, crossCard, layeredCard, boxFold, platform, WalkField
Timing, Federn, Puppen, Kameramotion.mdFlapSpring, windSway, FixedClock (lib/paper-motion.js)
Endlose Welten, eine Kamera, die dem Helden folgt, Kompositionworlds.mddie Füllung im Beispiel scene.js
Farbe; Sound und Musikpalettes.md; sound.mdassets/palettes.json; lib/paper-sound.js
Planung, Messung, Kritik, Fertigstellungprocess.mdscripts/measure.py, scripts/ab_sheet.py

Schreiben Sie Ihre eigenen Stücke. assets/lib/ ist die Infrastruktur, die jedes Projekt in diesem Stil importieren kann (um sie in Ihren eigenen Ordner zu kopieren: three-js.md Abschnitt 1, web-2d.md Abschnitt 3). Jedes DING in Ihrer Welt (Bäume oder Korallen, Häuser oder Kuppeln, Brücken oder Kräne, Kreaturen, der Held) entwerfen Sie für Ihr Motiv mit den Rezepten in den Referenzen. assets/examples/ und die Szenen der Vorlagen sind eine ländliche Welt, die auf diese Weise gebaut wurde: Lesen Sie sie, um zu sehen, wie ein Rezept zu Code wird; bauen Sie niemals eine Marsbasis oder ein Riff aus diesen Teilen in einer neuen Palette zusammen; ersetzen Sie die Szene, behalten Sie das Grundgerüst. Eine Konstruktion aus examples/built-ground.js (bridge, stairs, ramp; terrace nur für gemauertes Bauwerk) kann importiert werden, wenn sie passt, mit Ihren Drucken durch paints; die meisten Briefings benötigen eigene (ein Pfahlsteg, eine durchhängende Seilbrücke, ein Kran), die auf dieselbe Weise mit platform, boxFold, makeCard und hinge gebaut werden.

4. Arbeitsablauf

  1. Spezifikation und Ziel. Füllen Sie die Papier-Spezifikation aus. Wenn Sie ein einzelnes Zielbild haben (vom Benutzer bereitgestellt oder generiert), messen Sie es mit scripts/measure.py; andernfalls sind die Zahlen der Spezifikation das Ziel.
  2. Beweisen Sie das Material an einer Testkarte, bevor Sie Inhalte bauen: eine bedruckte Karte, die auf einem bedruckten Boden steht, unter dem endgültigen Licht und Objektiv (3D: ?test, sobald Ihre Szene auf H.flags.TEST verzweigt: three-js.md Abschnitt 1). Überprüfen Sie: matt, warmer Kontaktschatten, die Schnittkante (dunkle Linie + helle Hervorhebung auf der beleuchteten Seite), Faser

… [für die Übersetzung gekürzt]

Verwandte Skills