Community코딩 & 개발github.com

페이퍼크래프트

게임, 웹 페이지, 애니메이션, 영상을 팝업 종이 디오라마로 브라우저에서 만든다. 경첩, 따뜻한 그림자, 틸트시프트 매크로. 주제는 가리지 않는다.

페이퍼크래프트란 무엇인가요?

다시 쓰는 종이 공예 시각 체계. 인쇄된 바닥에서 카드가 경첩으로 일어나고, 살짝 넘어갔다가 자리 잡으며 부드러운 그림자를 만든다. three.js 또는 Canvas, SVG, CSS. 이미지 생성은 선택이며 인쇄용 도안이 아니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/xikhar/papercraft/tree/HEAD/skills/papercraft

Installed? Explore more 코딩 & 개발 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

페이퍼크래프트은(는) 무엇을 하나요?

하나의 스타일, 모든 주제: 내부에서 본 팝업 디오라마. 섬유질 카드지에 잉크로 인쇄되고 오려진 그림 카드들은 인쇄된 지면 위 경첩에서 일어나며, 탄력적으로 살짝 넘어서다 안정되고, 바닥과 서로에게 부드럽고 따뜻한 그림자를 드리웁니다. 긴 매크로 렌즈를 통해 이 세계를 내려다보며, 얕은 틸트-시프트 초점 영역으로, 마치 실제 종이 모형을 촬영한 것처럼 보입니다. 여기의 모든 것은 이 스타일로 출시된 브라우저 게임에서 비롯되었으며, 비평가 라운드와 사용자 피드백을 통해 비용이 지불되었습니다. 숫자는 장식이 아닌, 유효한 시작점입니다. 브리핑은 항상 이러한 기본값보다 우선합니다.

이 스킬은 방법을 가르칩니다: 스타일을 읽을 수 있게 만드는 요소, 어떤 조각이든 구성하고 인쇄하는 방법, 조명, 프레이밍, 움직임 및 확인 방법. 여러분 스스로 주제의 조각들을 작성합니다. assets/의 코드는 여러분이 가져올 수 있는 배관(종이, 카드, 계층형 인쇄, 경첩, 조명, 렌즈, 걷기 필드)과 하나의 시골 세계에서 나온 작업 예제(읽기용)이며, 새 주제를 조립하기 위한 부품 카탈로그가 아닙니다.

1. 재료 모델 (종이로 읽히게 하는 요소)

