48 lines (39 loc) · 7.5 KB

Tower Defense - 프로젝트 규칙

파일 구조

index.html - 페이지 구조 + 스타일
game.js - 게임 로직 전체 (단일 파일)
GUIDE.md - 코드 구조 & 개념 가이드 (한글)

개발 규칙

업그레이드 시 필수 작업

game.js 수정 (기능 구현)
GUIDE.md 업데이트 (변경된 시스템 설명 반영)
CLAUDE.md 하단 업그레이드 로그에 기록 추가

GUIDE.md 업데이트 원칙

새 시스템 추가 시 → 해당 섹션 새로 작성
기존 시스템 변경 시 → 해당 섹션 내용 수정
숫자(줄 번호, 수치 등)가 바뀌면 반드시 갱신
업그레이드 아이디어 체크리스트에서 완료된 항목 체크

코드 컨벤션

Vanilla JS + Canvas API only (프레임워크 금지)
외부 라이브러리 사용 금지
한글 UI 텍스트 유지
모바일 + 데스크톱 입력 모두 지원

기술 스택

HTML5 Canvas
Vanilla JavaScript (ES6+)
localStorage (최고 점수 저장)

업그레이드 로그

날짜	버전	내용
2026-03-02	v1.0	초기 버전 완성. 타워 4종(화살/대포/얼음/번개), 적 4종(일반/빠른/탱크/보스), 웨이브 시스템, 5단계 업그레이드, S자 경로 맵
2026-03-02	v1.0.1	버그 수정 - resize()에서 towers 변수 TDZ 에러 해결
2026-03-02	v1.1.0	화면 크기 확대 (800×680 → 1200×900), 독 타워 추가 (DOT 4초, 0.5초 간격 틱, 스플래시 독 전파), 타워별 투사체 이펙트 차별화 (화살=직선/대포=연기+포탄/얼음=회전결정/번개=전기줄기/독=물결방울)
2026-03-02	v1.2.0	게임 속도 조절 (x1/x2/x3, Q키 또는 클릭), 적 비주얼 전면 개선 (일반=회전 돌기+톱니 입/빠른=날카로운 다이아+속도선/탱크=장갑판+모서리 뿔/보스=뿔+왕관+붉은 오라+빛나는 눈+송곳니), 보스 이벤트 강화 (5웨이브마다 빨간 경고 연출 2.5초, 보스 레벨 스케일링 HP 8→10→12배, 호위병 동반 출현, 보상 증가)
2026-03-02	v1.3.0	모바일 반응형 개선 — 내부 캔버스 해상도와 CSS 표시 크기 분리 (TILE 최소 36 보장, cssScale로 축소), isMobile 플래그 기반 조건부 UI (키보드 힌트 숨김, 터치 안내 텍스트), 모바일 CSS 미디어 쿼리 (h1 축소, #info 숨김, iOS Safari 바운스 방지)
2026-03-02	v2.0.0	비주얼+사운드 전면 업그레이드 — SoundManager(Web Audio API 프로시저럴 8bit 사운드 15종, OscillatorNode/GainNode/WhiteNoise), 앰비언트 시스템(잔디 블레이드 바람 흔들림, 경로 조약돌/균열, 먼지/반딧불이 파티클), 스크린쉐이크(보스사망/대포스플래시/라이프감소), 충격파 링(적 사망 시 확장 링), 투사체 글로우(shadowBlur), 타워 머즐 플래시, 지면 충돌 마크, 타워/적 그림자, UI 그라디언트 패널, 버튼 호버 글로우, 골드/라이프 변경 플래시, 웨이브 전환 슬라이드 오버레이, 게임오버 연출(어두워지기→스케일인→카운트업→최고점수→재시작), 볼륨 토글(🔊/🔇 버튼, M키)
2026-03-06	v2.1.1	UI 개선 — 상단 바 버튼 고정 너비(속도/볼륨/언어 크기 불변), [Q] 힌트 버튼 아래 분리, 스탯 뱃지 겹침 해결(3버튼 총 너비 예약), 시작 프롬프트 중앙 정렬(measureText 동적 박스), 게임오버 재시작 둥근 사각형 버튼(파란 테두리, 영역 클릭만 감지, 광고 제거), restartBtn 로컬라이제이션
2026-03-06	v2.1.0	게임플레이+모바일 업그레이드 — 난이도 상향(HP=30+w×18+w^1.7×6, 속도/수량 강화, 빠른적 웨이브2부터+방어력, 탱크 웨이브4부터), 화살탑 치명타(20%확률×2.5배, 금색 파티클+글로우+사운드), 번개탑 연쇄공격(3바운스, 70%감쇄, 지그재그 번개 시각효과), 보스 특수능력 3종(방어막=파란 육각형 배리어 maxHP×15%+실드바/소환=2~4마리 소형적/가속돌진=2초 속도×2.5 빨간 속도선), applyDamageToEnemy 데미지 중앙화 헬퍼, 사운드 5종 추가(arrowCrit/lightningChain/bossShield/bossSummon/bossSpeedBurst), 모바일 가로모드 최적화(여백축소/MIN_TILE 28/세로감지 "화면을 돌려주세요" 오버레이/orientation 리스너/CSS landscape 미디어 쿼리)
2026-04-21	v3.0.0	모바일+밸런스+픽셀 스프라이트 1차 — DPR 렌더링, MAX_TILE 96, HP 지수 w^1.95×8, 업그레이드 비용 지수화, 러시/헤비 특수 웨이브 추가 (후속 v3.1에서 UI/배경 모던으로 전환)
2026-04-21	v3.1.0	픽셀 캐릭터 + 모던 UI 하이브리드 — `image-rendering: pixelated` 전역 제거, `imageSmoothingEnabled`는 drawSprite 내부에서만 false로 토글해 UI/배경은 부드럽게 유지. HUD 복원(그라디언트 패널+네온 라인+둥근 모서리 6px), 배경 모던화(수직 그라디언트 잔디+라디얼 경로+부드러운 얼룩, 오프스크린 backgroundCache로 정적 프리렌더), 적 스프라이트 해상도 상향(Normal/Fast 16→24, Tank 20→28, Boss 28→40)+하이라이트·섀도우 픽셀·볼터치 추가, 타워 스프라이트 상향(8→16×16 base)+외곽선/하이라이트/창문/스톤 기단 디테일, 표시 크기 TILE 기반 재계산(displayScale=round(TILE×N/spriteW) 정수 배율), 적 HP 바 둥근 모서리+하이라이트, 적 그림자/타워 그림자 `ctx.filter='blur(2px)'` 적용, 레벨 별을 5각별+황금 글로우로 교체, 번개 타워 중앙 오브 맥박 글로우
2026-04-21	v3.2.0	UI 리워크 + 밸런스 2차 + 이펙트 강화 — 상단 우측 영구 웨이브 뱃지(⚔ 아이콘+보스웨이브 빨강 틴트), IN/OUT 아이콘화(▶ 초록 화살표+◎ 빨강 과녁 맥박), HUD 레이아웃 재조정(왼쪽 스탯 3개=골드/하트/별 `TILE×1.95` 고정 너비·그라디언트 뱃지·상단 광택, 오른쪽 버튼 3개=한/볼륨/속도 동일 `TILE×1.5` 너비·drawIconBtn 공통 헬퍼, 스탯↔버튼 세로 네온 divider, UI_PAD=max(10,TILE×0.22) 좌우 공통 패딩), drawRoundRect에 코너별 반경(`{tl,tr,bl,br}`) 지원, 타워 업그레이드 패널 overflow 해결(drawActionBtn 공통 헬퍼로 upgrade/sell/max 통일·라벨 최대너비 측정 후 btnMinW=max+btnPadH×2·폰트 자동 축소 루프), 타워 선택 버튼 리디자인(아이콘 30% 고정 영역·텍스트 maxWidth 폰트 축소), HTML h1 "TOWER DEFENSE" 제거+info 제거+여백 24로 축소, 시작/웨이브 프롬프트 알약형 CTA 리디자인(▶ 아이콘+메인 라벨+힌트, 시작=초록/대기=파랑 그라디언트, 외곽 글로우 맥박), Game Over 오버레이 전면 리디자인(라디얼 비네트+중앙 모달 패널·상단 빨강 액센트·광택, 점수 카드 웨이브/점수 2분할·세로 divider·색 구분, 최고점수 뱃지 신기록시 🏆 맥박, CTA 버튼 2종=부활 초록 맥박+재시작 파랑 drawCTA 헬퍼), 화살 투사체 강화(진행방향 회전+깃털 꼬리+화살대 선+하이라이트 점+외곽/내부 2겹 빛줄기+치명타 금색 확대), 대포 투사체 강화(자체 회전 포탄+금속 밴드+오렌지 하이라이트+2층 연기 꼬리+뒤쪽 불꽃 3개), 타워 레벨 티어 시각화(Lv2 파랑 다이아 1·Lv3 초록 다이아 2·Lv4 보라 다이아 3·Lv5 황금 크라운♛+맥박 글로우), 밸런스 2차 완화(HP=30+w×18+w^1.78×6.5·속도 w×0.04+floor(w/10)×0.06·카운트 floor(w/7)×3·골드 w×0.55·업그레이드비용 0.7×1.5^(lv-1)·러시/헤비 강도↓·보스HP 4.8+lv×1.4)