설정 시스템 (Configuration System)

Abstract

이름이 비슷해서 헷갈리지만 둘은 방향이 반대입니다. Config 는 개발자가 정해서 내보내는 값(읽기 전용), Setting 은 플레이어 기기에 저장되는 값(읽고 쓰기)입니다. "게임을 껐다 켜도 남아 있어야 하는가?"가 예라면 Setting 입니다.

실무에서 필요한 순간

•

Setting: 볼륨·화면 옵션, 최고 점수, 튜토리얼을 봤는지, 마지막으로 고른 캐릭터

•

Config: 서버 주소, 동시 스폰 상한, 기능 on/off 스위치처럼 빌드를 다시 하지 않고 바꾸고 싶은 상수

직접 해 보기 — ToyboxNightmare 의 볼륨을 저장하기

예제의 일시정지 메뉴(PauseMenuForm)에는 볼륨 슬라이더가 있지만, 값이 저장되지 않아 게임을 다시 켜면 초기화됩니다. Setting 으로 고쳐 봅니다.

// PauseMenuForm.cs
private const string MusicVolumeKey = "Volume.Music";

// 폼이 열릴 때: 저장된 값이 있으면 믹서에 먼저 넣는다
protected override void OnOpen(object userData)
{
    base.OnOpen(userData);

    SetPanelActive(false);
    GamePause.SetPaused(false);

    RestoreVolumeFromSetting();   // ← 추가
    PullVolumeFromMixer();        // 기존: 믹서 값을 슬라이더에 반영
}

private void RestoreVolumeFromSetting()
{
    if (masterMixer == null) return;

    SettingComponent setting = GameEntry.GetComponent<SettingComponent>();
    if (!setting.HasSetting(MusicVolumeKey)) return;   // 처음 실행: 믹서 기본값을 그대로 둔다

    masterMixer.SetFloat(MusicVolumeParam, setting.GetFloat(MusicVolumeKey));
}

// 슬라이더가 움직일 때: 믹서에 적용하고 기록한다
public void SetMusicLevel(float level)
{
    if (masterMixer == null) return;

    masterMixer.SetFloat(MusicVolumeParam, level);
    GameEntry.GetComponent<SettingComponent>().SetFloat(MusicVolumeKey, level);   // ← 추가
}

// 폼이 닫힐 때: 디스크에 쓴다
protected override void OnClose(bool isShutdown, object userData)
{
    GamePause.Clear();
    GameEntry.GetComponent<SettingComponent>().Save();   // ← 추가

    base.OnClose(isShutdown, userData);
}

복사

SetFloat 는 메모리에만 기록합니다. Save() 를 불러야 파일에 쓰입니다. 슬라이더를 끄는 동안 매 프레임 저장하지 않도록, 저장은 닫을 때 한 번만 합니다. 프레임워크가 정상 종료될 때도 Save() 가 한 번 자동으로 불리지만, 모바일에서 앱이 강제 종료되면 그 경로를 타지 않습니다. 중요한 변경 직후에는 직접 저장하는 습관을 들이세요.

저장 위치 바꾸기

GameFramework.prefab 의 Setting 오브젝트에서 Setting Helper Type Name 을 바꿉니다.

헬퍼	저장 위치	고를 때
UnityGameFramework.Runtime.DefaultSettingHelper (기본)	persistentDataPath/GameFrameworkSetting.dat	파일 하나로 관리, 백업·삭제가 쉽다
UnityGameFramework.Runtime.PlayerPrefsSettingHelper	Unity PlayerPrefs	WebGL 처럼 파일 접근이 불편한 플랫폼

클라우드 저장이 필요하면 SettingHelperBase 를 상속한 헬퍼를 직접 만들어 끼우면 되고, 게임 코드의 GetFloat / SetFloat 호출은 그대로 둡니다.

자주 걸리는 곳

•

저장된 설정은 SettingComponent 의 Start 에서 로드됩니다. 다른 MonoBehaviour 의 Awake / Start 에서 읽으면 아직 비어 있을 수 있습니다. Procedure 의 OnEnter 나 UI 폼의 OnOpen 처럼 프레임워크가 돈 뒤의 시점에서 읽으세요.

•

Config 의 ReadData 는 비동기입니다. LoadConfigSuccessEventArgs 를 받은 뒤에 GetInt 등을 부릅니다.

•

이 에디션에는 GameEntry.Config / GameEntry.Setting 같은 정적 프로퍼티가 없습니다. GameEntry.GetComponent<T>() 로 얻습니다. 본문 예제도 그렇게 고쳐 두었습니다.

•

ToyboxNightmare 는 현재 Config 와 Setting 을 쓰지 않습니다. 위 볼륨 저장은 10. 확장 과제 — 여기서부터는 직접 로 직접 구현해 보는 부분입니다.