매 실행마다 이것들을 올바르게 설정하세요; 각 줄은 이유를 설명합니다. 더 많은 세부 사항과 숫자는 references/look.md에 있습니다.

  1. 모든 것은 두께가 있는 평평한 시트입니다. 형태는 오로지 자르기, 접기, 레이어 쌓기 및 홈 끼움에서만 비롯되며, 조각된 부피에서 비롯되지 않습니다. 카드 두께는 주인공 높이의 1.5-3%입니다. 두께가 0인 평면은 스티커처럼 보이고, 두꺼운 것은 폼 보드처럼 보입니다.
  2. 완전 무광택. 확산광만 사용, 부드러운 종결면(래핑 약 0.3), 반사광 없음, 반사 없음, 광택 없음. 약 1% 미만의 클리핑된 픽셀(작은 조명 창만 클리핑 가능). 얕은 각도에서의 광택은 플라스틱 또는 젖은 것으로 읽힙니다.
  3. 하나의 따뜻한 저조도, 부드러운 채색 그림자. 측면에서 키 조명, 카메라 축에서 45-65도, 위로 45-55도(황금시간대와 황혼 때만 20-35도), 카메라 쪽으로 약간 향하여 그림자가 옆과 뒤로 떨어져 카메라가 볼 수 있도록 합니다(카메라 뒤에서 키 조명을 비추면 모든 그림자가 숨겨짐). 정면 필 조명은 키의 약 1/4-1/3로 카메라를 향한 카드가 회색이 되는 것을 방지합니다. 그림자는 카드가 바닥에 닿는 곳에서 선명하며, 간격이 멀어질수록 넓어집니다(반그림자 약 0.2-0.3 x 간격). 그림자의 색조는 세계에서 비롯됩니다: 낮에는 따뜻한 바닥에 따뜻한 호박색, 눈 위는 라일락-파랑, 물 속은 진한 청록색, 밤에는 남색; 조각 자체는 모든 상황에서 따뜻함을 유지합니다. 회색이나 검은 그림자, 프레임 위의 채색된 안개나 필터는 절대 사용하지 않습니다. 모든 서 있는 조각은 바닥에 닿는 것이 명확히 보여야 합니다(접촉 어두움); 키 조명만으로 그림자를 확인하세요(look.md 섹션 8b).
  4. 모든 인쇄물은 작은 종이 콜라주입니다. 각 덩어리진 실루엣 내부: 3-5가지 잉크로 3단계 이상의 명도 차이와 하나의 장식이 있으며, 하나의 조용한 섬유(플러시 펠트나 직물이 아님)가 있는 베이스 시트 위에 뒤에서 앞으로 레이어로 배치됩니다: 구조 우선(팔다리, 층, 지붕널 열, 프레임, 패널, 띠), 그 다음 베이스와 대비되는 대담한 모티프(잎과 꽃잎, 리벳과 패널 라인, 비늘, 주름 장식, 줄무늬, 창문). 각 레이어는 그 아래에 있는 것 위에 짧고 부드러운 따뜻한 그림자를 드리우고 빛이 닿는 가장자리에 얇고 창백한 입술을 보여줍니다; 큰 레이어는 고르고 창백한 절단 가장자리도 보여줍니다. 이 쌍이 벡터 채우기 대신 레이어된 종이로 읽히게 합니다. 맨살, 얇거나 뾰족한 것은 없음: 조각 너비의 약 2-3% 미만의 선 없음, 모티프는 크고 셀 수 있어야 함(시골 예시의 나무 왕관은 15-25개의 잎을 가지며, 각각 왕관 너비의 약 1/7). 인쇄된 일러스트레이션은 소스 프로젝트에서 가장 큰 품질 향상이었습니다(일반 카드 대비 6전 6승). 키트: P.layer, P.parts, drawnPiece, P.marks, P.rim.
  5. 절단 가장자리. 실루엣 바로 안쪽에 얇고 어두운 갈색 선(카드 두께와 인쇄된 윤곽선, 화면에서 약 1.5-2.5 px), 그리고 빛을 향하는 가장자리 안쪽에만 창백한 하이라이트. 절대 고르거나 하얀 띠(스티커 후광), 빛나거나 찢어지지 않음. 접힘은 절단이 아님: 경첩 베이스와 패널 연결부는 가장자리가 없음. 어떤 카드도 가장자리가 칼처럼 얇은 조각으로 보이지 않음.
  6. 세계를 내려다보는 매크로 렌즈. 긴 렌즈(수직 시야 24-32도), 카메라는 아래로 40-55도, 인쇄된 바닥은 프레임의 모든 가장자리를 넘어갑니다: 수평선, 하늘, 배경, 책 가장자리 또는 테이블이 보이지 않음(브리핑이 문자 그대로 책이거나 UI 내의 페이지가 아닌 한). 주인공 장면의 프레임 높이의 약 36-45%를 덮는 하나의 선명한 띠(측정: measure.py focusHeight >= 0.35), 위아래로 흐려짐이 1080p에서 12-18 px 반경까지 증가(3D 템플릿 18; 2D 템플릿 9를 Canvas blur() 시그마로), 깊이 및 화면 높이에 따라 결정됨. 하단 가장자리와 겹치는 크고 흐릿한 조각은 미니어처 스케일을 판매합니다.
  7. 브리핑의 고유 팔레트, 종이 방식으로 구축. 주제, 분위기 및 시간대에서 색상을 도출하세요(palettes.md 섹션 3): 예제 장면이나 시작 팔레트의 헥스 코드를 그대로 사용하지 마십시오(블라인드 테스트에서 예제의 지붕과 초록이 우주 정거장에 복사됨). 유지되는 것: 조각들이 지니는 하나의 주요 색상군, 창백하고 음소거된 바닥(카드보다 약 0.16-0.22 밝고 약 0.16-0.25 덜 채도 높음) 위에, 그래서 조각들이 색을 운반합니다; 모든 조각은 베이스와 대비되는 하나 또는 두 개의 악센트를 가짐(녹슨 돔에 크림 리벳, 오렌지 나무에 빨간 잎), 톤-온-톤이 아님. 세이지를 비디오 게임 초록 대신, 크림을 흰색 대신, 따뜻한 잉크를 검정 대신. 프레임 평균 채도(HSV S) 약 0.55-0.75. 그레이딩은 쓰여진 색을 따뜻하게 만듦(올리브-카키 바닥은 겨자가 되고, 회색 청록 세이지): 저자는 바닥과 물을 한 단계 더 파랑과 회색으로 만들고 프레임을 확인합니다(measure.py --palette).
  8. 밀집되고, 덩어리지고, 읽기 쉬움. 평원 위의 소품이 아닌 완전한 모형 세계: 약 20종류의 100-250개 조각(베이스가 프레임 안에 있는 서 있는 카드)이 4-8개의 다른 조각으로 구성된 밀집된 그룹(시골 예시: 나무, 덤불 카드, 바위, 꽃, 동물; 암초: 산호 머리, 해면, 다시마, 물고기; 정거장: 상자, 파이프 라인, 램프, 로봇), 뷰에 최대 약 3개의 동일한 소품, 선명한 띠가 채워짐(measure.py barePct <= 약 55)이고 열린 바닥은 대부분 그 외부에 있음(길, 물, 몇 개의 공터). 바닥은 평평하게 유지: 높이는 중첩된 평행 카드(3-5개의 곡선형 돛, 명도 약 10-15%씩 단계: 언덕, 둔덕, 둑, 표류)와 노두에서 비롯되며, 절대 솟아오른 지형 블록이 아님(mechanisms.md 섹션 8). 주인공은 스케일 인물(3D에서 3.6 유닛, 2D에서 약 3.2; 장소 전용 브리핑은 몇 명의 인물을 유지), 프레임 높이의 6-10%: 모든 면에서 읽히고 걷는 방향으로 돌아서는 작은 3D 종이 모형(약 10-20장의 카드)(각 부분에 대해 앞면 카드 뒤에 프로필 카드; 다리와 팔은 걸은 거리에 따라 흔들리는 피벗; 앞으로 기울임과 회전 시 롤), 절대 하나의 평평한 카드가 아니며, 읽기 쉬운 얼굴, 의상 디테일, 덩어리진 장난감 같은 비율 및 바닥과 대비되는 색상, 선명한 띠에 서 있음(mechanisms.md 섹션 12, motion.md 섹션 8; 예제 장면의 heroDoll은 하나의 모형). 조각들은 그에 비해 덩어리짐(크기와 레이아웃: worlds.md 섹션 8-9); 그 자체로 랜드마크인 주인공은 프레임의 25-35%를 차지할 수 있음; 키가 큰 랜드마크는 상단 가장자리에 의해 잘린 레이어드 플랫입니다.
  9. 걷거나, 아래에 있거나, 안으로 들어가는 것은 3D로 구축되며, 서 있는 평면이 아닙니다. 서 있는 카드는 앞에서 보고 걸어 다닐 수 있는 것(나무, 덤불, 소품, 동물, 먼 배경 언덕)에만 사용됩니다. 걸을 수 있는 높이는 열린 구조입니다: 다리는 아치 절단이 있는 바깥쪽으로 기울어진 난간 측면 사이에 크라운 패널(가로지르는 판자)이 있는 데크 램프입니다; 부두, 선착장 또는 전망대는 기둥 위의 판자 데크입니다(platform() with posts face, gaps cut to base); 계단은 두 개의 계단식 세로보 위의 얇은 판자 디딤판(높이 <= 주인공 높이의 약 1/8); 통로는 두 개의 측면 카드 사이의 판자 데크입니다. 인쇄된 면이 있는 단단한 상자(terrace())는 브리핑이 명명한 석조 건축물(부두 벽, 무대)에만 사용되며, 자연 지형에는 절대 사용되지 않습니다. 들어가는 모든 것은 입구가 있는 상자 접힘입니다; 물, 길 및 들판은 페이지에 인쇄됩니다. 걷기 로직은 동일한 구조를 읽습니다: 발은 데크 위; 난간, 벽 및 물은 주인공을 막습니다(WalkField, mechanisms.md 섹션 14).
  10. 종이는 접힌 선을 중심으로 회전하여 움직입니다. 8-15% 오버슈트와 2-3 주기 떨림으로 빠르게 올라가고, 약 1초 후에 정지; 바닥에 한 번의 작은 두드림으로 더 부드럽게 떨어짐; 부품을 0.05-0.1초씩 지연시킴; 어떤 것도 크기 조절, 늘어나거나 사라지지 않음. 지속적인 움직임(무의식적인 흔들림, 걷기 바운스)은 미묘하게 유지: 사용자는 비평가가 요청한 바운스를 2-3배 줄였습니다.
  11. 소리는, 있다면, 부드럽고, 낮고, 둔하고 드물게. 제스처당 하나의 노이즈 기반 플랩, 최소 약 0.5초 간격.

