데이터 테이블 (Data Tables)

Abstract

데이터 테이블은 엑셀 표를 게임 안으로 가져오는 통로입니다. 한 줄이 한 행, 한 행이 C# 객체 하나가 됩니다. 수치를 코드에서 빼내 텍스트 파일로 옮기면, 밸런스를 고칠 때 재컴파일이 필요 없고 기획자가 직접 손댈 수 있습니다.

실무에서 필요한 순간

•

적·아이템·스킬이 수십 종이 되어 코드 상수로는 한눈에 안 들어올 때

•

밸런스 수치를 프로그래머가 아닌 사람이 고쳐야 할 때

•

빌드 후에도 수치를 패치하고 싶을 때 (Addressables 원격 그룹과 조합)

직접 해 보기 — ToyboxNightmare 의 적 스탯을 테이블로 옮기기

예제는 적 스탯을 EnemyTable.cs 의 C# 배열로 들고 있습니다. 이것을 데이터 테이블로 바꾸는 전 과정입니다.

① 텍스트 파일을 만든다 — Enemy.txt, 탭 구분. # 으로 시작하는 줄은 주석입니다.

#Id	AssetName	MaxHP	Attack	Interval	Score
Zombunny	100	10	0.5	10
ZomBear	100	10	0.5	10
ZombieDuck	120	20	1.0	20
Clown	150	30	1.5	25
Hellephant	200	35	2.0	50

Plain Text

복사

② 행 클래스를 만든다 — DataRowBase 를 상속하고 Id 와 ParseDataRow 를 구현합니다.

using UnityGameFramework.Runtime;

namespace ToyBoxNightmare
{
    public class EnemyRow : DataRowBase
    {
        private int mId;

        public override int Id { get { return mId; } }
        public string AssetName { get; private set; }
        public int MaxHitPoints { get; private set; }
        public int AttackDamage { get; private set; }
        public float TimeBetweenAttacks { get; private set; }
        public int ScoreValue { get; private set; }

        public override bool ParseDataRow(string dataRowString, object userData)
        {
            const int ColumnCount = 6;

            string[] columns = dataRowString.Split('\t');
            if (columns.Length != ColumnCount)
                return false;

            mId                = int.Parse(columns[0]);
            AssetName          = columns[1];
            MaxHitPoints       = int.Parse(columns[2]);
            AttackDamage       = int.Parse(columns[3]);
            TimeBetweenAttacks = float.Parse(columns[4], System.Globalization.CultureInfo.InvariantCulture);
            ScoreValue         = int.Parse(columns[5]);
            return true;
        }
    }
}

복사

③ Addressables 에 등록한다 — Enemy.txt 를 Groups 창에 끌어다 놓고 주소를 EnemyTable 로 줍니다.

④ 로드한다 — 비동기이므로 성공 이벤트를 기다립니다. 게임 시작 전 로딩용 Procedure 에 두는 것이 정석입니다.

DataTableComponent dataTable = GameEntry.GetComponent<DataTableComponent>();
EventComponent events = GameEntry.GetComponent<EventComponent>();

events.Subscribe(LoadDataTableSuccessEventArgs.EventId, OnLoadDataTableSuccess);
events.Subscribe(LoadDataTableFailureEventArgs.EventId, OnLoadDataTableFailure);

IDataTable<EnemyRow> table = dataTable.CreateDataTable<EnemyRow>();
((DataTableBase)table).ReadData("EnemyTable");

복사

⑤ 꺼내 쓴다 — 성공 이벤트 이후 어디서든.

IDataTable<EnemyRow> table = GameEntry.GetComponent<DataTableComponent>().GetDataTable<EnemyRow>();

EnemyRow row = table.GetDataRow(5);                                   // Id 로
EnemyRow duck = table.GetDataRow(r => r.AssetName == "ZombieDuck");   // 조건으로

복사

자주 걸리는 곳

•

ReadData 는 IDataTable<T> 에 없습니다. CreateDataTable<T>() 가 돌려준 객체를 DataTableBase 로 캐스팅해서 부릅니다.

•

ReadData 직후에는 테이블이 비어 있습니다. 성공 이벤트 전에 GetDataRow 를 하면 null 입니다.

•

같은 행 타입으로 테이블을 두 번 만들면 예외입니다. 재시작 흐름이 있다면 HasDataTable<T>() 로 먼저 확인합니다.

•

float.Parse 는 기기 언어 설정에 따라 소수점 기호가 달라집니다. CultureInfo.InvariantCulture 를 넘기세요.

•

이 에디션은 에디터 툴이 없어 엑셀 → 텍스트 변환을 제공하지 않습니다. 엑셀에서 "탭으로 분리된 텍스트"로 저장하면 그대로 쓸 수 있습니다.