mobile-dm

웹 브라우저에서 돌아가는 5v5 캐주얼 모바일 FPS. 터치 조이스틱 + 룩패드 조작, Colyseus 서버 권위 멀티플레이(클라이언트 예측 + 보정), Rapier 물리 기반.

게임

• 모드 — 폭탄 설치/해체(bomb), 거점 점령(hardpoint)
• 맵 — Dockyard · Rooftop · Subway · Warehouse
• 무기 — 히트스캔 사격, 로드아웃 템플릿 선택
• 봇 — 인원 부족 시 AI 봇으로 채움
• 진행 — XP · 배틀패스 · 무기 숙련도(mastery) · 미션

조작

• 좌측 조이스틱 이동 · 우측 룩패드 시점 · 사격 버튼 (모바일 터치)
• 데스크톱 브라우저에서도 플레이 가능

구조

• src/ — 클라이언트 (React + @react-three/fiber)
  • scene/ 맵·플레이어·오브젝트 / game/ 규칙·무기·모드·진행 / net/ 예측·보간·보정 / ui/ HUD·메뉴·모바일 컨트롤
• server/ — Colyseus 서버 (GameRoom, QueueRoom, GameState 스키마)

기술

React 19 · TypeScript · @react-three/fiber / drei / rapier / postprocessing · Colyseus · Zustand · Howler · Tailwind CSS · Vite

실행

# 클라이언트
npm install
npm run dev

# 서버 (별도 터미널)
cd server && npm install
# 실행 커맨드는 server/package.json 참고