SDK 설치 참고 자료

게임 엔진별 SDK 설치 방법을 정리한 참고 자료입니다. Unity에서 순서대로 만들어 보려면 모험 게임 개발 환경 준비하기부터 시작합니다.

Unreal Engine 5와 Godot의 로그인 예제는 계정 생성과 로그인 코드에서 확인할 수 있습니다.

GS2 SDK for Unity 설치하기

GS2 SDK for Unity Installer Version 2024.4.1

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

새 Unity 프로젝트를 만들거나 기존 프로젝트를 Unity Editor에서 엽니다.

Assets > Import Package > Custom Package…에서 gs2-unity-installer_2024.4.1.unitypackage를 임포트합니다.

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

SDK Installer 창에서 Install을 누릅니다.

설치가 끝나면 프로젝트의 Packages에 SDK가 추가됩니다. Package Manager에서도 설치 여부를 확인할 수 있습니다.

Unity SDK는 GS2-CSharp-SDK와 GS2 SDK for Unity로 구성됩니다.

설치 후 정상적으로 동작하지 않으면 Unity Editor를 한 번 재시작합니다.

GS2 UIKit for Unity 설치하기

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

설치가 끝나면 프로젝트의 Packages에 SDK가 추가됩니다. Package Manager에서도 설치 여부를 확인할 수 있습니다.

설치 후 정상적으로 동작하지 않으면 Unity Editor를 한 번 재시작합니다.

GS2 SDK for Unreal Engine 5 설치하기

프로젝트 플러그인으로 설치하기

새 Unreal 프로젝트를 만들거나 기존 프로젝트를 준비합니다.

GitHub의 GS2 SDK for Unreal Engine 5 저장소를 복제합니다.

또는 ZIP으로 다운로드해 원하는 폴더에 압축을 풉니다.

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

Unreal 프로젝트 안의 다음 폴더에 넣습니다.

(Unreal 프로젝트)/Plugins/Gs2Plugin

Plugins 폴더가 없다면 만듭니다.
Plugins 안에 Gs2Plugin 폴더를 만들고 다운로드한 파일 전체를 복사합니다.

Unreal Editor에서 uproject 파일을 엽니다.

Plugins 창을 열고 GS2 플러그인을 활성화합니다.
Unreal Editor를 재시작합니다.

GS2 플러그인 빌드를 확인하는 창이 나타나면 Yes를 선택합니다.

환경에 따라 빌드에 시간이 걸릴 수 있습니다.
플러그인 빌드가 성공하면 Unreal Editor가 시작됩니다.

설치가 완료되었습니다.

엔진 플러그인으로 설치하기

GitHub나 Perforce에서 받은 소스로 Unreal Engine을 빌드하는 환경에서는 SDK를 엔진 플러그인으로 설치할 수 있습니다.

GitHub의 GS2 SDK for Unreal Engine 5 저장소를 복제합니다.

또는 ZIP으로 다운로드해 원하는 폴더에 압축을 풉니다.

Unreal Engine 소스 안에 다음 폴더를 만들고 다운로드한 소스 파일 전체를 복사합니다.

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

GenerateProjectFiles.bat를 실행해 프로젝트 파일을 갱신합니다.

UE5.sln을 열고 Unreal Engine을 빌드합니다.
빌드가 끝나면 Unreal Editor를 실행해 GS2 플러그인을 활성화하고 에디터를 재시작합니다.

설치가 완료되었습니다.

GS2 SDK for Godot 설치하기

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

GitHub의 GS2 SDK for Godot 최신 릴리스의 Assets에서 Source code (zip)을 다운로드합니다.

다운로드한 ZIP을 원하는 폴더에 압축 해제합니다.

압축 해제한 파일의 addons/gs2 폴더를 Godot 프로젝트에 복사합니다.

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

(Godot 프로젝트)/addons/gs2

addons 폴더가 없다면 만듭니다. Godot Editor에서 프로젝트를 엽니다. FileSystem 독에 res://addons/gs2/가 보이면 설치가 완료된 것입니다.

Realtime 규칙 컴파일러 받기

GS2-Realtime 규칙을 GDScript로 작성할 때는 Realtime 규칙 컴파일러(gs2-realtime-compiler)로 빌드합니다. 컴파일러는 SDK와 같은 릴리스의 Assets에서 배포합니다.

운영체제에 맞는 ZIP을 압축 해제하고 Godot 에디터 설정의 gs2/realtime/compiler_path에 실행 파일 경로를 지정합니다. SDK를 업데이트할 때는 같은 릴리스의 컴파일러로 교체합니다.

규칙 작성과 빌드 방법은 GDScript로 규칙 작성하기를 참고하세요.