arena/todo.md

1. 투사체 피격 판정이 너무 좋지않음

• 원인 분석:
  • src/game/combat.js의 PROJECTILE_HIT_RADIUS가 8픽셀로 설정되어 있어 투사체의 물리적 크기에 비해 판정 범위가 좁습니다.
  • 투사체가 생성될 때 공격자와 대상 사이의 거리가 매우 가까우면 투사체가 대상을 지나쳐버리는 현상이 발생할 수 있습니다.
  • 현재 projectilePathHitsDefender 함수에서 투사체의 궤적(Line)과 대상의 히트박스(Rectangle) 충돌을 검사하고 있지만, 대상의 실제 충돌 영역(defender.body)의 위치와 크기가 애니메이션 프레임에 따라 미세하게 변하면서 판정이 어긋날 수 있습니다.

2. 내가 이야기한 참가자 닉네임을 입력하고 팀당인원을 입력하면 참가자 닉네임 별 캐릭터가 스폰돼야해 (완료)

• 조치 사항:
  • src/game/matchSetup.js를 수정하여 입력된 각 닉네임을 독립된 팀으로 설정.
  • 설정된 teamSize만큼 각 닉네임의 캐릭터가 소환되도록 로직 변경.

3. 승리판정이 이상함 (완료)

• 조치 사항:
  • src/game/ArenaScene.js의 finishMatch 로직을 개선하여 생존 팀이 1개일 때 해당 닉네임 승리 표시.
  • 생존자가 없을 경우 "무승부!"가 표시되도록 예외 처리 추가.

4. MongoDB 기반 유니크 방문자 체크 API 추가 (완료)

• 조치 사항:
  • Fastify 서버를 추가하고 config.json 기반 서버/MongoDB 설정을 도입.
  • MongoDB 커넥션 풀을 재사용하는 server/db.js 구성.
  • POST /api/visitors/check, GET /api/visitors/stats, GET /api/health API 추가.
  • 프론트엔드 로드 시 방문자 체크 API를 호출하고 유니크 방문자 수를 표시.

5. 처치 보상 및 공격력 튜닝 상수화 (완료)

• 조치 사항:
  • 적 처치 시 현재 체력 기준 30% 회복, 누적 성장 배율에 따른 크기/공격속도/이동속도 증가를 적용.
  • 기존 combat.js에 하드코딩되어 있던 14~24 피해량을 ATTACK_DAMAGE_MIN, ATTACK_DAMAGE_MAX 상수로 분리.
  • 주요 전투/카메라/UI 상수마다 조정 대상이 무엇인지 주석 추가.

6. 캐릭터 히트박스 기준 이름표 및 선택 관전 기능 (완료)

• 조치 사항:
  • 캐릭터 이름표를 스프라이트 중심이 아니라 실제 히트박스 하단에 고정.
  • 캐릭터 클릭 시 선택 상태를 설정하고 카메라를 해당 캐릭터 히트박스 중심에 고정.
  • 초기 선택 표시는 사각형 대신 원본 alpha 마스크 기반 실루엣으로 생성.
  • 이후 선택 전용 실루엣은 상시 팀 색상 마커로 전환되어, 생존 캐릭터마다 팀 색상을 계속 보여줌.

7. 패키지 락 파일 제외 (완료)

• 조치 사항:
  • package-lock.json을 git 추적에서 제외하고 .gitignore에 추가.

8. Slime 캐릭터 특성 추가 (완료)

• 조치 사항:
  • src/game/fighterManifest.js에 Slime 전용 stats.maxHp: 1과 traits를 추가.
  • Slime으로 배정된 기본 스폰 슬롯 1개가 실제 Slime 10마리로 확장되도록 spawnMultiplier 처리 추가.
  • Slime 사망 시 50% 확률로 최대 체력 1인 Slime 2마리를 생성하도록 분열 특성 추가.
  • 분열체는 childCanSplit: false로 다시 분열하지 않도록 제한.
  • 처치 보상은 최대 체력을 증가시키지 않으므로 Slime이 적을 처치해도 최대 체력 1이 유지됨.

