본문 바로가기

데이터 테이블과 블루프린트 연동

구조체 기반 데이터 테이블을 만들고 Get Data Table Row로 행을 찾아, 찾았을 때와 못 찾았을 때를 나누어 처리합니다.

구조체와 열거형의 기본 이해에서는 기본 검의 이름과 공격력을 Make F_ItemData 노드에 직접 적었습니다. 아이템이 하나일 때는 괜찮지만, 물약과 방패가 늘어날 때마다 Make 노드를 복사하면 숫자가 그래프 곳곳에 흩어집니다. 기획자가 공격력 하나를 고치려 해도 그래프를 열고 노드를 건드려야 하므로, 로직을 실수로 바꿀 위험도 생깁니다.

이 글을 읽고 나면 다음을 할 수 있습니다.

  • F_ItemData를 행 구조체로 쓰는 데이터 테이블 DT_Items를 만들고 행을 채웁니다.
  • Get Data Table Row로 행 이름에 맞는 아이템을 읽고, Row Found와 Row Not Found를 나누어 처리합니다.
  • 조회 키(Name)와 화면에 보여 줄 이름(Text)을 구별합니다.

앞 글에서 만든 BP_ItemPedestal과 F_ItemData, E_ItemType을 그대로 씁니다. 1장에서 만든 Third Person 템플릿 프로젝트의 기본 레벨에 BP_ItemPedestal이 하나 놓여 있는 상태에서 시작합니다.


행과 열로 정리한 데이터 테이블

데이터 테이블(Data Table)은 정형 데이터를 스프레드시트처럼 행(row)과 열(column)로 정리해 두는 에셋입니다. 행 하나가 기본 검이나 체력 회복 물약 같은 항목 하나이고, 열 하나가 이름이나 공격력 같은 속성 하나입니다. 각 행에는 고유한 행 이름(Row Name)이 붙고, 블루프린트는 이 이름을 키로 삼아 행을 찾습니다.

열은 마음대로 만드는 것이 아니라 구조체가 정합니다. 테이블을 만들 때 행 구조체(Row Structure)로 F_ItemData를 지정하면, 그 멤버 하나하나가 열이 됩니다. 그래서 값은 테이블에 두고, 그래프는 행 이름으로 찾아 읽기만 하게 됩니다.


DT_Items 만들고 행 채우기

먼저 F_ItemData에 열로 쓸 멤버가 모두 있는지 확인합니다. 앞 글의 4번 문제를 풀었다면 이미 있고, 아니라면 Description과 ItemMesh를 지금 추가합니다.

멤버타입
ItemNameText
AttackPowerInteger
WeightFloat
ItemTypeE_ItemType
DescriptionText
ItemMeshStatic Mesh (Object Reference)
  1. Ch5 폴더의 빈 곳을 오른쪽 클릭하고 Miscellaneous 하위 메뉴의 Data Table을 고릅니다.
  2. 행 구조체를 고르는 창에서 F_ItemData를 고르고, 에셋 이름을 DT_Items로 짓습니다. 데이터 테이블에는 흔히 DT_ 접두사를 붙입니다.
  3. DT_Items를 더블클릭해 데이터 테이블 에디터를 열고, 툴바의 Add로 행을 두 개 추가합니다.
  4. 행 이름과 값을 다음과 같이 채우고 저장합니다. 메시는 Starter Content의 도형을 예로 들었고, 없으면 아무 메시나 골라도 됩니다.
행 이름ItemNameAttackPowerWeightItemTypeDescriptionItemMesh
Sword_Basic기본 검102.5Weapon평범한 검입니다.Shape_Cylinder
Potion_Health체력 회복 물약00.1Consumable체력을 회복시켜 줍니다.Shape_Sphere

여기까지 하면 데이터 테이블 에디터 위쪽 표에 두 행이 보이고, 행을 고르면 아래쪽 행 편집기에 그 행의 값이 나옵니다.

다를 때먼저 볼 곳
행 편집기에 ItemType이나 Description 칸이 없음F_ItemData에 멤버를 추가한 뒤 구조체를 저장했는지
행 이름이 NewRow로 남음표에서 행 이름 칸을 더블클릭해 이름을 바꿨는지

Get Data Table Row로 한 행 읽기

