친구들과 어울리며, 함께 게임하고 싶은 유저가 3~5대의 휴대폰으로 요괴를 둥글게 둘러싸고, 좌우로 스와이프해 오행 구슬을 전달하고 조합해 공격하며 실시간으로 함께 싸우는 전투를 통해 제한된 시간 안에 아슬아슬하게 합을 맞추는 긴장감, 한국 전설 속 요괴를 함께 물리치며 느끼는 유대감과 성취감을 경험하도록 돕는 모바일 게임.
기존 별도 프로젝트의 구현을 feature/unity-prototype 브랜치로 이관했습니다. 이 저장소 루트가 Unity 프로젝트 루트이며 Assets, Packages, ProjectSettings가 함께 있습니다. Unity Hub에서 내려받은 저장소 폴더를 Unity 6000.5.7f1로 열고 아래 문서 순서로 확인하세요.
| 지금 구현된 기능 | 현재 범위 |
|---|---|
| 협동 연결 | 같은 Wi-Fi에서 2~5인, 방 탐색·Ready·공통 시작, 원형 좌우 이웃 |
| 하단 구슬 | 평면 2D 관성·마찰·충돌, 직접 드래그한 Yin+Yang만 조합 |
| 좌우 이동 | 놓은 구슬이 끝에 닿으면 이웃 화면으로 자동 전달, 남은 속도와 높이 유지 |
| 공격 | Combined를 위로 움직이며 손을 놓으면 방향·세기 기반 3D 투척, Host의 실제 충돌로 피해 확정 |
| 한 판 | 시작 구슬0·스태미나100, 생성 비용20, 시간 회복20/3초, 명중 회복5, HP 인원별 800~1400·피해20·180초·결과·Retry |
| 방 생성 개발자 모드 | Host가 방을 만들기 전에 인원별 몬스터 HP·피해·개인 구슬 한도·구슬 크기·시간·생성/회복 값을 임시 조정 |
빌드25의 개발자 설정은 해당 방의 Host 승인 설정으로만 사용하며 저장된 Config 에셋은 바꾸지 않습니다. 자동 검사 범위와 실기기 미실행 항목은 개발자 모드 검증 기록에 구분했습니다.
위 팀 소개는 게임의 기획 방향입니다. 이번 프로토타입에는 오행 속성·상성·요괴 AI·몬스터 공격·실제 방어가 포함되지 않습니다. 현재 구슬 규칙은 Yin/Yang/Combined이며 이관 과정에서 새 게임 기능을 추가하지 않았습니다.
- Unity 6000.5.7f1과 필요한 iOS Build Support를 준비합니다.
- Unity Hub에서 저장소 루트를 열고 Import·컴파일을 기다립니다.
Assets/_Project/HapioMVP/Scenes/ContinuousTransferBattle.unity를 엽니다.- 협동 플레이는 같은 빌드의 실행본이 최소 2개 필요합니다.
- 직접 빌드는 상세 빌드 안내와 P4 실행 안내를 따릅니다. iOS 서명에는 본인이 사용할 수 있는 Apple 개발 Team이 필요합니다.
Unity·URP·네트워크 패키지 버전은 저장된 설정을 유지합니다. 현재 기본 Bundle ID와 앱 출력 이름도 원래 프로토타입 값을 유지하므로, 제품명·배포 식별자 변경은 별도 작업으로 진행하세요.
- 전투 UI — Canvas에서 직접 편집하고 코드 연결 유지하기
- 정면 전투 그래픽 — Figma 에셋과 수동 배치·검증 기록
- 계획 — 추가 패키지 없는 핫스팟·Wi-Fi 호환성 개선 · L1~L3 완료, L4 핫스팟 확인 완료·일반 Wi-Fi/오프라인 LAN 미실행
- L1 네트워크 진단 코드·검증·빌드 방법
- 보고서 1 — Unity 프로젝트 준비와 기본 게임
- 보고서 2 — 2D 물리·3D 투척·최대5인 확장
- 보고서 3 — 실제 코드 읽기·유지보수·디버깅 실습
- 현재 연속 전달 구현
- 공개 검증 요약과 확인 한계
- 이관 범위·원본 보존·정적 검사
최초 빌드24 업로드는 기존 구현의 파일 이관이었으며, 당시 새 경로의 실행 검증과는 구분했습니다. 이후 앱26 네트워크 수정의 실제 검증 범위는 아래에 정리했습니다. 원시 기기 로그·서명 자료·원본 비공개 Git 이력은 공개하지 않았습니다.
fix/#5-local-network-compatibility에서 추가 패키지 없이 IPv4/IPv6 수신, 여러 주소 재시도·취소, 검색 만료와 입장 단계 안내를 적용했다. 게임 계약과 규칙은 빌드24를 유지한다. 코드 구조·조정값·앱26 빌드 방법은 L2 기록을 따른다.
- L3 회귀 검사: EditMode 1,417개·PlayMode 146개 통과. Mac의 IPv4/IPv6 혼합 3/5인에서 상태 불일치0, 전달·실제 피격·Victory/Retry 확인. Fixture·합성 포인터를 사용한 독립 앱 검사다.
- L4 핫스팟 확인: iPhone 핫스팟 Host→iPad의 게임 시작·새 방 재입장은 기기 기록, 전달·조합·투척·결과 화면은 사용자 확인으로 구분한다.
- 일반 공유기 Wi-Fi·인터넷 없는 LAN은 환경 미확보로 NOT_RUN이며 L4 전체는 미완료다. 인터넷 없는 LAN을 허용하는 구조와 실제 해당 환경의 검증 완료는 구분한다.
위 결과는 파일 이관 이후 별도 검증 폴더에서 수행한 네트워크 수정 검증이다. 기존 보고서의 실행 상태를 소급 변경하거나 모든 무선 환경의 성공을 보장하지 않는다.