텍스트 채팅과 DB 기록, 캠 토글을 붙이던 중 서버 로그 한 줄에서 발견한 레이스 컨디션 — 매칭 직후 상대가 나가면 대화 기록이 통째로 사라지던 버그를 추적하고 고친 기록.

오메글 같은 랜덤 화상채팅을 붙이며 프로덕션에서만 드러난 Colyseus/WebRTC 버그 3개 — 빈 스키마가 깨뜨린 핸드셰이크, 교체가 아니라 누적되는 onMessage 핸들러, 그리고 4KB를 넘는 SDP가 끊어버린 연결. 초록불 테스트가 왜 이걸 못 잡았는지.

실시간 2D 가상 오피스(Phaser + Colyseus + LiveKit)를 만들며 만난 세 가지 미묘한 버그 — 탭 포커스 후 속도 저하, 원격 플레이어 끊김(Dead Reckoning), 맵 격리 — 를 원인과 해결까지 기록으로 남긴다.

Colyseus는 Node.js 기반 멀티플레이어 게임 서버 프레임워크입니다. Room, State, Schema를 이용한 상태 동기화 방식과 클라이언트 연동 방법을 실제 프로젝트 예제로 설명합니다.