이제 받침대가 그래프에 적힌 값 대신 테이블의 행을 읽게 합니다. 받침대마다 다른 아이템을 올릴 수 있도록, 어떤 행을 읽을지는 변수로 둡니다.

  1. BP_ItemPedestal에 Name 타입 변수 ItemRowName을 만들고 Instance Editable을 켭니다. Compile한 뒤 기본값을 Sword_Basic으로 정합니다.
  2. Event BeginPlay와 Set CurrentItem 사이의 실행 선을 끊고, Make F_ItemData 노드를 지웁니다.
  3. 빈 곳을 오른쪽 클릭해 Get Data Table Row를 추가하고, Data Table 핀에서 DT_Items를 고릅니다. Row Name 핀에는 ItemRowName의 Get 노드를 연결합니다.
  4. 다음처럼 잇습니다. Set CurrentItem 뒤의 Print String과 Switch는 앞 글에서 만든 그대로 둡니다.
Event BeginPlay
  └─▶ Get Data Table Row (Data Table: DT_Items, Row Name ◀─ ItemRowName)
        ├─ Row Found ─▶ Set CurrentItem ◀─ Out Row
        │                 └─▶ Print String "기본 검 / 공격력 10" 형식 (앞 글의 Append 그대로)
        │                       └─▶ … Switch on E_ItemType
        └─ Row Not Found ─▶ Print String
                              ◀─ Append(A: "행 없음: ", B ◀─ ItemRowName)

Get Data Table Row는 테이블 하나와 행 이름 하나를 받아, 그 행을 찾았는지에 따라 실행을 둘로 나눕니다. 찾았으면 Row Found로 나가고, Out Row 핀이 그 행의 F_ItemData 값을 내놓습니다. 못 찾았으면 Row Not Found로 나갑니다.

Play하기 전에, 화면에 무엇이 나올지 먼저 예상해 보세요. 앞 글에서 넣은 Set Members로 공격력을 3 깎는 부분이 남아 있다면 그것도 함께 따져 봅니다.

결과 확인하기

기본 검 / 공격력 10과 무기 아이템이 나옵니다. 앞 글의 연습을 그대로 두었다면 그 사이에 7과 같은 줄도 함께 보입니다. 값이 그래프가 아니라 DT_Items의 Sword_Basic 행에서 왔다는 것은, 테이블에서 AttackPower를 12로 바꾸고 다시 Play하면 공격력 12로 바뀌는 것으로 확인할 수 있습니다. 확인한 뒤 AttackPower를 10으로 되돌려 다음 실험의 예상값과 맞춥니다.

행 조회 결과에 따른 적용 경로

DT_Items/Sword_Basic 조회 요청→Found/NotFound 결과→성공 시 Out Row 적용 또는 실패 정책으로 이어지는 실행 경로입니다.

LOOKUP · FOUND / NOT FOUND

행을 찾은 경로에서만 Out Row를 적용합니다

Get Data Table Row에 DT_Items와 조회 키 Sword_Basic(Name)을 연결합니다. 한 조회의 실행 결과는 Row Found 또는 Row Not Found로 나뉩니다.

DataTable 조회의 두 실행 결과DT_Items와 Name 키 Sword_Basic으로 조회합니다. Row Found에서만 행 데이터를 적용하고 Row Not Found는 오류 또는 기본값 경로로 갑니다.Get Data Table RowDT_ItemsSword_Basic (Name)Row FoundOut Row 적용Row Not Found오류·기본값 처리
DataTable 조회의 두 실행 결과DT_Items와 Name 키 Sword_Basic으로 조회합니다. Row Found에서만 행 데이터를 적용하고 Row Not Found는 오류 또는 기본값 경로로 갑니다.Get Data Table RowDT_ItemsSword_BasicRow FoundOut Row 적용Row Not Found오류·기본값 처리

Get Data Table Row의 실행 결과입니다. Out Row를 사용하는 처리는 Row Found 쪽에만 연결합니다.

조회 키와 표시 이름을 구분합니다

Row Name은 Name 타입의 키입니다. 지역화 Text와 구별하고, 대소문자만 다른 행 이름으로 구분하지 않습니다. 실패 경로에는 오류 안내·취소·기본값 중 정한 정책을 연결합니다.

이 예의 조건

  • 본문에 제시된 사례의 입력·조건을 사용합니다. 설명용 수치나 독립 비교 경로는 각 단계에 표시합니다.
  • 현재 상태·값과 전환 근거 칸은 모든 단계에서 같은 자리에 있습니다.