2. 코드 작성 전: 종이 사양 작성

이 블록을 계획(또는 메인 파일 상단의 주석)에 작성하고 모든 줄을 숫자로 채우세요. 그런 다음 감사하십시오: "비슷한 프롬프트에 대해 이 정확한 사양을 작성하겠습니까?" 만약 그렇다면, 팔레트, 인쇄된 모티프 및 실루엣을 주제의 고유한 세계로 밀어넣으세요(화성 돔은 녹슨 및 산화물 카드에 인쇄된 리벳과 패널 라인을 얻음; 암초는 산호, 다시마 및 청록색 물 카드에 주름진 가장자리를 얻음; 템플릿의 시골 기본값을 절대 사용하지 않음). 주제에 따라 변경되는 것: 실루엣과 인쇄된 모티프, 팔레트와 분위기 조명, 형태를 만드는 메커니즘, 주인공이 걷는 것, 레이아웃 및 종이 플랩 아래 세계의 고유한 소리. 절대 변경되지 않는 것: 법칙 1-11.

SUBJECT    세계와 그 변형(이 프로젝트만의 고유한 점), 그리고 독자가 가장 먼저 보는 것
STOCK     레이어당 종이(카드지/크라프트/수채화지/건축용지/티슈/골판지), 섬유 양
PALETTE   이 브리핑에서 파생된 4-7개의 헥스(palettes.md 섹션 3), 역할: 바닥 밝음/어두움, 주요 색상군,
          2개의 대비되는 악센트, 잉크, 그림자 색조, 헤이즈; 예제에서 복사된 것 없음
