--- title: PenguTown 펭귄 에셋과 웹 이동 프로토타입 date: 2026-11-01T07:57:55.063Z version: v1.0.2 status: 작업 중 state: progress project: pengutown type: 작업 메뉴얼 report_kind: manual category: 순차 작업 · 반복 QA summary: 공유 기획을 확인하고 실제 펭귄 에셋을 확보해 기본 이동과 물리 동작을 검증합니다. format: tracefolio-v2 priority: normal manual_id: pengutown-movement-20261101 round: 2 manual_state: active payload: ../assets/submissions/2026-11-01-manual-pengutown-movement-20261101-20261101075755063-v1.0.2.json --- ## 목표와 완료 기준 공유 기획의 펭귄 힐링 공간을 바탕으로 Unity 6000.0.83f1에서 걷기·배 미끄러짐·경사·다이빙·수영을 구현합니다. 완료 기준: 실제 에셋·라이선스·애니메이션 확인, Unity 기본 동작 구현, 실제 PhysX 및 그래픽 플레이어 검증, 결과 보고서 공개 후속 2회차 · 순차 진행 · 전체 4개 · 이번 실행 T01, T02, T03, T04 ## 순차 작업 메뉴얼 | 순서 | 작업 | 실행 절차 | 완료 기준 | QA 절차 | 상태 | | --- | --- | --- | --- | --- | --- | | T01 | 에셋과 기획 확인 | 공유 본문을 브라우저에서 읽고 무료 모델 원본과 판매자 정보를 확인합니다. | 확인한 라이선스와 실제 클립 목록을 기록합니다. | 원본 ZIP·GLB 구조·출처를 대조합니다. | 완료 | | T02 | 기본 이동 구현 | Unity Rigidbody·지형 MeshCollider·부력·수영과 모델 애니메이션을 구현합니다. | 동작이 연결되고 실제 펭귄 에셋이 표시됩니다. | Unity 컴파일·실제 PhysX QA·Windows 빌드를 실행합니다. | 완료 | | T03 | 실행 검증 | Unity 그래픽 플레이어에서 동작을 실행하고 실제 화면과 runtime-qa.json을 확인합니다. | 모델이 표시되고 핵심 이동 전환이 실행됩니다. | Unity 플레이어 화면과 실제 이동 상태·깊이·속도를 비교합니다. | 완료 | | T04 | 배포와 결과 공개 | Unity 결과·원본 근거와 화면을 중앙 보고서에 등록하고 공개 링크를 확인합니다. | 실행 결과와 제한을 외부에서 열리는 보고서로 전달합니다. | 이번 변경만 스테이징하고 커밋·푸시·Pages 배포·개별 공개 URL을 확인합니다. | 진행 | ## QA 반복 기록 ### Q01 · step · 2026-11-01T16:44:37+09:00 공유 기획과 원본 에셋을 실제 확인했습니다. - T01 r1 · pass: 원본 ZIP 확보, CC0 출처, idle/swim/tpose/walk 실물 클립과 리그를 확인했습니다. · 근거: docs/asset-research.md, docs/penguin-inspection.json, assets/vendor/penguin/penguin.zip ### Q02 · step · 2026-11-01T07:46:51.085Z 최초 Unity 컴파일 실패를 보존합니다. - T02 r2 · fail: 오디오 모듈을 사용하지 않는 프로젝트에서 AudioListener 참조로 CS1069 발생. 참조를 제거했습니다. · 근거: outputs/unity-build.log ### Q03 · step · 2026-11-01T16:50:44.103+09:00 최초 그래픽 실행에서 모델 표시 실패를 확인했습니다. - T02 r2 · fail: 물리 전환은 통과했지만 실제 화면에 펭귄이 보이지 않았습니다. 원본 키 범위와 FBX 단위 변환을 검사·수정했습니다. · 근거: outputs/unity-qa-missing-model/, docs/animation-keyframes.json ### Q04 · step · 2026-11-01T16:56:00.5513601+09:00 최종 Unity 컴파일·PhysX·빌드·그래픽 실행을 확인했습니다. - T02 r2 · pass: 최종 빌드 exit 0, 다섯 이동 상태와 부력 복귀 통과, idle/walk/swim 0.917초 확인. · 근거: outputs/unity-build-final.log, outputs/unity-qa/physics-qa.json - T03 r2 · pass: 실제 플레이어에서 걷기·배 미끄러짐·수영·잠수 장면과 수중 카메라를 확인했습니다. 실제 UI 클릭으로 수영·잠수, R 키 복귀도 확인했습니다. · 근거: outputs/unity-qa/runtime-qa.json, slide.png, swim.png, dive.png; 실제 게임 창 조작 ## 남은 작업과 다음 반복 중앙 보고서 푸시·Pages 배포·개별 공개 링크 검증 진행 중 이전 회차: [메뉴얼 열기](../../../projects/pengutown/reports/2026-11-01-manual-pengutown-movement-20261101-20261101074752291-v1.0.1.html) ## 작업 시간 - 제안 시간: 조사 5~10분, 구현·검증 추가 20~40분 - 실제로 완료된 시간: 진행 중 - XERJ: 미사용 — 빈 프로젝트이며 제공된 XERJ 연결·검색 스크립트 없음. 직접 파일 검사와 rg 사용