예의 값과 변화
관찰·상황값·보충 정보변화·이유
Row 요청

DT_Items에서 Sword_Basic을 조회합니다.

  • 테이블: DT_Items
  • 키: Sword_Basic
  • 키와 Row 구조를 맞춘 요청이 필요합니다.
성공 경로

Found에서만 Out Row를 유효 결과로 취급합니다.

  • Found: Out Row 적용 가능
  • NotFound: 실패 정책
  • 조회 노드의 출력 데이터와 성공 실행 핀을 함께 검사합니다.
값 적용

Row Found에서 Sword_Basic의 표시명 기본 검과 공격력 10을 읽습니다.

  • ItemName: 기본 검
  • AttackPower: 10
  • 실패 대안: Row Not Found · 임의 기본 Row 미적용
  • 조회 키 Sword_Basic과 표시 이름은 다른 값입니다. Row Found의 Out Row에서만 필드를 사용하며, 잘못된 키의 실패를 정상 아이템 획득으로 연결하지 않습니다.

행 조회 결과에 따른 적용 경로

DT_Items/Sword_Basic 조회 요청→Found/NotFound 결과→성공 시 Out Row 적용 또는 실패 정책으로 이어지는 실행 경로입니다.

LOOKUP · FOUND / NOT FOUND

행을 찾은 경로에서만 Out Row를 적용합니다

Get Data Table Row에 DT_Items와 조회 키 Sword_Basic(Name)을 연결합니다. 한 조회의 실행 결과는 Row Found 또는 Row Not Found로 나뉩니다.

DataTable 조회의 두 실행 결과DT_Items와 Name 키 Sword_Basic으로 조회합니다. Row Found에서만 행 데이터를 적용하고 Row Not Found는 오류 또는 기본값 경로로 갑니다.Get Data Table RowDT_ItemsSword_Basic (Name)Row FoundOut Row 적용Row Not Found오류·기본값 처리
DataTable 조회의 두 실행 결과DT_Items와 Name 키 Sword_Basic으로 조회합니다. Row Found에서만 행 데이터를 적용하고 Row Not Found는 오류 또는 기본값 경로로 갑니다.Get Data Table RowDT_ItemsSword_BasicRow FoundOut Row 적용Row Not Found오류·기본값 처리

Get Data Table Row의 실행 결과입니다. Out Row를 사용하는 처리는 Row Found 쪽에만 연결합니다.

조회 키와 표시 이름을 구분합니다

Row Name은 Name 타입의 키입니다. 지역화 Text와 구별하고, 대소문자만 다른 행 이름으로 구분하지 않습니다. 실패 경로에는 오류 안내·취소·기본값 중 정한 정책을 연결합니다.

이 예의 조건

  • 본문에 제시된 사례의 입력·조건을 사용합니다. 설명용 수치나 독립 비교 경로는 각 단계에 표시합니다.
  • 현재 상태·값과 전환 근거 칸은 모든 단계에서 같은 자리에 있습니다.
예의 값과 변화
관찰·상황값·보충 정보변화·이유
Row 요청

DT_Items에서 Sword_Basic을 조회합니다.

  • 테이블: DT_Items
  • 키: Sword_Basic
  • 키와 Row 구조를 맞춘 요청이 필요합니다.
성공 경로

Found에서만 Out Row를 유효 결과로 취급합니다.

  • Found: Out Row 적용 가능
  • NotFound: 실패 정책
  • 조회 노드의 출력 데이터와 성공 실행 핀을 함께 검사합니다.
값 적용

Row Found에서 Sword_Basic의 표시명 기본 검과 공격력 10을 읽습니다.

  • ItemName: 기본 검
  • AttackPower: 10
  • 실패 대안: Row Not Found · 임의 기본 Row 미적용
  • 조회 키 Sword_Basic과 표시 이름은 다른 값입니다. Row Found의 Out Row에서만 필드를 사용하며, 잘못된 키의 실패를 정상 아이템 획득으로 연결하지 않습니다.

그림은 방금 만든 조회를 세 단계로 따라갑니다. DT_Items에 Name 키 Sword_Basic으로 행을 요청하고, 한 번의 조회는 Row Found와 Row Not Found 가운데 한쪽으로만 나갑니다. Out Row를 적용하는 Set CurrentItem은 Row Found 쪽에만 있으므로, 표시 이름 기본 검과 공격력 10은 행을 찾았을 때만 읽힙니다.

