# COASTLINE RUSH — 로컬 실행 소스 v1.0.0

Genex에서 GPT6.1 Sol로 제작한 PC 키보드용 3D 해안 레이싱입니다.
공개 플레이: https://genex.games/3d
제작 소개: https://aitoolslab.win/games/coastline-rush/

## 실행하기

1. ZIP을 **모두 압축 해제**합니다.
2. Python 3가 설치된 컴퓨터에서 이 README가 있는 `coastline-rush` 폴더를 터미널로 엽니다.
3. macOS/Linux: `python3 start.py` / Windows: `py start.py`
4. 브라우저에서 http://127.0.0.1:8080/ 를 엽니다. 종료는 터미널에서 Ctrl+C입니다.

Python 대신 편집기의 정적 서버를 사용해도 됩니다. 서버 루트는 `index.html`이 있는 폴더입니다.
Node.js, npm 설치·빌드, Genex 로그인, API 키는 게임 실행에 필요하지 않습니다.
Three.js와 게임 에셋을 포함하므로 외부 CDN 연결도 필요하지 않습니다.
Python은 별도 설치 프로그램이며 이 ZIP에는 포함하지 않습니다.

`index.html`을 더블 클릭해 `file://`로 열면 ES 모듈과 모델 로딩이 제한됩니다. 반드시 로컬 HTTP 서버로 여세요.
8080 포트가 사용 중이면 `python3 start.py --port 8081` 또는 `py start.py --port 8081`을 사용합니다.
다른 기기에서 접근할 수 없도록 서버는 127.0.0.1에만 연결합니다.

## 조작과 환경

WebGL2와 ES 모듈·import map을 지원하는 최신 데스크톱 브라우저, 키보드를 권장합니다.
W/↑ 가속, S/↓ 제동·후진, A·D/←·→ 조향, Space 드리프트, Shift 니트로,
R 차량 복귀, Esc 일시정지·재개, M 음소거입니다. 시작 화면에서 Enter로 시작합니다.
모바일 전용 터치 조작은 포함하지 않습니다. 소리는 사용자가 게임을 시작한 뒤 활성화됩니다.

## 포함한 자료

- `index.html`, `src/`: 게임과 Genex Studio 런타임 코드
- `assets/`: 자동차 GLB, 게임 내 효과음, 에셋 제작 보조 코드
- `vendor/`: 설치된 Genex의 Three.js 0.185.1(r185) 및 필요한 로더·디코더
- `docs/`, `bench/`, `tests/`, `NOTES.md`: 원본 제작·조향·드리프트 검증 자료
- `ORIGINAL-PROMPT.txt`: 최초 제작 프롬프트. 후속 수정 요청문은 포함하지 않습니다.
- `SOURCE-MANIFEST.json`: 파일별 SHA-256과 패키징 변경 내역
- `USAGE.md`, `licenses/`: 게임 이용 범위와 제3자 소프트웨어 고지

Git 이력, Studio 세션, 로그인 설정, 게시 도구, 참고 이미지와 에이전트 지시문은 제외했습니다.
원본 제작 문서에는 당시의 계획·과거 결과가 함께 들어 있습니다. 현재 배포 상태나 모든 기능의 검증을 뜻하지 않습니다.
`assets/src/derive-car.py`는 선택적인 에셋 재생성 도구이며 NumPy와 Pillow가 별도로 필요합니다. 게임 실행에는 필요하지 않습니다.

## 로컬 실행용 보완

원본에서 빠져 있던 vendor 의존성을 설치된 Genex 번들에서 복원했습니다.
시작 HTML에는 모바일 viewport와 모듈 초기화 오류 안내를 추가했습니다.
벤치 화면의 `/vendor/` 경로는 `../vendor/`로 바꾸어 하위 경로에서도 열리게 했습니다.
Three.js가 자동 대체하던 그림자 설정을 대체된 값으로 명시해 프레임마다 쌓이던 경고를 제거하고,
텍스처 디코더 경로를 모듈 기준으로 고정했습니다.
차량 주행·드리프트·레이스 로직과 원본 모델·효과음은 변경하지 않았습니다.

## 수정과 검증

복사본을 보관한 뒤 `src/vehicles.js`의 조향·드리프트 처리 등을 읽고 한 항목씩 수정해 보세요.
저장 후 새로고침하면 됩니다. 이미 저장된 기록을 초기화하려면 이 로컬 주소의 사이트 데이터를 지우세요.
선택적으로 Node.js가 설치되어 있다면 `node --test tests/handling.mjs`로 원본 조향 회귀 테스트를 실행할 수 있습니다.
`bench/handling.html`과 `bench/handling-recovery.html`은 조향·드리프트 입력 재현 화면입니다.
이는 스크립트로 재현하는 검증이며, 사람이 전체 경기를 완주했다는 증거는 아닙니다.

화면이 안 나오면 `file://`로 열었는지, 압축 전체를 풀었는지, 하드웨어 가속/WebGL2가 가능한지 확인하세요.
포트 충돌이면 위의 다른 포트 명령을 사용합니다. 오류가 나면 화면 안내와 브라우저 콘솔을 함께 확인하세요.

## 이용 조건

다운로드 전에 소개 페이지의 이용 안내를 읽고, 상세 조건은 `USAGE.md`를 확인하세요.
게임 패키지의 로컬 실행·학습·개인적인 수정 범위로 제공하며, 게임 전체의 MIT/상업 이용·재배포 허락은 아닙니다.
제3자 오픈소스의 고유한 권리는 각 라이선스에 따릅니다. 모델·음원을 별도 에셋 상품이나 라이브러리로 배포하지 마세요.