SDK 설정

GS2-SDK 를 Unity, Unreal Engine, Godot 에 설치하기

이 섹션에서는 Game Engine 용 SDK인 GS2 SDK for Unity, GS2 SDK for Unreal Engine 5, GS2 SDK for Godot 의 설치 절차에 대해 자세히 설명합니다.

GS2 SDK for Unity 설치 절차

위 링크에서 UnityPackage 형식의 설치 프로그램을 다운로드합니다.

새로 Unity 프로젝트를 생성하거나 기존 Unity 프로젝트를 준비하여 Unity Editor 에서 엽니다.

메뉴의 『Assets > Import Package > Custum Packages…』 에서 gs2-unity-installer_2024.4.1.unitypackage 파일을 임포트합니다.

Unity Editor 메뉴에서 『Window > Game Server Services > SDK Installer』 를 선택합니다.

SDK 설치 프로그램 창이 표시됩니다. 『Install』 을 선택합니다.

설치가 완료되면 프로젝트의 『Packages』에 SDK가 설치되며, Package Manager에서 설치되었는지 확인할 수 있습니다.

GS2 SDK for Unity 는 GS2-CSharp-SDK 와 GS2 SDK for Unity 로 구성되어 있습니다.

설치 완료 후 정상적으로 동작하지 않는 경우, Unity Editor 를 한 번 재시작해 보시기 바랍니다.

Unity Editor 메뉴에서 『Window > Game Server Services > UIKit for Unity Installer』 를 선택합니다.

설치가 완료되면 프로젝트의 『Packages』에 SDK가 설치되며, Package Manager에서 설치되었는지 확인할 수 있습니다.

설치 완료 후 정상적으로 동작하지 않는 경우, Unity Editor 를 한 번 재시작해 보시기 바랍니다.

새로 Unreal 프로젝트를 생성하거나 기존 Unreal 프로젝트를 준비합니다.

또는 Zip 형식으로 다운로드하여 임의의 폴더에 압축을 풉니다.

소스 코드 일체를 Unreal 프로젝트에 복사합니다.

Unreal 프로젝트 내의 다음 폴더에 배치해 주세요.

(Unreal 프로젝트)/Plugins/Gs2Plugin

Plugins 폴더가 존재하지 않는 경우 새로 생성해 주세요.
Plugins 폴더 내에 Gs2Plugin 폴더를 생성하고, 그 안에 다운로드한 파일 일체를 복사합니다.

Unreal Editor 에서 uproject 파일을 실행합니다.

플러그인 창을 열고 GS2 플러그인에 체크하여 활성화합니다.
Unreal Editor 를 재시작해 주세요.

GS2 플러그인의 빌드를 확인하는 대화 상자가 표시되면 「예」 를 선택합니다.

환경에 따라 다르지만 빌드에는 상당한 시간이 걸립니다.
플러그인 빌드에 성공하면 Unreal Editor가 실행됩니다.

이상으로 설치가 완료되었습니다.

Unreal Engine 소스 코드를 Github 또는 Perforce 에서 가져와 엔진을 빌드하고 있는 환경에 엔진 플러그인으로 설치할 수 있습니다.

또는 Zip 형식으로 다운로드하여 임의의 폴더에 압축을 풉니다.

Unreal Engine 소스 코드 내에 다음 폴더를 생성하고, 폴더 안에 다운로드한 소스 코드 일체를 복사해 주세요.

(Unreal Engine 소스 코드)/Engine/Plugins/Gs2Plugin

GenerateProjectFiles.bat 를 실행하여 프로젝트 파일을 업데이트합니다.

UE5.sln 파일을 열고 Unreal Engine 을 빌드합니다.
빌드가 완료되면 UnrealEditor 를 실행하고, GS2 플러그인을 활성화한 후 UnrealEditor 를 재시작해 주세요.

이상으로 설치가 완료되었습니다.

GS2 SDK for Godot 는 Godot 4(GDScript)용 SDK 입니다.

GitHub의 GS2 SDK for Godot 저장소 에서 ZIP 파일을 다운로드합니다.

다운로드한 ZIP 파일을 임의의 폴더에 압축을 풉니다.

압축을 푼 파일에 포함된 addons/gs2 폴더를 Godot 프로젝트로 복사합니다.

Godot 프로젝트 내의 배치 위치는 다음과 같습니다.

(Godot 프로젝트)/addons/gs2

addons 폴더가 존재하지 않는 경우 새로 생성해 주세요. Godot Editor 에서 프로젝트를 열고 FileSystem 독에 res://addons/gs2/ 가 표시되면 설치가 완료된 것입니다.