Data Systems

Abstract

게임에는 코드 말고도 값이 있습니다 — 적의 체력, 화면 문구, 서버 주소, 볼륨, 현재 점수. 이 페이지는 그 값들을 성격에 따라 넣어 두는 다섯 개의 서랍을 소개합니다. 어느 서랍에 넣을지는 두 가지 질문으로 정해집니다: 누가 값을 정하나, 그리고 언제까지 남아야 하나.

어느 서랍에 넣을까

graph TD
    Q1{"값을 누가 정하나?"}
    Q1 -- "개발자 (빌드 전에 정해짐)" --> Q2{"어떤 모양인가?"}
    Q1 -- "실행 중에 생긴다" --> Q3{"게임을 꺼도<br>남아야 하나?"}
    Q2 -- "같은 모양의 행이 여러 개" --> DT["DataTable<br>적 스탯, 아이템 목록"]
    Q2 -- "이름 하나에 값 하나" --> CF["Config<br>서버 주소, 상수"]
    Q2 -- "언어마다 다른 문장" --> LC["Localization<br>UI 문구"]
    Q3 -- "남아야 한다" --> ST["Setting<br>볼륨, 최고 점수"]
    Q3 -- "이번 실행만" --> DN["DataNode<br>현재 스테이지, 임시 상태"]

Mermaid

복사

서랍	값의 출처	게임 코드가 쓸 수 있나	저장되나	상세
DataTable	텍스트 에셋	읽기만
Config	텍스트 에셋	읽기 (런타임 추가도 가능)
Localization	텍스트 에셋 (언어별)	읽기만
Setting	플레이어 기기	읽고 쓰기	디스크
DataNode	실행 중 코드	읽고 쓰기	메모리만

앞의 셋(DataTable · Config · Localization)은 "텍스트 에셋을 읽어 해석한다"는 과정이 같아서 같은 로딩 부품을 공유합니다(Data Provider System(데이터 공급자 시스템)). 그래서 셋 다 ReadData(주소) → 성공 이벤트 → 조회라는 같은 순서로 씁니다.

ToyboxNightmare 는 어디에 무엇을 두었나

다섯 서랍 중 하나도 쓰지 않습니다. 규모가 작아서 전부 코드와 객체로 충분했기 때문입니다. 대신 "나중에 어느 서랍으로 갈 값인지"가 드러나도록 모아 두었습니다.

