Game Design Guide

2. 4-Phase 난이도 곡선 설계

표준 모델 (H5 아케이드)

Phase별 파라미터 범위 (필수 수치)

Phase 전환 시 변화 필수 요소

1. 적 스폰 간격: 점진 감소
2. 적 속도: 점진 증가
3. 적 유형: Phase마다 최소 1종 추가
4. 환경 변화: 배경색, 장애물 배치, 물리 법칙 변화
5. 보상 멀티플라이어: Phase 올라갈수록 점수 가치 증가
6. 시각 연출: burst spawn + 카메라 쉐이크 + Phase 배너

속도 에스컬레이션 공식

speed(t) = BASE_SPEED * (1 + ESCALATION_RATE * t / 60)

• ESCALATION_RATE 0.30.5 권장 (분당 3050% 증가)
• Phase 3 속도 / Phase 1 속도 비율 >= 3.0 필수 (이하면 변화 체감 못 함)
• 최대 속도 캡: Phase 4에서도 500px/s 이하 (60fps 유지)

3. 보상 루프 설계 패턴

3층 보상 구조 (H5 필수)

콤보 시스템 설계 가이드

• 콤보 조건: 연속 1.5초 내 성공 행동 (kill, 회피, 수집)
• 콤보 보상: 점수 멀티플라이어 (x2, x3, x5)
• 콤보 리셋: 피격/실수 시 즉시 리셋 (관대한 타이밍)
• 콤보 표시: 화면 우상단, 숫자 + 색상 에스컬레이션 (흰→노랑→빨강)

위험 보상 (Risk-Reward) 설계

• 위험한 위치에서 행동 → 추가 점수 (1.5~3배)
• 근접 회피 → "Close Call" 보너스
• 연속 성공 → 멀티플라이어 누적
• 무적 방지: 어떤 전략으로도 무한 생존 불가능 설계

4. 적 아키타입 프레임워크

H5 검증 적 유형

적 조합 규칙

• Phase 1: 1종만 (직진형) — 학습 보호
• Phase 2: 2종 조합 (직진 + 추적 또는 패턴)
• Phase 3: 3종 동시 (판단력 시험)
• Phase 4: 전종 + Elite

특수 적 고유 행동 원칙

• 특수 적(corruption, flyer 등)은 단순 스탯 차이가 아닌 고유 행동 필수
• 예: Corruption Bloom → 꽃 3개 시들게, Flyer → 곡선 궤도, Tank → 다중 피격 필요
• 스탯만 다른 적은 "특수"가 아님 — 반드시 고유 행동 코드 구현

적 밀도 가이드

• 동시 화면 내 적: Phase 1 = 23개, Phase 4 = 812개
• 오브젝트 풀 최대: 30개 (Phaser Arcade Physics 성능 한계)
• 적 겹침 방지: 스폰 시 최소 간격 40px
• 스폰 위치: 화면 밖에서 시작, 사전 경고(그림자/빛) 0.3초

5. H5 디자인 패턴 (5대 필수 패턴)

P1. 즉시 플레이 (Instant Play)

• 로딩 → 1번 탭으로 게임 시작
• 메뉴 최소화: 타이틀 + 시작 버튼 + 최고점수 (이게 전부)
• 튜토리얼 모달 금지 — 인라인으로만

P2. 빠른 재시작 (Quick Restart)

• 게임오버 → 0.3초 이내 재시작 가능
• 재시작 버튼이 화면에서 가장 크고 밝은 요소

P3. 명확한 진행감 (Clear Progression)

• 점수 항상 표시
• 최고점수 비교 실시간
• Phase/레벨 전환 시 명확한 시각 피드백

P4. 모바일 우선 (Mobile First)

• 세로/가로 모드 선언 필수
• 마우스 단독 플레이 가능
• 터치 입력: 탭/스와이프/드래그 중 1개 주 입력
• 키보드는 보조 입력 (없어도 완전 플레이 가능)

P5. 사이즈 버짓 준수

• 총 빌드 번들 <= 2MB 목표
• 외부 웹폰트 금지, 인라인 에셋만

6. 밸런스 메트릭 검증 (config.js 기반)

검증 항목 및 판정 기준

Aura/방어력 밸런스 계산

max_aura = AURA_BASE_RADIUS + (MERGE_TIER_MAX - 1) * AURA_TIER_BONUS
screen_ratio = (max_aura * 2) / WIDTH