다를 때먼저 볼 곳
행 없음: Sword_Basic이 나옴DT_Items의 행 이름 철자, Data Table 핀에 DT_Items를 골랐는지
Out Row를 Set CurrentItem에 연결할 수 없음Data Table 핀에 DT_Items를 골랐는지. 테이블이 정해져야 Out Row가 F_ItemData 타입이 됩니다
아무 문구도 나오지 않음Event BeginPlay에서 Get Data Table Row의 실행 입력까지 선이 이어졌는지

행을 못 찾으면 어떻게 될까

레벨의 받침대를 선택하고 디테일 패널에서 Item Row Name을 Sword_Basc로 바꿔 Play합니다. 테이블에 없는 이름이므로 Row Not Found로 나가 행 없음: Sword_Basc가 출력되고, CurrentItem은 바뀌지 않습니다. 실패 경로에 아무것도 연결하지 않으면 기존 값이 그대로 남고, 기본 아이템으로 바꾸고 싶다면 그 경로에 명시적인 Set을 두어야 합니다. 행을 못 찾았을 때의 Out Row를 찾은 행처럼 쓰지 않는 것이 이 노드를 쓰는 기본 규칙입니다.

이번에는 Item Row Name을 소문자 sword_basic으로 바꿉니다. 어느 핀으로 나갈지 먼저 예상해 보세요.

결과 확인하기

Row Found로 나가 기본 검 / 공격력 10이 출력됩니다. 행 이름은 Name 타입이고, Name은 대소문자를 구별하지 않고 비교하기 때문입니다. 그래서 Potion_Health와 potion_health처럼 대소문자만 다른 두 행 이름으로 서로 다른 아이템을 구분할 수는 없습니다.

확인했으면 Item Row Name을 Sword_Basic으로 되돌립니다.

조회 키와 표시 이름도 구별해야 합니다. ItemName의 기본 검은 화면에 보여 줄 Text이고, Sword_Basic은 행을 찾는 Name입니다. 표시 문구는 번역이나 기획 변경으로 자주 바뀌므로, 키로 쓰지 않고 잘 바뀌지 않는 행 이름을 따로 둡니다.


두 받침대에 다른 아이템 올리기

ItemRowName을 Instance Editable로 만든 덕분에, 같은 블루프린트로 다른 아이템을 보여 줄 수 있습니다.

  1. 레벨의 받침대를 Alt를 누른 채 끌어 하나 더 복제합니다.
  2. 새 받침대를 선택하고 디테일 패널에서 Item Row Name을 Potion_Health로 바꿉니다.
  3. 레벨을 저장하고 Play합니다.

여기까지 하면 화면에 기본 검 / 공격력 10과 무기 아이템, 체력 회복 물약 / 공격력 0과 소비 아이템이 함께 보입니다. 두 받침대의 BeginPlay 가운데 어느 쪽이 먼저 실행될지는 정해져 있지 않으므로, 줄의 순서는 다를 수 있습니다.

다를 때먼저 볼 곳
두 받침대 모두 기본 검을 출력함두 번째 받침대의 Item Row Name을 바꾼 뒤 레벨을 저장했는지
레벨 디테일 패널에 Item Row Name이 없음변수의 Instance Editable을 켜고 Compile했는지

더 깊이: CSV로 행 가져오기

행이 많다면 스프레드시트에서 작성한 CSV 파일을 가져올 수 있습니다. 콘텐츠 브라우저에서 CSV 파일을 임포트할 때 DataTable로 가져오고 행 타입으로 F_ItemData를 고르며, CSV의 첫 번째 열에는 행 이름이 들어가야 합니다. 임포트 옵션은 언리얼 엔진 공식 문서의 데이터 기반 게임플레이 요소에서 확인할 수 있습니다.


