← haylab

기술 결정 — 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 도트인가

  1. 이 게임의 핵심은 조준이 아니라 정보다. 경매, 블러핑, 사회적 추리, 보드게임이 중심이다. FPS 시점은 손 기술 게임에 맞는 형식이라, 여기서는 들이는 비용만큼 재미가 늘지 않는다.
  2. “누가 누구 곁에 있었나”가 한눈에 보여야 한다. 근접 밀담과 동선 증거가 이 게임의 차별점이다. 탑다운 시점에서는 방 전체의 위치 관계가 늘 보인다. FPS 시점에서는 시야 밖이 사라지기 때문에 이 메커닉이 약해진다. 이 장르(Gather·ZEP·Among Us)가 탑다운인 데도 이유가 있다.
  3. 근접 보이스가 단순해진다. 2D에서는 “거리 → 볼륨” 공식 하나로 충분하다. Unity Web 빌드에는 3D 공간 음향(방향감)이 2D처럼 재생되는 버그 보고가 여러 건 있는데, 2D를 택하면 이 문제를 아예 피할 수 있다.
  4. 카드·보드·경매 UI와 잘 맞는다. 매치 화면은 어차피 2D UI다. 월드도 2D면 월드와 매치 사이를 오갈 때 시각적으로 끊기지 않는다.
  5. 표정과 연기를 싸게 표현할 수 있다. 사회적 게임에서는 캐릭터의 반응이 중요하다. 3D에서는 어설픈 애니메이션이 바로 싸 보인다. 도트는 말풍선, 이모트, 2~4프레임 모션만으로도 감정이 전달된다.
  6. 비용과 성능. 천상·연옥·림보 세 공간의 에셋 제작 비용이 3D보다 훨씬 작고, 모바일 브라우저에서 웹 빌드가 가볍다. 90분 세션에서 멀미 문제도 없다.
  7. 기존 경험을 살릴 수 있다. 이미 Unity 2D 에셋 작업(UnityAsset 프로젝트) 경험이 있다.

3D FPS를 택하지 않는 이유 (그리고 3D를 쓴다면)

three.js 안에서 바뀌는 점

확인 필요 / 리스크

항목 내용 대응
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 전에 결정한다