GUNWAVE

고정 대형 맵에서 총기·성장·전술 장비로 무한 wave를 돌파하는 데스크톱 브라우저용 2D 액션 로그라이크.

웹 플레이 · 제출용 게임 설명서 · AI 활용 기술 문서

English

실행 환경

• Node.js ^20.19.0 또는 >=22.12.0
• npm
• WebGL을 지원하는 데스크톱 브라우저
• 기준 해상도 1280×720, FHD 지원

Chrome을 공식 기준으로 사용함. Firefox smoke를 자동 검증함. 모바일 WebView 지원은 해커톤 이후 범위.

로컬 실행

npm ci
npm run dev

터미널에 표시된 로컬 URL을 Chrome에서 열어 실행함.

production build

npm run build
npm run preview

npm run build가 데이터·아트·타입·전송 예산을 함께 검사함. 결과는 dist/에 생성함.

조작

입력	동작
A D	좌우 이동
Space	점프, 공중 점프, 장착 시 제트팩 분사
S	앉기
W A S D + 공중 Space	방향성 공중 점프 방향 지정
마우스	조준 방향 지정, 부채꼴 안의 보이는 최근접 적 자동 조준
LMB	선택 무기 주 공격
RMB	선택 무기 특수 공격
1 2 마우스 휠	무기 슬롯 선택
Q E	전술 장비 선택
G	전술 장비 사용
R	회복 아이템 사용
F 길게	상점·wave 단말기 상호작용
Tab	캐릭터 정보
Esc	일시정지·뒤로

모든 총기는 재장전하지 않음. 새 런은 권총 1개와 빈 두 번째 슬롯으로 시작함.

게임 흐름

• 준비 상태에서 중앙 기지 단말기로 wave를 수동 시작함.
• wave 제한시간 10분 안에 누적 목표 점수를 달성함.
• 목표 달성 뒤 기지 단말기로 조기 종료하거나 모든 적을 처치함.
• wave 중에도 기지 상점을 이용할 수 있으며 타이머는 계속 흐름.
• 기지 안에서는 플레이어와 적이 서로 피해를 주지 못함.
• 사망 시 부활 장치가 없으면 런을 종료함.
• 크리스탈, 플레이 통계와 설정만 브라우저 localStorage에 영구 저장함.

테스트

npm test
npx playwright install chromium firefox
npm run test:e2e
npm run test:browsers

• npm test: wave·전투·성장·저장·큰 수·pause·상점·기지 순수 규칙 검사
• npm run test:e2e: Chromium production browser smoke·핵심 흐름·회귀 18건 검사
• npm run test:browsers: 설치된 Chrome과 Playwright Firefox smoke 검사

브라우저 E2E는 오디오 0 설정으로 실행함.

문서

• 통합 SDD
• 구현 loop 계획
• 에셋 제작 원장
• 외부 라이브러리 고지
• Codex 활용 보고서
• 출시 체크리스트

배포와 제출은 사용자의 최종 플레이 승인 뒤 진행함.