기술 결정 — Angel’s Plan
결정일: 2026-11-19 · 상태: 결정 (IDEATION.md 8장의 three.js 안을 대체)
결론
Unity 6 + 2D 도트(탑다운 3/4 시점) 로 간다. 3D FPS는 채택하지 않는다.
| 레이어 | 선택 |
|---|---|
| 클라이언트 | Unity 6 LTS, URP 2D, Tilemap + Pixel Perfect Camera |
| 빌드 타깃 | ① Unity Web(WebGL2) → angelsplan.haylab.net에서 링크로 바로 접속 ② 이후 iOS·Android·PC 네이티브 |
| 게임 서버 | Colyseus (Node.js/TypeScript, 서버 권위형) + Colyseus Unity SDK |
| 비밀 정보 | Colyseus StateView: 손패·역할·비밀 목표는 본인 클라이언트에만 전송 |
| 보이스 | LiveKit. 거리 기반 볼륨 감쇠로 근접 보이스를 구현하고, 층(천상/연옥/림보)마다 구독 권한을 서버가 토큰으로 제어. 웹 빌드는 client-sdk-unity-web, 네이티브는 client-sdk-unity |
| 아트 | 32×32 도트 캐릭터(8방향 걷기, 감정 표현 4종), 16×16 타일 |
왜 2D 도트인가
- 이 게임의 핵심은 조준이 아니라 정보다. 경매, 블러핑, 사회적 추리, 보드게임이 중심이다. FPS 시점은 손 기술 게임에 맞는 형식이라, 여기서는 들이는 비용만큼 재미가 늘지 않는다.
- “누가 누구 곁에 있었나”가 한눈에 보여야 한다. 근접 밀담과 동선 증거가 이 게임의 차별점이다. 탑다운 시점에서는 방 전체의 위치 관계가 늘 보인다. FPS 시점에서는 시야 밖이 사라지기 때문에 이 메커닉이 약해진다. 이 장르(Gather·ZEP·Among Us)가 탑다운인 데도 이유가 있다.
- 근접 보이스가 단순해진다. 2D에서는 “거리 → 볼륨” 공식 하나로 충분하다. Unity Web 빌드에는 3D 공간 음향(방향감)이 2D처럼 재생되는 버그 보고가 여러 건 있는데, 2D를 택하면 이 문제를 아예 피할 수 있다.
- 카드·보드·경매 UI와 잘 맞는다. 매치 화면은 어차피 2D UI다. 월드도 2D면 월드와 매치 사이를 오갈 때 시각적으로 끊기지 않는다.
- 표정과 연기를 싸게 표현할 수 있다. 사회적 게임에서는 캐릭터의 반응이 중요하다. 3D에서는 어설픈 애니메이션이 바로 싸 보인다. 도트는 말풍선, 이모트, 2~4프레임 모션만으로도 감정이 전달된다.
- 비용과 성능. 천상·연옥·림보 세 공간의 에셋 제작 비용이 3D보다 훨씬 작고, 모바일 브라우저에서 웹 빌드가 가볍다. 90분 세션에서 멀미 문제도 없다.
- 기존 경험을 살릴 수 있다. 이미 Unity 2D 에셋 작업(UnityAsset 프로젝트) 경험이 있다.
3D FPS를 택하지 않는 이유 (그리고 3D를 쓴다면)
- 3D의 장점은 몰입감, “메타버스다운” 첫인상, 방송 화면이다.
- 하지만 FPS 시점은 위 1·2번과 정면으로 부딪친다. 3D 캐릭터·환경·애니메이션 제작 비용도 크고, 웹·모바일 성능 부담도 크다.
- 나중에 3D 연출이 필요해지면 FPS가 아니라 결승전 아레나나 오프닝 같은 연출 장면에 한정하거나 3인칭 쿼터뷰로 검토한다. MVP 범위는 아니다.
three.js 안에서 바뀌는 점
- 클라이언트만 three.js에서 Unity로 바뀐다. 서버(Colyseus/TypeScript)는 그대로이므로, S1(봇으로 서버 상태머신 검증)은 클라이언트 선택과 상관없이 먼저 진행할 수 있다.
- Unity를 쓰면 같은 코드로 모바일·PC 네이티브 빌드까지 확장할 수 있다.
확인 필요 / 리스크
| 항목 | 내용 | 대응 |
|---|---|---|
| Colyseus Unity SDK × 웹 빌드 | 공식 지원 플랫폼에 WebGL이 있다. 예전 버전(0.14)에서는 IL2CPP 직렬화 문제가 보고된 적 있다 | S1~S2 사이에 최소 웹 빌드로 연결하는 스파이크를 먼저 해 본다 |
| LiveKit 웹 빌드 | 웹 빌드는 별도 패키지(JS 브리지)를 쓰고, 공간 음향은 데모 수준이다 | 볼륨 감쇠를 직접 구현한다(2D라 간단). 스파이크에서 마이크 권한과 iOS Safari를 확인한다 |
| 호스팅 CSP | haylab 기본 CSP(script-src 'self')에서는 Unity wasm이 막힌다 |
게임 앱만 'wasm-unsafe-eval', blob:, LiveKit·Colyseus connect-src를 허용하고, 이 예외를 haylabnet docs/SECURITY.md에 기록한다 |
| 정적 파일 크기 | Cloudflare Static Assets는 파일당 25 MiB 제한이 있다 | Brotli 압축 + 2D라 대체로 문제없다. 넘으면 R2로 옮긴다 |
| 게임 서버 호스팅 | Colyseus는 상시 실행 Node 프로세스가 필요해 Workers에 올릴 수 없다 | Colyseus Cloud(약 $15/월) 또는 소형 VPS. S5 전에 결정한다 |