screen_ratio > 0.35 → FAIL: "최대 방어 범위가 화면의 {ratio*100}% — 무적 위험"
screen_ratio > 0.25 → WARN: "방어 범위 넓음, 게임플레이 테스트 권장"
screen_ratio <= 0.25 → PASS

aura/방어 반경이 메카닉에 없는 장르(플랫포머, 슈터 등)는 balance_check skip. 대신 장르 적합 지표를 자체 기술.

난이도 에스컬레이션 검증

speed_ratio = phase3_speed / phase1_speed
spawn_ratio = phase1_spawn_interval / phase3_spawn_interval

speed_ratio < 2.0 → FAIL: "속도 상승 폭 부족"
speed_ratio < 3.0 → WARN: "속도 에스컬레이션 약함"
spawn_ratio < 1.5 → WARN: "스폰 빈도 변화 미미"

_enforceMechanic 패턴 검증

GameScene.js에서 패턴 분석:
- hasInteracted = true/false boolean 패턴 → FAIL (MC-03 영구 비활성화)
- lastInteractTime 타임스탬프 패턴 → PASS
- _enforceMechanic이 lastInteractTime 기반인지 확인

무적 방지 검증

max_aura가 존재하고 최대 적 속도가 있을 때:
- aura 흡입 속도 > 적 속도 → WARN: "무적 가능성"
- 어떤 전략 조합으로도 무한 생존 가능 → FAIL

config.js 변수명 탐색 패턴

변수를 찾지 못하면 해당 체크를 SKIP으로 표시하고 "변수 미발견" 메시지 남김.

밸런스 검증 결과 출력 형식

{
  "timestamp": "ISO8601",
  "slug": "game-slug",
  "checks": {
    "aura_ratio": { "value": 0.22, "status": "PASS", "message": "방어 비율 22% — 안전" },
    "speed_escalation": { "value": 3.5, "status": "PASS", "message": "속도 에스컬레이션 x3.5" },
    "enforce_mechanic": { "status": "PASS", "pattern": "lastInteractTime" },
    "invincibility": { "status": "PASS", "message": "무적 경로 미발견" }
  },
  "overall": "PASS",
  "fail_count": 0,
  "warn_count": 0
}

7. 세션 설계 (첫 30초 해부)

이상적 H5 세션 프로파일

• 첫 세션: 30~60초 (학습 중 사망, 재시도 의욕)
• 5번째 세션: 90~120초 (성장 실감)
• 숙련 세션: 180~300초 (만족감 최대)
• 최대 세션: 5~10분 (집중 한계)

첫 30초 구간별 설계 (가장 중요)

0~3초:  훅 — 화면에 즉시 움직이는 요소, 플레이어 캐릭터 구별 가능
3~5초:  목표 인지 — 피해야 할 것/해야 할 것이 자명
5~8초:  첫 입력 — 힌트 표시 (3초 무입력 시 화살표/터치 아이콘)
8~15초: 첫 성공 — 보장된 작은 보상 (적 회피/아이템 획득)
15~25초: 첫 위기 — 긴장감, 첫 적은 5초 이내 등장, 첫 위기는 15초 이내
25~30초: Phase 전환 느낌 — "이제부터 진짜"

초반 긴장감 원칙

• Phase 1에서도 적이 위협적이어야 함 (SPAWN_INTERVAL <= 1800ms, 적이 플레이어 조준)
• 첫 적은 5초 이내 등장, 첫 위기는 15초 이내
• Phase 2는 45초 이내 진입

재시도 동기 설계

• 게임오버 화면에 "조금만 더 하면" 힌트
• 최고 점수 대비 현재 점수 비교
• "다음 Phase까지 N초 남았었음" 표시
• 재시작 버튼이 가장 크고 밝은 요소

8. 몰입(Flow) 채널 유지

Csikszentmihalyi Flow Model 적용

     어려움
      |     불안
      |   +-----+
      |   |FLOW | <- 여기를 유지
      |   |ZONE |
      |   +-----+
      |     지루함
      +------------ 스킬

난이도 자동 조절 (Dynamic Difficulty Adjustment)

• 3연속 사망 시 → 다음 스폰 5초 딜레이 (은밀한 난이도 하락)
• 120초 이상 무사망 → 스폰 간격 10% 단축 (은밀한 난이도 상승)
• 절대 플레이어에게 알리지 않음 (자존심 보호)
• config.js에 DDA_ENABLED 플래그로 토글 가능 [H]

9. 튜토리얼 설계 (인라인)

절대 규칙