LIGHT     키 색상 + 방향(방위각/고도 각도), 정면 필 비율, 그림자 색조, 밤/실용 조명
LENS      fov, 피치(40-55), 선명한 띠 % of frame, 최대 블러 px@1080, 하단 가장자리와 겹치는 것
GROUND    이 세계의 바닥이 무엇으로 만들어졌는지와 고유한 특징(데크 플레이트, 모래 물결, 눈 더미, 이끼,
          타일); 브리핑에 있는 경우에만 물
LAYOUT    주제의 고유한 리딩 라인(차선, 복도, 해류, 스키 코스, 수로), 랜드마크, 주인공
          위치, 그룹 및 공터, 조각 종류(15-25)
MOTION    사용된 메커니즘, 상승/하강 타이밍, 지연, 무의식적 흔들림 진폭, 카메라 동작
SOUND     없음 | 플랩 + 발소리 (+ 음악); 레벨
BANNED    텔(tell)(`look.md` 섹션 12) + 이 작품이 절대 되어서는 안 되는 것
QA        캡처할 프레임/크기와 각각이 보여줘야 하는 것

3. 빌드 경로 선택

필요할 때 작업에 필요한 것만 읽으십시오(모든 파일은 references/에 있음). 첫 번째 프레임 전 최소 사항:

  • 3D 장면 또는 게임: assets/templates/popup-3d/에서 시작(harness.js는 그대로 + 자신의 scene.js); 읽기 three-js.md 섹션 1, 3, 5, 8, procedural-art.md 0, 3, 4, mechanisms.md 5, 7, 8, 12, 14, look.md 5, 8b, 11 및 palettes.md 3.
  • 2D 장면, 일러스트레이션, 사이드 스크롤러: assets/templates/popup-2d/에서 시작(harness-2d.js는 그대로 + 자신의 scene.js); 동일한 읽기와 web-2d.md 섹션 2-3을 three-js.md 대신.
  • 웹 페이지 또는 앱 UI, HUD, 메뉴: paper-ui.md, web-2d.md 섹션 4-5(CSS 및 SVG), palettes.md 3.
  • 비디오: motion.md 섹션 11, 그 다음 2D 또는 3D 경로와 해당 step() 캡처.
  • 비브라우저 엔진(Godot, Unity, Unreal, Blender): engines.md(이식 노트, 테스트되지 않음) 및 텍스처 파일용 scripts/paper_textures.py.

