# 🎣 카페바라-다낚아 v2.0 — World Fishing Collection

GitHub Pages에 바로 업로드하는 **빌드 없는 정적 웹게임**입니다. 카페바라 타이쿤 v3의 캐릭터를 활용한 방치형 낚시·아케이드 직접 낚시·물고기 도감 게임입니다. 외부 서버·CDN·API 키·로그인이 필요 없습니다.

## v2 주요 개선

1. **스프라이트 원본 복구** — 원본 투명 RGBA 아트에서 물고기 전체를 다시 추출하고 512×256 캔버스에 투명 여백을 둔 WebP **48개**로 재구성했습니다. v1은 고정 격자 자르기와 투명 픽셀 RGB 오용 때문에 이웃 물고기 조각이 나타났습니다. 원본 아트를 확인할 수 있도록 `tools/source_fish_sheet.webp`도 포함했습니다.
2. **유영 방향 수정** — 물고기 원본은 왼쪽을 향합니다. 이제 왼쪽 이동 때 원본을, 오른쪽 이동 때 좌우 반전을 사용합니다.
3. **실제 낚시터 4 → 8곳** — 비와호, 타호호, 송네피오르, 리우네그루, **타우포호, 케나이강, 플로리다키스, 로크 촌**. 장소를 바꾸면 풍경·수색·어종 풀도 바뀝니다.
4. **도감 24 → 33종** — 기존 물고기와 홍연어·은연어·돌리바든·스내퍼류·타폰·스누크·파이크·퍼치. 최초 발견·기록·코인·획득 횟수를 저장합니다.
5. **직접 낚기 아케이드** — 직접 낚기를 누르면 `캐스팅 정확도 → 입질 챔질 → 줄 긴장도 조절/릴 감기`로 진행합니다. 적절한 조작에 성공해야 포획하고, 타이밍/긴장도에 실패하면 획득하지 못합니다.
6. **자동 낚시 병행** — 자동 낚시, 캐릭터 특성, 낚싯대 강화, 낚시법과 미끼를 계속 지원합니다. 아케이드 도중에는 자동 포획을 멈춰 충돌을 방지합니다. 게임을 닫았을 때 최대 4시간의 방치 결과 정산도 유지합니다.

## 조작

- **자동 낚시:** 자동 버튼 ON → 일정 시간마다 포획/도감 기록. OFF → 자동 입질을 멈춥니다.
- **직접 낚시(PC):** 직접 낚기 → 움직이는 바늘이 노란 영역에 들어왔을 때 **스페이스** → 입질 표시 때 다시 **스페이스** → 마지막에는 **스페이스를 누르면 릴을 감고, 놓으면 긴장도가 내려갑니다**. 줄이 끊어지기 전에 게이지 100%를 달성하세요.
- **직접 낚시(모바일):** 화면의 큰 버튼을 탭해 캐스팅·챔질, 마지막에는 버튼을 **길게 눌렀다 떼는 것**을 반복합니다.
- **성공:** 포획과 도감 등록 + 플레이 품질에 따른 보너스 코인. **실패:** 보상 없음. 버튼을 눌러 재도전 가능.
- **관찰:** 물속을 탭하면 잔물결이 발생합니다. 수중 물고기는 투명 WebP 스프라이트로 이동하며 방향을 맞춰 전환합니다.

## GitHub Pages 설치

1. ZIP 압축을 풀어 `index.html`, `src/`, `assets/`, `style.css`, `sw.js`, `manifest.webmanifest`, `icons/` 등을 **새 저장소 루트**에 그대로 올립니다.
2. GitHub 저장소 → **Settings → Pages → Deploy from a branch → main / (root)** 설정.
3. `https://<계정>.github.io/<저장소>/`에서 실행하세요. Node/패키지 설치나 빌드가 필요 없습니다.
4. Chrome에서 `index.html` 파일을 직접 열 수도 있습니다(단, `file://` 환경에서는 PWA 서비스워커는 작동하지 않음).

### 기존 v1 세이브 데이터

기존 `localStorage` 키 **`cafe-bara-danaka-save-v1`**과 저장 구조를 유지했습니다. **같은 주소/브라우저 출처**에서 v2로 업데이트하면 코인·도감·강화 기록을 이어받습니다. 다른 도메인이나 다른 기기로 자동 동기화되지 않습니다. 브라우저 데이터를 삭제하면 기록도 삭제됩니다.

## 주요 파일

```text
index.html                    인터페이스·직접 낚기 오버레이
style.css                     반응형 레이아웃·아케이드 게이지
src/data.js                   낚시터 8곳·어종 33종·장비·캐릭터 데이터
src/game.js                   자동 낚시·도감·수중 애니메이션·아케이드
assets/scenes/*.webp          고화질 배경 8장
assets/fish/*.webp            RGBA 투명 어류 스프라이트 48개
assets/characters/*.webp      카페바라 v3 동물 캐릭터 10개
assets/ui/cover.webp          표지
sw.js / manifest.webmanifest  PWA
SOURCES.md                    실제 서식지 확인 자료
QA.md                         테스트와 제한
build_fish_v2.py / tools/     스프라이트 추출 재현용 자료(배포 필수 아님)
```

## 이미지의 성격과 제한

- **실사풍 배경 및 물고기는 생성 이미지**이지 실제 촬영 사진이 아닙니다. 새로운 4곳의 배경 또한 지역 풍경의 인상에 바탕을 둔 합성 이미지로 실제 지형이 1:1로 재현된 것은 아닙니다.
- 일부 신규 어종 스프라이트는 유사 어종 그림을 **색조 보정한 창작 표현**입니다. 종 동정을 위한 생태 도판이 아닙니다. 학명과 대표 지역은 검증한 공개 자료 기반입니다.
- 포획 가능 시기/금어기/면허 및 보호종은 게임의 출현 확률과 별개입니다. 실제 낚시에는 현지 공식 규정을 따라야 합니다.
- PWA는 GitHub Pages에서 서비스워커 설치 후 오프라인 작동을 지원하도록 설계했으나, 실제 GitHub Pages 배포 후 네트워크 차단 테스트는 별도 확인이 필요합니다.
