# 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) 및 필요한 로더·디코더
- `bench/`, `tests/`: 조향·드리프트 입력 재현 화면과 회귀 테스트
- `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자 오픈소스의 고유한 권리는 각 라이선스에 따릅니다. 모델·음원을 별도 에셋 상품이나 라이브러리로 배포하지 마세요.