정리

  • 데이터 테이블은 정형 데이터를 행과 열로 정리하는 에셋이고, 열의 모양은 행 구조체가 정합니다.
  • 블루프린트는 Name 타입의 행 이름으로 행을 찾으며, Name은 대소문자를 구별하지 않고 비교합니다.
  • Get Data Table Row는 Row Found와 Row Not Found로 실행을 나누고, Out Row는 Row Found 경로에서만 씁니다.
  • 실패 경로에 아무것도 연결하지 않으면 기존 값이 남고, 기본값으로 바꾸려면 그 경로에 Set이 필요합니다.
  • 화면에 보여 줄 Text와 조회 키 Name은 역할이 다르므로 섞지 않습니다.

연습 문제

1. 없는 행을 찾았을 때의 공격력

받침대의 CurrentItem에는 클래스 기본값으로 AttackPower 7이 들어 있다고 합니다. Item Row Name을 테이블에 없는 Sword_Missing으로 바꿔 Play했습니다. 본문 그래프에서 조회가 끝난 뒤 CurrentItem의 공격력은 0일까요, 7일까요?

해설 보기

7이 유지됩니다. Sword_Missing은 테이블에 없으므로 Row Not Found로 나가고, 이 경로는 행 없음: Sword_Missing만 출력할 뿐 CurrentItem을 바꾸지 않습니다. Row Found 쪽의 Set CurrentItem은 실행되지 않습니다.

실패했을 때 0 같은 기본값으로 바꾸는 정책을 골랐다면, Row Not Found 경로에 명시적인 Set을 두어야 합니다.

2. 표시 이름으로 행을 찾는 코드 고치기

UI에서 플레이어가 고른 아이템의 ItemName 기본 검을 문자열로 바꾼 뒤 String To Name으로 변환해 Get Data Table Row에 넘겼더니 항상 Row Not Found로 나갑니다. 왜 그런지 설명하고 고치는 방법을 적어 보세요.

해설 보기

테이블에는 행 이름이 Sword_Basic인 행만 있고, 기본 검은 그 행의 ItemName 열에 들어 있는 표시 문구일 뿐 행 이름이 아니기 때문입니다.

UI가 아이템을 표시할 때 행 이름도 함께 들고 있다가, 선택이 일어나면 표시 문구가 아니라 그 행 이름을 조회 키로 넘기도록 고칩니다. 표시 문구는 언어마다 달라지므로 키로 쓰기에 알맞지 않습니다.

3. 테이블의 모든 아이템 이름 출력하기

받침대의 조회와 별도로, 테이블에 들어 있는 모든 아이템의 이름을 출력하는 그래프를 만들어 보세요.

  • DT_Items의 행을 모두 차례로 읽습니다. 행 이름을 그래프에 직접 적지 않습니다.
  • 행마다 ItemName을 한 줄씩 출력합니다.
  • 테이블에 행을 하나 추가하면 그래프를 고치지 않아도 출력이 한 줄 늘어납니다.

힌트: Get Data Table Row Names와 흐름 제어 노드 (분기, 루프) 사용법의 For Each Loop를 씁니다.

해설 보기

Get Data Table Row Names가 테이블의 행 이름 배열을 내놓고, For Each Loop가 그 배열을 하나씩 돌며 Get Data Table Row를 실행합니다. 받침대가 두 개면 두 번 출력되므로, 이 실험은 받침대를 하나만 남기고 합니다. 기존 BeginPlay의 조회 연결을 잠시 끊고 아래 전체 행 조회를 연결합니다.

Event BeginPlay
  └─▶ Get Data Table Row Names (Data Table: DT_Items)
        └─▶ For Each Loop (Array ◀─ Out Row Names)
              └─ Loop Body ─▶ Get Data Table Row (DT_Items, Row Name ◀─ Array Element)
                                └─ Row Found ─▶ Print String
                                                  ◀─ To String (Text) ◀─ Break F_ItemData(Out Row).ItemName

Play하면 기본 검과 체력 회복 물약이 한 줄씩 나옵니다. 테이블에 Shield_Wooden 행을 추가하고 다시 Play했을 때 그 행의 이름이 한 줄 더 나오면 완성입니다. 반복 안에서도 Out Row는 Row Found 뒤에서만 씁니다. 확인한 뒤 BeginPlay는 본문의 ItemRowName 한 행 조회로 다시 연결하고, 받침대의 Item Row Name도 Sword_Basic으로 되돌립니다.

다음 글 저장 및 로드 기본 구현에서는 받침대가 게임을 몇 번 실행했는지 세어, 껐다 켜도 그 숫자가 이어지도록 SaveGame 객체로 저장하고 불러옵니다.