• 별도 튜토리얼 화면 금지 — 게임 중 자연스럽게
• 텍스트 최소화 — 시각적 힌트 우선
• 첫 10초 무적/보호 필수

인라인 튜토리얼 패턴

1. 입력 힌트: 3초 무입력 → 화살표/터치 아이콘 표시 → 첫 입력 후 소멸
2. 안전 구역: 첫 10초 적 스폰 없음 또는 느린 속도
3. 강제 성공: 첫 적은 반드시 피할 수 있는 속도/위치
4. 점진적 복잡도: 요소를 하나씩 소개 (첫 적 → 두 번째 유형 → 아이템)

10. 게임 필(Feel) 최소 기준

Juice 필수 요소

• 스크린 쉐이크: 피격, Pulse/스킬 발동, Phase 전환에 필수 (cameras.main.shake)
• 파티클: 적 사망, 수집, 스킬 발동 시 burst 파티클
• 콤보 시스템: 연속 kill 보상 (1.5초 내 연속 → 콤보 카운터 + 보너스 점수)
• 점수 텍스트: 변경 시 scale pop (1.4x yoyo)
• Phase 전환: burst spawn + 카메라 쉐이크 + 슬로모 300ms

업그레이드 가시성 원칙

• 업그레이드 효과는 시각적으로 즉시 체감 가능 (최소 30% 수치 변화)
• 업그레이드 획득 시 최소 3가지 피드백: 시각 이펙트 + 배너 텍스트 + 카메라 플래시
• 자동 승리 방지: MAX_FLOWERS <= 30 등 상한 설정

노력-보상 원칙

• 플레이어의 모든 핵심 행동에 "판단 비용"이 있어야 함
• 자동으로 되는 것은 보상이 아님 — 이동만으로 자동 심기/자동 공격은 게임이 아닌 스크린세이버
• 수집 아이템은 overlap 감지 필수 — 떨어져서 사라지면 구현 누락

11. 난이도 모델 검증 수치

세션 중앙값 = 목표 난이도에 따른 기대 생존 시간
  쉬움: 120~180초 (캐주얼 대상)
  보통: 60~120초 (일반 대상)  <- H5 기본값
  어려움: 30~60초 (하드코어)

GDD = 가설 목록 원칙

• 각 설계 결정을 "테스트 가능한 가설"로 기록
• A/B 테스트 가능 파라미터에 [H] 마크
• 예: SPAWN_INTERVAL: 2000ms [H], COMBO_WINDOW: 1.5s [H]
• 기획은 "최종 정답"이 아니라 "검증할 가설 집합"

12. 수치 시스템 안정성 (Numeric System Design)

(근거: Tower Defense 사례 — SupportTower 버프가 매 틱 곱셈 누적, fireRate 영구 인플레이션)

Immutable Base + Modifier 패턴 (필수)

모든 수치 시스템(데미지, 속도, 스폰 간격, 방어력)은 반드시:

// ✅ 올바른 패턴
class Entity {
  constructor(baseSpeed) {
    this.baseSpeed = baseSpeed;  // config.js에서 가져온 불변값
    this.speedModifiers = [];    // { type: 'mult'|'add', value, duration, startTime }
  }
  getSpeed() {
    const mult = this.speedModifiers
      .filter(m => m.type === 'mult' && !this.isExpired(m))
      .reduce((acc, m) => acc * m.value, 1.0);
    const add = this.speedModifiers
      .filter(m => m.type === 'add' && !this.isExpired(m))
      .reduce((acc, m) => acc + m.value, 0);
    return Math.min(this.baseSpeed * mult + add, MAX_SPEED);  // 상한 캡
  }
}

금지 패턴 (Anti-Drift Rules)

// ❌ 금지: 직접 변이 (누적 인플레이션 유발)
entity.speed *= buff;
entity.damage += bonus;
tower.fireRate *= 0.9;  // 매 틱 호출되면 0에 수렴

// ❌ 금지: boolean 기반 영구 버프
if (!entity.hasBuff) { entity.speed *= 2; entity.hasBuff = true; }

버프 상한 규칙

평가 시 검증 포인트

config.js에 버프/업그레이드 시스템이 있을 때:

• base 값이 config.js const로 정의되어 있는가
• modifiers가 별도 배열/맵으로 관리되는가
• effective 값이 함수(getSpeed() 등)로 계산되는가
• 만료 시간 또는 스택 상한이 있는가
• entity.speed *= 같은 직접 변이 패턴이 없는가