Unity에서 사용했던 TableGenerator를 언리얼의 DataTable 시스템을 기반으로 변경하고, 데이터 자동화를 위한 플러그인을 개발한 내용을 정리했다

Unity에서 사용했던 방식

• 엑셀 파일을 기반으로 데이터 관리 + .byte 포맷 활용
• Json/XML 대신 .byte 포맷을 사용하여 최적화

Unity에서 데이터 처리 과정

Unity에서 .byte 포멧을 사용한 이유

Unreal DataTable 활용의 장점

• CSV, JSON 파일을 바로 읽어 데이터 관리가 가능
• 블루프린트에서도 손쉽게 활용 가능

Unreal에서 사용한 데이터 테이블 형식

• Unreal에서 사용한 데이터 테이블 형식 (CSV 예시)

  tableNo	itemID	Amount
  int	int	int
  1	101	10

• CSV 파일 → DataTable 변환 과정

  

TableGenerator 는 CSV 데이터를 자동으로 DataTable로 변환하고, C++ 클래스를 자동 생성하는 플러그인 이다.

TableGenerator 적용 과정

• CSV 데이터 → DataTable 자동 변환

• DataTable을 기반으로 C++ 코드 자동 생성

• TableGenerator 플러그인 구조

  

Make Data Table(자동 생성 시스템)

• CSV 파일을 기반으로 자동화된 데이터 테이블 생성

• 각 컬럼을 분석하여 C++ 구조체 (Struct) 또는 Enum을 자동 생성

• 파이썬 코드 일부(CSV→Enum 변환)

  import csv
  
  def generate_enum_from_csv(csv_file):
      with open(csv_file, newline='') as csvfile:
          reader = csv.reader(csvfile)
          for row in reader:
              print(f"enum {row[0]} = {row[1]};")

Import CSV Data(데이터 직렬화 & 자동 로드)

• DataTable에서 데이터를 가져와 .byte 파일로 저장
• .byte 파일을 로드할 수 있도록 패키징 설정 적용
• 패키징 적용 방법
  • 프로젝트 세팅 → 패키징 → 고급 → 패키지 추가 비에셋 디렉터리에 .byte 파일이 저장된 경로 등록 필요

TableGenerator를 구현하는 과정에서, Unreal5 최신 버전의 직렬화 방식 변경으로 인해 기존 FAchive 기반 직렬화 방식에서 예상치 못한 문제가 발생했다.

발생한 오류 메시지

FArchive does not support FObjectPtr serialization. Use FArchiveUObject instead.

문제 원인 분석

• .byte 데이터를 저장하는 과정에서, FObjectPtr 타입의 직렬화 시 오류 발생

• Unreal 5 에서는 기존 FArchive를 통한FObjectPtr 직렬화가 지원되지 않음

• 해결 방법 : FObjectAndNameAsStringProxyArchive 적용

  TArray<uint8> BinaryData;
  FMemoryWriter MemoryWriter(BinaryData, true);
  FObjectAndNameAsStringProxyArchive Ar(MemoryWriter, false);