포켓몬 골드 스타일로 만든 팀 소개 게임입니다. 인트로와 오박사 대화를 지나 월드맵을 탐험하고, 개발자몬을 만나 퀴즈를 풀어 포획한 뒤 도감에서 팀원 소개, 장비, 맛집 지도, 포획 영상을 확인할 수 있습니다.
| 기능 | 내용 |
|---|---|
| 인트로 | 시작 화면, 오박사 대화, 팀 소개 흐름 |
| 월드맵 | Canvas 기반 타일맵, 플레이어 이동, 충돌, 지형별 인카운터 |
| 배틀 | 개발자별 퀴즈, 몬스터볼 선택/드래그 포획, 배틀 스프라이트 렌더링 |
| 포획 영상 | 포획 장면을 캔버스 스트림으로 녹화해 도감에서 재생 |
| 도감 | 포획한 개발자 상세 정보, 프로필, 프로젝트, 장비 장착 |
| 커스텀 아이템 | 캔버스에 직접 그린 장비를 저장하고 장착 |
| 맛집 지도 | Kakao Maps SDK와 Geolocation API로 식당/현재 위치 표시 |
| 엔딩 | 4명 모두 포획하면 엔딩 영상 재생 |
| 반응형 | 모바일 화면, 터치 버튼, 드래그 가능한 컨트롤러 지원 |
| API | 사용 위치 |
|---|---|
| Geolocation API | 도감 맛집 지도에서 현재 위치 표시 |
| Drag and Drop API | 도감 장비 드래그 앤 드롭 |
| Web Storage API | 세이브 데이터, 커스텀 아이템, 볼륨/컨트롤러 위치 저장 |
| HTML Video | 엔딩 영상, 도감 포획 영상 재생 |
| HTML Audio | BGM과 효과음 재생 |
추가로 포획 영상 저장에는 MediaRecorder, canvas.captureStream(), IndexedDB를 사용합니다.
이 프로젝트는 단순히 API를 호출하는 데서 끝내지 않고, 각 기술을 실제 게임 흐름 안에 연결
-
Canvas 2D
- 월드맵, 플레이어, NPC, 배틀 화면, 포획 장면 직접 렌더링
- 타일맵 좌표, 충돌 판정, 카메라 이동, 지형별 인카운터 처리
- 현재 CSS 스타일에 맞춘 배틀 장면 재렌더링 및 포획 영상 녹화 활용
-
Geolocation API
- 도감 맛집 지도에서 현재 위치 권한 요청
- Kakao Maps 위에 현재 위치 마커 표시
- 권한 거부 또는 위치 조회 실패 시 식당 마커만 표시
-
Drag and Drop API
- 도감 장비 화면에서 개발자별 장비 장착 기능 구현
- 데스크톱 기본
dragstart,dragover,drop이벤트 활용 - 모바일 터치 조작 대응
-
Web Storage API
localStorage에 포획 상태, 장착 장비, 커스텀 아이템, 볼륨, 모바일 컨트롤러 위치 저장- 새로고침 후 게임 진행 상태와 사용자 설정 유지
-
HTML Video
- 4명 모두 포획 시 엔딩 영상 재생
- 도감에서 포획 당시 녹화 영상
<video>재생
-
HTML Audio
- BGM과 효과음 분리 재생
- 사용자 볼륨 설정 저장 및 다음 실행 시 유지
-
MediaRecorder / IndexedDB
- 포획 성공 순간의 캔버스 스트림을
MediaRecorder로 녹화 - 생성된 영상
Blob을IndexedDB에 저장 - 저장된 Blob을 URL로 변환해 도감에서 영상 재생
- 포획 성공 순간의 캔버스 스트림을
-
Kakao Maps SDK
- 개발자별 추천 식당 좌표를 지도 마커로 표시
- Geolocation API와 함께 현재 위치와 식당 위치 동시 확인
-
반응형 CSS
- 모바일 화면에서도 인트로, 대화, 배틀, 도감, 컨트롤러 사용 가능
- 화면 폭에 따른 글자 크기, 버튼 크기, 도감 레이아웃, 배틀 UI 조정
GitHub Pages 또는 VS Code Live Server 같은 정적 서버에서 실행합니다.
| 환경 | 비고 |
|---|---|
file:// |
HTML 조각을 fetch로 불러오기 때문에 비권장 |
localhost / 127.0.0.1 |
로컬 개발 권장 |
| GitHub Pages | 배포 환경 |
pixel-game/
├─ index.html
├─ README.md
├─ app/
│ ├─ app.js
│ ├─ styles.css
│ ├─ common/
│ │ ├─ audio.js
│ │ ├─ controls.js
│ │ └─ storage.js
│ ├─ intro/
│ │ └─ intro.html
│ ├─ dialogue/
│ │ ├─ dialogue.html
│ │ └─ dialogue.js
│ ├─ world/
│ │ ├─ world.html
│ │ ├─ world.js
│ │ └─ world-engine.js
│ ├─ battle/
│ │ ├─ battle.html
│ │ ├─ battle.js
│ │ ├─ battle-sprites.js
│ │ ├─ capture-video.js
│ │ └─ quiz-data.js
│ ├─ pokedex/
│ │ ├─ pokedex.html
│ │ ├─ pokedex.js
│ │ ├─ custom-items.js
│ │ ├─ dragdrop.js
│ │ ├─ restaurant-map.js
│ │ ├─ developer-data.js
│ │ ├─ item-data.js
│ │ ├─ profile-data.js
│ │ └─ restaurant-data.js
│ └─ ending/
│ ├─ ending.html
│ └─ ending.js
└─ assets/
├─ audio/
├─ battle/
├─ map/
├─ profile/
└─ story/
| 파일 | 역할 |
|---|---|
index.html |
앱 껍데기, 공통 UI, 스크립트 로드 순서 관리 |
app/app.js |
앱 상태, 화면 HTML 로딩, 상태 전환, 공통 타이핑/토스트 |
app/styles.css |
전체 UI, 배틀/도감/모바일 반응형 스타일 |
app/common/audio.js |
BGM, 효과음, 볼륨 저장 |
app/common/controls.js |
키보드, 터치 버튼, 메뉴, 컨트롤러 위치 |
app/common/storage.js |
localStorage 세이브/리셋, 커스텀 아이템 저장 |
app/world/world-engine.js |
월드맵 렌더링, 이동, 충돌, 카메라, 인카운터 |
app/world/world.js |
월드 전용 액션 |
app/battle/battle.js |
배틀 진행, 퀴즈 판정, 포획 시퀀스 |
app/battle/battle-sprites.js |
배틀 캐릭터 이미지 preload와 캔버스 렌더링 |
app/battle/capture-video.js |
포획 장면 녹화, IndexedDB 저장, Blob URL 생성 |
app/battle/quiz-data.js |
배틀 퀴즈 데이터 |
app/pokedex/pokedex.js |
도감 목록/상세/영상 표시 |
app/pokedex/custom-items.js |
직접 그린 장비 생성과 등록 |
app/pokedex/dragdrop.js |
장비 드래그 앤 드롭 장착 |
app/pokedex/restaurant-map.js |
Kakao Maps, 현재 위치, 식당 마커 |
app/pokedex/*-data.js |
개발자, 장비, 프로필, 식당 데이터 |
app/dialogue/dialogue.js |
오박사 대화 내용과 진행 |
app/ending/ending.js |
엔딩 화면, 엔딩 영상 재생 |
flowchart TD
intro["INTRO: 시작 화면"] --> dialogue["DIALOGUE: 오박사 대화"]
dialogue --> world["WORLD: 월드맵 탐험"]
world --> encounter["NPC/지형 인카운터"]
encounter --> battle["BATTLE: 퀴즈 배틀"]
battle -->|정답 + 포획 성공| capture["포획 영상 저장"]
battle -->|오답/도망| world
capture --> pokedex["도감 등록"]
pokedex --> complete{"4명 모두 포획?"}
complete -->|아니오| world
complete -->|예| ending["ENDING: 엔딩 영상"]
flowchart LR
developerData["pokedex/developer-data.js"] --> app["app/app.js"]
itemData["pokedex/item-data.js"] --> pokedex["도감 UI"]
profileData["pokedex/profile-data.js"] --> pokedex
restaurantData["pokedex/restaurant-data.js"] --> map["맛집 지도"]
quizData["battle/quiz-data.js"] --> battle["배틀"]
app --> worldEngine["world/world-engine.js"]
app --> storage["localStorage / IndexedDB"]
battle --> capture["capture-video.js"]
capture --> indexedDB["IndexedDB: 포획 영상 Blob"]
| 저장소 | 내용 |
|---|---|
localStorage.dev_pokedex_save_fs |
포획 목록, 장착 아이템, 스탯 |
localStorage.dev_pokedex_custom_items_fs |
직접 그린 커스텀 아이템 |
localStorage.pixelGameVolume |
볼륨 |
localStorage.pixelGame*PadOffset |
모바일 컨트롤러 위치 |
IndexedDB.dev_pokedex_capture_videos |
포획 영상 Blob |
| 폴더 | 내용 |
|---|---|
assets/audio/ |
BGM 파일 |
assets/battle/ |
배틀 캐릭터, 몬스터볼 시트 |
assets/map/ |
월드맵 타일, 플레이어, NPC |
assets/profile/ |
개발자 프로필 이미지 |
assets/story/ |
오박사 이미지, 엔딩 영상 |
app/는 실제 앱 화면과 로직을 도메인별로 나눈 폴더입니다.assets/는 이미지, 오디오, 영상 같은 정적 자산을 모아둔 폴더입니다.file://로 직접 열면 HTML partial 로딩이 막힐 수 있으니 정적 서버에서 실행해야 합니다.