유니티엑셀로더

UnityExcelLoader는 Unity 프로젝트에서 Excel 파일을 ScriptableObject로 변환하는 도구입니다.

설치

이 패키지를 설치하려면 Packages/manifest.json 파일에 다음 의존성을 추가하세요:

{
  "dependencies": {
    "com.piraxis2.unityexcelloader": https://github.com/piraxis2/UnityExcelLoader.git
  }
}

사용법

엑셀 파일을 ScriptableObject로 변환

1. Unity 에디터에서 엑셀 파일을 프로젝트에 추가합니다.
2. 엑셀 파일을 우클릭하고 Assets/Create/UnityExcelLoader/ExcelScript 메뉴를 선택합니다.
3. 저장할 폴더를 선택하면, 엑셀 파일에 대응하는 ScriptableObject와 Entity 클래스가 생성됩니다.
4. 참고: 첫 번째 행이나 열에 #가 포함되어 있으면 해당 행이나 열의 데이터는 생성되지 않습니다.

생성된 ScriptableObject 사용

1. 생성된 ScriptableObject를 인스펙터에서 확인할 수 있습니다.
2. ScriptableObject의 데이터를 사용하여 게임 로직을 구현할 수 있습니다.

커스텀 메소드 추가

생성된 ScriptableObject와 Entity 클래스에는 개발자가 사용할 수 있는 커스텀 메소드 영역이 있습니다. 이 영역은 //MethodsStart와 //MethodsEnd 주석 사이에 위치하며, 이 주석 사이에 메소드를 추가할 수 있습니다. 예를 들어, Sample 클래스에 커스텀 메소드를 추가하려면 다음과 같이 작성할 수 있습니다:

using System;
using System.Collections;
using System.Collections.Generic;
using UnityEngine;
using UnityExcelLoader.Runtime;

namespace UnityExcelLoader
{
    [ExcelScriptableObject]
    public class Sample : ScriptableObject
    {
        public List<Sample_Entity> Data;

        //DoNotRemove Methods Start End Annotation
        //MethodsStart
        public void PrintData()
        {
            foreach (var entity in Data)
            {
                Debug.Log($"Id: {entity.Id}, Name: {entity.Name}");
            }
        }
        //MethodsEnd
    }
}

예제

Sample ScriptableObject

Sample는 Excel 파일에서 생성된 ScriptableObject의 예제입니다.

using System;
using System.Collections;
using System.Collections.Generic;
using UnityEngine;
using UnityExcelLoader.Runtime;

namespace UnityExcelLoader
{
    [ExcelScriptableObject]
    public class Sample : ScriptableObject
    {
        public List<Sample_Entity> Data;

        //DoNotRemove Methods Start End Annotation
        //MethodsStart
        //MethodsEnd
    }
}

Sample_Entity 클래스

Sample_Entity는 Sample ScriptableObject의 데이터 엔티티 클래스입니다.

using System;
using System.Collections.Generic;
using UnityEngine;

namespace UnityExcelLoader
{
    [Serializable]
    public class Sample_Entity
    {
        public int Id;
        public string Name;
        public float Chance;
        public bool IsUse;

        //DoNotRemove Methods Start End Annotation
        //MethodsStart
        //MethodsEnd
    }
}