9. 전투 진입 UI, 좌측 HUD badge, 좌측 하단 킬로그 개선 (완료)

• 조치 사항:
  • 최초 접속 화면에 투명 전투 프리뷰, Arena 로고, Start 버튼을 배치.
  • Start 클릭 시 우측 옵션 drawer가 열리고, 전투 시작 시 실제 경기 화면으로 전환.
  • 팀 badge를 상단 좌/우 분할에서 경기장 밖 좌측 HUD 레일로 이동.
  • badge를 팀명, 팀 색상 구분선, 생존 인원 형식으로 표기.
  • 좌측 HUD 레일 폭과 경기장 시작 위치를 분리 계산해 badge가 미니맵과 경기장 캔버스를 가리지 않도록 조정.
  • 전투 시작 후 하단 안내바는 숨기고, 좌측 하단에 처치자/피처치자 이미지와 manifest.key를 포함한 목록형 킬로그를 표시.

10. 전투 중 옵션 drawer 유지, 접기/펼치기, 재시작, 일시정지 추가 (완료)

• 조치 사항:
  • 전투 시작 후 우측 drawer를 compact 패널로 유지하고, 전투 화면 중앙 정렬을 유지.
  • 전투 설정 헤더 우측 상단에 옵션 접기/옵션 펼치기 버튼을 배치.
  • 접힌 상태에서는 같은 우측 상단 위치에 토글 버튼만 남기고 패널 내용은 숨겨 전투 화면을 가리지 않도록 조정.
  • 재시작 버튼으로 현재 입력값 기준 새 전투를 즉시 시작하도록 연결.
  • 일시정지/계속 버튼으로 Phaser 물리, 타이머, tween, 스프라이트 애니메이션을 함께 정지/재개하도록 구현.

11. 팀 badge 기반 무작위 시점 고정 (완료)

• 조치 사항:
  • 좌측 팀 badge를 클릭 가능한 버튼으로 변경.
  • 클릭한 팀의 생존 캐릭터 중 무작위 1명을 선택해 기존 캐릭터 선택 카메라 고정 로직에 연결.
  • 선택된 팀 badge에 강조 스타일을 적용하고, 전투 중 하단 안내바가 노출되지 않도록 상태 표시를 정리.

12. 처치 성장 scale 상한 및 arena 내부 보정 (완료)

• 조치 사항:
  • KILL_GROWTH_MAX_MULTIPLIER를 추가해 처치 누적 보상으로 인한 크기/공격속도/이동속도 증가에 상한을 적용.
  • 처치 성장 tween 중/완료 시 캐릭터 위치를 arena 안쪽으로 보정해 히트박스가 전장 밖으로 나가는 문제를 방지.

13. 종족별 사망 통계 저장 및 상단 안내바 추가 (완료)

• 조치 사항:
  • src/game/fighterManifest.js의 모든 캐릭터에 human, orc, skeleton, slime, wolf, bear 중 하나의 species 값을 부여.
  • 실제 전투에서 사망한 캐릭터를 skin.species 기준으로 집계하고, 프리뷰 전투는 통계에서 제외.
  • server/deathStats.js와 /api/death-stats/today API를 추가해 별도 매치별 문서 없이 오늘 일자별 집계에 사망 카운트를 누적.
  • 전투가 5초 이상 지속되면 상단 #battle-notice에 오늘 종족별 사망 집계를 2초 표시/10초 대기 주기의 재치 있는 안내 문구로 표시.
  • 상단 안내바 폭을 전투 화면 안쪽에 어울리도록 줄이고, 방문자 수는 메인 화면 대신 전투 화면 우측 하단 작은 배지로 이동.
  • config.json.sample에 사망 통계 컬렉션명과 집계 타임존 설정 예시를 추가.