그런 다음, 질문이 생기면:

질문읽기키트
당신의 조각: 소품, 캐릭터, 건물, 생물, 기계, 식물procedural-art.mdprintCard + P.layer / P.parts 또는 drawnPiece
당신의 구조: 십자형, 상자 접기, 플랫폼, 레이어드 플랫, 다리, 부두, 계단mechanisms.md (14: 빌드된 바닥)hinge, crossCard, layeredCard, boxFold, platform, WalkField
타이밍, 스프링, 인형, 카메라motion.mdFlapSpring, windSway, FixedClock (lib/paper-motion.js)
끝없는 세계, 주인공을 따라가는 카메라, 구성worlds.md예제 scene.js의 채우기
색상; 소리와 음악palettes.md; sound.mdassets/palettes.json; lib/paper-sound.js
계획, 측정, 비평, 마무리process.mdscripts/measure.py, scripts/ab_sheet.py

자신의 조각을 작성하세요. assets/lib/는 이 스타일의 모든 프로젝트가 가져올 수 있는 배관입니다(자신의 폴더에 복사하려면: three-js.md 섹션 1, web-2d.md 섹션 3). 세계의 모든 것(나무 또는 산호, 집 또는 돔, 다리 또는 갠트리, 생물, 주인공)은 참조의 레시피로 주제에 맞게 설계합니다. assets/examples/와 템플릿의 장면은 그렇게 구축된 하나의 시골 세계입니다: 레시피가 어떻게 코드가 되는지 읽되, 새로운 팔레트에서 화성 기지나 암초를 그 부품으로 조립하지 마십시오; 장면을 교체하고 하네스를 유지하십시오. examples/built-ground.js의 구조(bridge, stairs, ramp; terrace는 석조 건축물에만 해당)는 맞을 때 가져올 수 있으며, 자신의 인쇄물을 paints를 통해 사용합니다; 대부분의 브리핑은 자체적인 것이 필요합니다(말뚝 위의 부두, 처진 밧줄 다리, 갠트리), platform, boxFold, makeCard 및 hinge에서 동일한 방식으로 구축됩니다.

4. 워크플로우

  1. 사양 및 목표. 종이 사양을 작성합니다. 하나의 대상 이미지(사용자 제공 또는 생성)가 있는 경우 scripts/measure.py로 측정합니다; 그렇지 않으면 사양의 숫자가 목표입니다.
  2. 하나의 테스트 카드로 재료 증명 콘텐츠를 구축하기 전에: 최종 조명과 렌즈 아래에서 인쇄된 바닥 위에 서 있는 하나의 인쇄된 카드(3D: ?test, 장면이 H.flags.TEST에서 분기되면: three-js.md 섹션 1). 확인: 무광택, 따뜻한 접촉 그림자, 절단 가장자리(어두운 선 + 조명 측 하이라이트), 섬유

…

[번역을 위해 잘림]

관련 스킬