[Unity] 스테이지 전환 구조 설계기 — Dictionary 기반 구현

shin0112·2025년 10월 30일

TIL

Unity

목록 보기

7/13

✨ 들어가며

오늘은 StageScene 구조를 정리하다가 “각 스테이지 정보를 어떻게 불러오고 관리할까?”에 대해 고민했다.

Scene 안에는 StageManager 오브젝트가 있고, 그 하위에는 여러 개의 Stage 프리팹이 들어 있다.

Stage를 선택하면 그 스테이지로 진입하고, 진행 중에는 나머지 스테이지가 간섭하지 않게 해야 한다.
즉, “어떤 스테이지를 선택했는가”에 따라 그 스테이지만 활성화하고 나머지는 비활성화하는 구조가 필요했다.

1️⃣ 구조 고민

처음엔 크게 세 가지 방향을 생각했다.

Instantiate 방식
→ 프리팹을 Resources에서 불러와서 즉시 생성
→ 초기화는 쉽지만 로딩 비용이 발생
활성화/비활성화 방식
→ 씬 안에 미리 모든 스테이지를 넣고, 선택된 스테이지만 SetActive(true)
→ 빠르고 간단하지만, 메모리 상에 모든 스테이지가 상주
데이터 기반 로드 (JSON / ScriptableObject)
→ 스테이지 정보만 저장하고 필요할 때 불러오는 방식
→ 구조는 깔끔하지만, 지금은 오버엔지니어링에 가까움

결국 지금은 스테이지 수가 많지 않으니까, 두 번째 방법(활성화/비활성화)을 택했다.
로딩 속도가 빠르고, 구조도 단순하기 때문이다.

2️⃣ StageManager 구조 설계

StageManager는 전체 스테이지를 관리하고, StageController는 각 스테이지 내부 로직을 담당한다.

StageManager는 게임의 진행 상태에 따라 각 StageController의 메서드를 호출한다.

public enum GameState
{
    None,
    Ready,
    Play,
    Dead,
    Stop,
}

public void Init(GameManager gameManager)
{
    _gameManager = gameManager;

    var stages = GetComponentsInChildren<StageController>(true); // 비활성화 포함
    _stages.Clear();

    foreach (var stage in stages)
    {
        int id = stage.StageId;
        if (_stages.ContainsKey(id))
        {
            Debug.Log($"중복된 ID: {id}");
            continue;
        }
        _stages[id] = stage;
        stage.gameObject.SetActive(false);
    }
}

public void SelectStage(int id)
{
    _currentStage = _stages[id];
    _currentStage.gameObject.SetActive(true);
    StartStage();
}