MengTo/kage

An interactive five-chapter night walk through a Kyoto mountain temple, rendered live in Three.js.

GitHub에서 열기 ↗ creative-codinggenerative-artinteractive-storytellingjapanese-designthreejswebgl
1,428
GitHub 스타
264
포크
HTML
언어
미표기
라이선스
2026.08.09
최근 푸시
2026.08.16
별표한 날

AI 분석

설치 난이도: 쉬움
큐레이터 노트
Kage는 단일 HTML 파일로 인터랙티브 3D 스토리텔링을 구현한 훌륭한 레퍼런스다. 제이슨이 Three.js 기반의 창작 프로젝트나 스크롤 연출, 생성 이미지 합성 기법을 참고할 때 유용하다.

강점

  • 빌드 단계 없이 단일 HTML 파일로 완성된 구조가 매우 단순하고 이식성이 높다.
  • Three.js 실시간 렌더링과 생성 이미지(WebP)를 레이어로 결합해 시각적 깊이를 구현한 점이 돋보인다.
  • reduced-motion, 모바일 반응형, 커스텀 커서 등 접근성과 사용자 경험을 세심하게 고려했다.

약점

  • README에 실제 데모 링크나 실행 화면이 명시되어 있지 않아 결과물을 바로 확인하기 어렵다.
  • Three.js r149로 고정된 벤더링 빌드를 사용해 최신 기능이나 업데이트를 활용하기 어렵다.
  • 프로젝트 구조상 콘텐츠(씬, 타이포그래피, 에셋)가 index.html에 집중되어 있어 대규모 확장에는 한계가 있다.

주의사항

  • GPT Image 2로 생성된 에셋을 사용하므로, 재배포 시 생성 이미지의 라이선스 조건을 별도로 확인해야 한다.
  • Python 서버는 로컬 개발용이며, 프로덕션 배포 시 정적 서버 설정이 필요하다.
  • 현재 보관(archived) 상태는 아니지만, 프로젝트 특성상 유지보수보다는 참고용으로 보는 것이 좋다.

시작 가이드

  • 로컬에서 `python3 -m http.server 4173 --bind 127.0.0.1`로 실행해 실제 인터랙션을 체험해 본다.
  • index.html의 씬 구성과 스크롤 연출 코드를 분석해 Three.js 활용법을 익힌다.
  • PROMPT.md의 구현 브리프를 읽고 자신만의 버전으로 리믹스해 본다.

README 한국어 번역

이 번역은 AI가 원문 README를 옮긴 것입니다. 원문이 항상 우선합니다.

Kage

교토 산속 사찰을 배경으로 한 5개 챕터로 구성된 인터랙티브 야간 산책으로, Three.js로 실시간 렌더링되고 시네마틱한 생성 이미지가 겹겹이 쌓인 작품입니다.

하는 일

  • 페이지 스크롤에 따라 라이브 WebGL 카메라가 산속 사찰을 통과하며 이동합니다.
  • 절차적(procedural) 건축물, 등불 빛, 안개, 비, 흩날리는 나뭇잎, 주홍색 달, 절제된 블룸(bloom) 파이프라인을 결합합니다.
  • 편집적인 타이포그래피, 생성된 씬 플레이트(scene plate), 알파를 보존하는 WebP 전경 요소를 3D 월드 위에 겹겹이 쌓고, 섹션별 페이드 및 블러 전환을 적용합니다.
  • 챕터 내비게이션, 반응형 모바일 레이아웃, reduced-motion 동작, 정밀 포인터 기기를 위한 커스텀 커서를 포함합니다.

제작 방식

Kage는 의도적으로 작게 유지된 정적 사이트입니다. index.html에는 문서 구조, CSS, 절차적 씬 구성, 스크롤 연출, 인터랙션 로직이 모두 담겨 있습니다. 벤더링된(vendored) Three.js r149 빌드가 패키지 매니저나 빌드 단계 없이 WebGL 렌더링을 제공합니다.

사찰, 토리이(일본 신사 입구의 전통 문), 등불, 달, 지형, 비, 나뭇잎, 안개, 후처리 효과는 모두 런타임에 구성됩니다. 최적화된 WebP 씬 플레이트와 전경 컷아웃은 일반 HTML 레이어에 배치되어, 카메라 경로와 조명을 라이브로 유지하면서 페이지에 콜라주 같은 깊이감을 부여합니다.

빌드 또는 리믹스하기

PROMPT.md에 담긴 이식 가능한 구현 브리프는 이 경험을 재구축하거나 재해석하는 데 필요한 씬 구조, 레이아웃 시스템, 모션 언어, 품질 제약 조건을 설명합니다.

로컬에서 실행하기

저장소 루트에서 다음을 실행합니다:

python3 -m http.server 4173 --bind 127.0.0.1

그런 다음 http://127.0.0.1:4173/ 에 접속합니다.

빌드 단계, 환경 변수, 분석 스크립트, 런타임 네트워크 의존성은 없습니다. Python은 로컬에서 정적 파일을 서빙하는 데만 사용되며, 동등한 정적 서버라면 무엇이든 동작합니다.

프로젝트 구조

kage/
├── index.html
├── PROMPT.md
├── README.md
├── assets/
│   └── kage-preview.webp
└── secret-pathways-assets/
    ├── fonts.css
    ├── three.min.js
    ├── generated/
    └── foreground/png/

디자인 및 출처 표기

Kage는 일본 사찰 건축과 밤의 정원에서 영감을 받은 독창적이고 독립적인 디자인 스터디입니다. 특정 사찰, 문화 기관, 관광 기관과는 제휴 관계가 아닙니다.

시네마틱한 씬 플레이트와 전경 아트워크는 이 프로젝트를 위해 GPT Image 2로 생성한 뒤, 라이브 Three.js 씬과 함께 아트 디렉션 및 합성되었습니다. 벤더링된 Three.js r149 빌드는 MIT 라이선스 고지와 저작권 표기를 유지합니다.

더 많은 프로젝트

같은 방식의 다른 단일 파일 실험들 — 빌드 단계 없이, 프레임워크 없이, 모든 것이 하나의 HTML 문서에 담겨 있습니다.

  • Complete Shelf — 7권의 인터랙티브 천으로 제본된 하드커버 책으로 구성된 독창적인 Three.js 라이브러리. · source
  • Sketchbook — 싱가포르를 담은 페이지 넘김 스케치북: 드래그로 페이지를 넘기고, 돋보기를 드래그해 살펴볼 수 있습니다. · source
  • Agent Skills — 이 페이지들을 만드는 데 사용된 재사용 가능한 스킬 라이브러리로, Kage에서 추출한 낙엽 및 포인터 트레일 기법을 포함합니다.

원본 저장소: MengTo/kage

라이선스: 미표기

게재 제외를 원하시면 삭제 요청을 보내주세요.