Unity Google Sheet
UGS Gitbook Guide Document

What is UGS?

UGS는 구글 스프레드 시트를 이용하여 게임 데이터의 데이터베이스를 디자인하거나, 게임의 Localization(현지화)를 매우 쉽고 효과적이게 할 수 있는 유용한 도구입니다.

Live / Local Load, Live Save 기능이 제공됩니다.

구글 스프레드시트에서 바꾼 값을 게임을 다시 빌드하지 않고도 구글 시트의 데이터를 Load 하거나 Save 할 수 있습니다. 스프레드시트 내 수정사항을 게임에 즉시 적용할 수 있으므로 게임 디자인 타임을 획기적으로 단축시킬 수 있는 강력한 도구입니다.
에디터 모드, 플레이 모드, Builded Runtime 에서 모두 동작합니다. 단, Live Load&Save 기능에는 구글 API 호출 제한횟수가 있다는것을 주의해야합니다. 그렇기때문에 UGS에는 Local Load기능이 포함되어있으며 이 경우 인터넷 연결 필요없이 로컬에서 데이터를 로드할 수 있습니다. 일반적으로 당신이 스토어에 앱을 게시하게 되는 상황에서는 Local Load를 사용해야합니다. 자세한건 문서를 확인하십시오.

Custom Class/Enum를 시트에서 사용할 수 있습니다!

int나 float, string, array같은 Primitive뿐만 아니라, 당신이 원하는 어떠한 클래스나 구조체, Enum 타입을 구글 시트 내에서 사용할 수 있습니다. 당신이 직접
정의한 class나 struct 혹은 enum을 구글 시트에서 관리하고 싶다면 당신에게 UGS는 좋은 선택이 될것입니다! Use CustomType Use EnumType

Google Drive GUI 를 제공합니다!

윈도우 폴더 탐색기와 비슷한 구글 드라이브 폴더 탐색기 GUI를 제공하기 때문에 유니티에서 구글드라이브에 즉시 엑세스 가능하므로 개발자에게 편의를 제공합니다.

코드 제네레이터를 제공합니다!

코드 제네레이터를 사용하면, 버튼 한번으로 로컬에 구글시트 데이터를 다운로드하여 캐싱하고, 캐싱한 데이터를 쉽게 불러올 수 있는 C# 코드를 자동으로 생성할 수 있습니다. 개발자는 단순히 생성된 코드를 사용하면 되기때문에 귀찮은 코드를 작성 할 필요가 없습니다!

UGS는 모든 C#환경 (Console, WPF .. ETC) 에서또 사용 가능합니다.

UGS는 유니티 뿐만 아니라, WPF, Console 등의 C# 환경에서도 사용 가능한 범용 라이브러리입니다. 개발자 입장에서는 UGS를 다양한 프로젝트에 적용할 수 있고, 유니티 클라이언트 사이드 뿐만 아니라 게임 서버 사이드 혹은, C# 어플리케이션을 개발할때에도 사용 할 수 있으므로 매우 매력적으로 다가옵니다. WPF, Console에서 사용할 수 있는 버전은 무료로 오픈 소스로 제공됩니다.

모든 플랫폼에서 사용 가능합니다.

UGS는 외부 종속성이 Newtonsoft.Json 외에 존재하지 않으므로, 종속성 문제에 있어서 자유롭습니다. 또한, WebGL, Linux, Windows, Android(Il2cpp/AOT), iOS, Xbox,Ps4와 같은 모든 플랫폼을 지원합니다..
불편사항 접수나 아이디어는 UGS의 오픈소스버전 깃 Issue에 등록합니다. 필자는 해당 프로젝트 개선에 관심이 많으니 적극적인 아이디어 제시를 부탁드립니다.

요구사항

  • 유니티 2018.3 이상의 버전이 필요합니다.

자주묻는 질문 (FAQ)

Q: 플레이모드, 에디터, 런타임 모두 동작합니까? A: 네, 플레이모드가 아닌 상황에서도, 런타임에서도 제약없이 단일 API로 모두 동작합니다.UnityGoogleSheet는 런타임에서도 데이터를 가져올 수 있게 설계했습니다. 이는 개발자의 개발 편리성을 극대화시켜줍니다. https://youtu.be/D6nd-aNb
Q: 플레이모드 혹은 빌드된 앱에서 수정한 데이터를 실시간으로 로드/리로드할 수 있습니까? A: 네, 가능합니다. 런타임에 구글시트에서 데이터 불러오기 문서를 참고하십시오.
Q: 내 게임은 인터넷 연결이 필요없는 게임입니다. 인터넷 없이도 사용 가능합니까? A: 네, 가능합니다. Local Data Load 일반적으로 이 방법을 사용해야만 합니다.
Q: 어떤 플랫폼을 지원합니까? A: 예외 없이, 유니티로 빌드 가능한 모든 플랫폼을 지원합니다.
Q: 구글시트가 아닌 엑셀을 대신 사용할 수 있습니까? A: 아니오. UnityGoogleSheet 는 구글 시트로만 연동됩니다. 추후, Excel에 대한 계획은 있지만 예정에는 없습니다.
Q: 나는 내 게임 서버 및 외부 도구에서도 UGS를 사용하고 싶습니다. 유니티 종속성이 없는 개발환경 예) C# Console Porgram 등서도 사용 가능합니까? A: 네, 사용 가능합니다. Unity 종속성이 없는 버전은 오픈소스로 공개되어있습니다. Here
Last modified 1yr ago
Copy link
Outline
What is UGS?
Live / Local Load, Live Save 기능이 제공됩니다.
Custom Class/Enum를 시트에서 사용할 수 있습니다!
Google Drive GUI 를 제공합니다!
코드 제네레이터를 제공합니다!
UGS는 모든 C#환경 (Console, WPF .. ETC) 에서또 사용 가능합니다.
모든 플랫폼에서 사용 가능합니다.
요구사항
자주묻는 질문 (FAQ)