TaskTown
씬 전환·튜토리얼·공용 사운드를 구현하고 팀 기능을 연결했습니다.
클릭과 타이핑으로 재화를 얻고 마을을 키우는 Windows 데스크톱 게임입니다. 5인 팀의 개발 팀장으로 팀원이 만든 기능을 메인 씬과 빌드에 통합하고, 연결 상태를 함께 검토했습니다.
씬 전환
전환 순서와 창 설정을 공통 흐름으로 묶었습니다.
로고·타이틀·게임 화면으로 전환할 때 각 화면에 맞는 해상도와 창 설정이 적용되도록 구성했습니다.
Bootstrap에서 전역 Manager를 초기화하고 SceneCatalogSO로 Scene 전환 정보를 관리했습니다. 비동기 preload와 활성화 시점을 분리해 로딩 연출과 전환을 조정했습니다.
본인 구현
Scene 전환, Scene별 해상도·창 모드 설정, 전환 후 HWND 재탐색과 제어권 인계를 담당했습니다.
팀 기능과 연결
팀원의 TransparentWindow가 처리하는 투명도·Always-on-top·click-through 기능과 연결했습니다.
튜토리얼 상태 관리
다시 보기를 허용하면서 보상은 중복 지급되지 않도록 했습니다.
필요한 때에만 튜토리얼을 불러오고, 다시 보기에서도 기존 보상 수령 기록을 유지하도록 진행 상태를 분리했습니다.
Tutorial을 Additive Scene으로 분리해 필요한 시점에 로드하고 완료 후 언로드했습니다. 진행 단계는 StateMachine, 게임 이벤트와 Tutorial 신호의 연결은 EventBridge가 담당하도록 구성했습니다.
- MainScene 자동 진입 시 SaveData의 미완료 상태를 확인해 Overlay를 로드했습니다.
- Replay에서는 진행 상태를 다시 시작하되 일회성 보상 수령 기록은 유지했습니다.
- 단계 진입 시 이벤트를 구독하고, 단계 전환·완료 시 해제했습니다.
- 구버전 Save 복원과 Skip·Replay까지 같은 진행 흐름 안에서 처리했습니다.
사운드·BGM
씬이 바뀌어도 같은 사운드 설정을 적용하도록 했습니다.
장면과 UI에서 공용 사운드를 재생하고, 사용자가 조절한 볼륨을 저장·복원하도록 구성했습니다.
SoundManager와 AudioMixer로 재생·볼륨 설정을 공통 관리하고, Clip 데이터와 재생 요청을 분리했습니다. one-shot AudioSource를 재사용하고 Option UI에 볼륨 저장·복원을 연결했습니다.
- Master·BGM·UI·Environment 볼륨을 공통 관리했습니다.
- BGM Playlist·랜덤·Loop·일시정지를 Scene 전환과 독립적으로 연결했습니다.
- 통합 과정에서 누락된 UI 버튼음을 점검하고 기본 클릭음 규칙을 적용했습니다.
팀 기능 통합·협업
각자 만든 기능이 하나의 게임 흐름으로 이어지도록 연결했습니다.
입력·경제·인벤토리·마을·UI를 하나의 MainScene에 연결하는 작업을 맡았습니다.
기능별 연결 지점 정리
팀원이 구현한 입력 보상·뽑기·생산 기능의 이벤트를 Tutorial에 연결하고, MainScene의 실행 흐름과 참조를 맞췄습니다.
통합 기준과 적용 기록
입력 보상·뽑기·생산·배치·저장 기능이 제공하는 이벤트와 데이터를 Tutorial·SceneFlow·공용 사운드에 연결했습니다.
MainScene 통합 PR #43에는 Bootstrap→Logo→Title→Main 흐름과 사운드 UI·버튼음·Build Settings 연결을 정리했습니다. 전환·BGM·버튼음 확인 항목과 후속 리뷰 의견을 함께 남겼습니다.
2026.10.22 확인 기준 README의 전체 EditMode·수동 E2E·성능 결과 표는 Not Checked입니다. 당시 개별 리뷰와 저장소 전체 검증 결과는 구분합니다.
- Input·Window 입력 보상·축소 모드·투명창 제어를 Tutorial 입력 제한과 Scene별 창 정책에 연결했습니다.
- Gacha·Production 뽑기 결과·인벤토리 연결·생산량 갱신을 Tutorial 완료 조건과 MainScene 참조에 연결했습니다.
- Inventory·UI 버튼·탭·슬롯 이벤트와 공용 Prefab을 Tutorial 대상과 이벤트 연결 기준에 맞췄습니다.
- Village·Placement 주민 ID·확정 배치 목록을 배치 저장·복원과 Scene 통합에 연결했습니다.
- Save·Sound 공용 저장 형식과 볼륨·BGM 상태를 Tutorial·배치 데이터 호환성과 Option UI에 연결했습니다.
팀원의 Scene 작업과 분리
팀원이 메인 씬을 수정 중이어서 줄바꿈 개선은 씬을 저장하지 않는 코드 변경으로 진행했습니다. 단어와 수동 줄바꿈을 유지하는 것을 검토 기준으로 정했습니다.
수정 범위와 줄바꿈 검토 기록
2026.08.07 작업의 줄바꿈 전용 커밋은 TutorialBubbleView·줄바꿈 유틸리티·Editor 테스트와 관련 Meta만 포함하며, Scene·Prefab은 변경하지 않았습니다.
어절 유지·긴 단어·수동 개행을 확인하는 테스트 코드를 추가했습니다. 테스트용 측정 함수를 사용하는 코드이며, 실제 TMP 렌더나 전체 빌드의 검사 결과는 아닙니다.
PR #140의 실행 검사는 Not Checked로 남아 있습니다. 팀 리뷰에서 단어 끊김이 없음을 확인한 내용과 폰트 누락을 보완한 기록을 별도로 구분했습니다.
변경 이후의 사용 흐름까지 검토
사운드 컴포넌트의 위치를 옮기면서 참조와 Mixer 연결을 정리했습니다. 재생·볼륨 변경뿐 아니라 설정 저장과 재시작 후 복원도 리뷰 항목에 포함했습니다.
사운드 참조와 리뷰 기준
2026.07.10 SoundSettingsApplier의 위치를 옮기며 SoundManager·설정 패널의 참조와 Mixer 연결을 다시 정리했습니다. 저장된 볼륨을 시작·재생 직전에 적용하는 변경도 포함했습니다.
PR #20의 리뷰에서는 재생·저장값·실시간 볼륨·재실행 복원을 확인하고, 설정창의 미연결 클릭음도 지적했습니다. 확인 항목과 리뷰 결과를 구분해 남겼습니다.
Codex의 코드 조사·수정안과 Unity MCP의 참조 확인을 통합 검토에 활용했습니다.
개별 수정·리뷰 기록이며, 전체 테스트 통과나 성능 개선을 뜻하지 않습니다.