> For the complete documentation index, see [llms.txt](/ko/llms.txt)


# SDK 설치 참고 자료

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




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

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

## GS2 SDK for Unity 설치하기 {#unity}

[GS2 SDK for Unity Installer Version 2024.4.1](/ja/get_start/gs2-unity-installer_2024.4.1.unitypackage)

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

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

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

<img src='/ja/get_start/sdk/unity_1.png' width='40%'>

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

<img src='/ja/get_start/sdk/unity_2.png' width='40%'>

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

<img src='/ja/get_start/sdk/unity_3.png' width='50%'><br>

<img src='/ja/get_start/sdk/unity_4.png' width='50%'>

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

<img src='/ja/get_start/sdk/unity_5.png' width='60%'>

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

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

### GS2 UIKit for Unity 설치하기 {#uikit}

<img src='/ja/get_start/sdk/unity_6.png' width='40%'>

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

<img src='/ja/get_start/sdk/unity_7.png' width='50%'><br>

<img src='/ja/get_start/sdk/unity_8.png' width='50%'>

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

<img src='/ja/get_start/sdk/unity_9.png' width='60%'>

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

## GS2 SDK for Unreal Engine 5 설치하기

### 프로젝트 플러그인으로 설치하기 {#ue-project}

**새 Unreal 프로젝트를 만들거나 기존 프로젝트를 준비합니다.**
<img src='/ja/get_start/sdk/ue_1.png' width='60%'>

**[GitHub의 GS2 SDK for Unreal Engine 5 저장소](https://github.com/gs2io/gs2-sdk-for-ue5)를 복제합니다.**

<img src='/ja/get_start/sdk/ue_2.png' width='30%'>

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

<img src='/ja/get_start/sdk/ue_3.png' width='30%'>

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

<img src='/ja/get_start/sdk/ue_4.png' width='100%'>

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

```
(Unreal 프로젝트)/Plugins/Gs2Plugin
```

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

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

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

<img src='/ja/get_start/sdk/ue_5.png' width='60%'>

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

<img src='/ja/get_start/sdk/ue_6.png' width='35%'>

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

설치가 완료되었습니다.

### 엔진 플러그인으로 설치하기 {#ue-engine}

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

**[GitHub의 GS2 SDK for Unreal Engine 5 저장소](https://github.com/gs2io/gs2-sdk-for-ue5)를 복제합니다.**

<img src='/ja/get_start/sdk/ue_2.png' width='30%'>

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

<img src='/ja/get_start/sdk/ue_3.png' width='30%'>

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

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

<img src='/ja/get_start/sdk/ue_7.png' width='90%'>

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

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

<img src='/ja/get_start/sdk/ue_8.png' width='60%'>

설치가 완료되었습니다.

## GS2 SDK for Godot 설치하기 {#godot}

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

**[GitHub의 GS2 SDK for Godot 최신 릴리스](https://github.com/gs2io/gs2-sdk-for-godot/releases/latest)의 Assets에서 Source code (zip)을 다운로드합니다.**

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

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

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

```text
(Godot 프로젝트)/addons/gs2
```

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

### Realtime 규칙 컴파일러 받기 {#realtime-compiler}

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

| 파일 | OS |
|---|---|
| `gs2-realtime-compiler-win-x64.zip` | Windows（x64） |
| `gs2-realtime-compiler-osx-arm64.zip` | macOS(Apple Silicon) |
| `gs2-realtime-compiler-osx-x64.zip` | macOS（Intel） |
| `gs2-realtime-compiler-linux-x64.zip` | Linux（x64） |

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

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




- [Unreal Engine·Godot 로그인 예제](/ko/get_start/sdk/login/)