지금 있는 곳	내용	커지면 갈 곳
EnemyTable, WeaponTable, AllyTable (C# 상수 배열)	적 5종·무기 4종·아군의 수치	DataTable
UITable, SoundTable (C# 상수)	Addressables 주소, 그룹 이름	Config 또는 그대로
HUDForm 의 const string	"Select a character", "Score: {0}"	Localization
(저장하지 않음)	볼륨, 최고 점수	Setting
SurvivalGame 의 필드	현재 점수, 게임오버 여부	그대로 (또는 Procedure 가 늘면 DataNode)

"처음부터 전부 테이블로" 만들 필요는 없습니다. 값을 한곳에 모아 두기만 하면 옮기는 것은 나중에 반나절 일입니다. 흩어져 있으면 옮길 수 없습니다.

이 에디션에서 다른 점 · 본문을 읽을 때 주의할 점

•

본문의 DataTableManager.CreateDataTable<T>(), SetSettingHelper, Load 등은 코어 API 입니다. 게임 코드는 GameEntry.GetComponent<DataTableComponent>() 같은 Unity 컴포넌트를 통하고, 헬퍼 지정과 초기 로드는 컴포넌트가 대신 합니다.

•

"리소스 시스템 연동"의 데이터 파일은 이 에디션에서 Addressables 에 등록한 TextAsset 이고, ReadData 에는 그 주소를 넘깁니다. "진행 상황 이벤트"는 발생하지 않고 성공·실패만 옵니다.

•

로드는 비동기입니다. ReadData 직후에는 비어 있고, 성공 이벤트 뒤에 조회해야 합니다. 그래서 데이터 로딩은 보통 게임 시작 전 전용 Procedure(Preload)에서 모아서 하고, 전부 끝나면 다음 Procedure 로 넘어갑니다.

개요

GameFramework의 데이터 시스템(Data Systems)은 게임 데이터, 설정, 구성 등을 관리하기 위한 강력한 메커니즘을 제공합니다.

이 컴포넌트는 다섯 가지 주요 데이터 관리 하위 시스템으로 구성되며, 각각 게임 데이터의 저장, 접근, 조직화, 지속성을 담당합니다.

다섯 가지 주요 매니저

DataTableManager – 고유 식별자를 가진 행(Row) 단위의 구조화된 데이터 테이블 관리

LocalizationManager – 다국어 텍스트 콘텐츠 관리(키-값 딕셔너리 기반)

ConfigManager – 키-값 기반 게임 설정 값 접근

SettingManager – 사용자 설정 값 저장/로드

DataNodeManager – 계층적 트리 구조의 데이터 노드 관리

공통 패턴

각 시스템은 다른 데이터 타입을 처리하지만 다음과 같은 공통 아키텍처 패턴을 공유합니다.

•

모든 매니저는 GameFrameworkModule을 상속

•

데이터 로드를 위한 DataProvider 패턴 사용

•

플랫폼별 구현을 위한 Helper 인터페이스 활용

•

효율적인 조회를 위한 딕셔너리(Dictionary) 기반 저장

•

타입 안전성(Type-safe) 있는 데이터 접근 메서드 제공

시스템별 상세 설명

1. DataTable System

구조화된 타입 안전 데이터 저장소를 제공하며, 캐릭터 스탯, 아이템 속성, 레벨 설정 등에 주로 사용됩니다.

특징

•

제네릭을 통한 강력한 타입 안전성

•

ID 기반 빠른 데이터 조회

•

행(Row) 필터링, 검색, 정렬 지원

•

문자열/바이너리/리소스에서 데이터 로드 가능

사용 예시

IDataRow 인터페이스를 구현하는 클래스 생성

DataTableManager.CreateDataTable<T>()로 테이블 생성

ParseData 또는 리소스 시스템을 통해 데이터 로드

ID나 조건식으로 행 검색

2. Localization System

다국어 지원을 위해 문자열 딕셔너리를 관리하는 시스템입니다.

특징

•

다중 언어 지원

•

키 기반 문자열 검색

•

플레이스홀더 기반 문자열 포맷팅

•

리소스 시스템과 연계하여 언어 데이터 로드

사용 예시

LocalizationManager.Language로 현재 언어 설정

ReadData로 언어 데이터 로드

GetString으로 번역된 문자열 가져오기

3. Configure System

게임 전역 설정을 키-값 형태로 제공하며, 주로 정적 게임 설정에 사용됩니다.

특징

•

Key-Value 기반 설정 저장

•

bool, int, float, string 등 다양한 타입 지원

•

런타임 수정 가능

•

리소스 시스템과 연동 가능

사용 예시

ReadData로 설정 데이터 로드

HasConfig로 특정 키 존재 여부 확인

Get<Type> 메서드로 값 조회

필요 시 런타임 수정

4. Settings System\

사용자 설정 값을 세션 간 유지하기 위해 설계된 시스템입니다.

특징

•

영구적(파일/플랫폼별) 저장

•

bool, int, float, string, object 타입 지원

•

저장/불러오기 기능 제공

•

Helper를 통한 플랫폼 독립 구현

사용 예시

SetSettingHelper로 플랫폼별 헬퍼 지정

Load로 기존 설정 불러오기

Getter/Setter로 값 조회 및 변경

Save로 변경 사항 저장

5. DataNode System

계층적 트리 구조를 기반으로 데이터를 관리합니다.

특징

•

부모-자식 관계의 트리형 구조

•

경로 기반 노드 접근

•

Variable 시스템을 통한 다양한 데이터 타입 지원

•

동적 노드 생성 및 삭제 가능

사용 예시

GetOrAddNode("Root/Child")로 노드 접근 또는 생성

SetData로 값 설정

GetData로 값 읽기

리소스 시스템 연동

•

SettingManager를 제외한 모든 데이터 시스템은 리소스 시스템과 연계됩니다.

•

데이터 로딩 과정:

SetResourceManager로 리소스 매니저 지정

ReadData(AssetName) 호출

비동기 로드 → 데이터 파싱

로드 성공/실패/진행 상황을 이벤트로 알림

데이터 시스템 비교표

시스템	주요 용도	구조	지속성	타입 안전성	리소스 연동
DataTable	게임 데이터(아이템, 캐릭터)	타입 지정 테이블	읽기 전용(대개)	강함(제네릭)	O
Localization	다국어 텍스트	Key-Value	읽기 전용(대개)	문자열 기반	O
Config	전역 게임 설정	Key-Value	읽기/런타임	기본 타입	O
Setting	사용자 설정	Key-Value	영구 저장	기본+객체 직렬화	X
DataNode	계층적 동적 데이터	트리 구조	메모리 상	Variable 기반	X