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

# 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 설치 절차

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

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

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

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

<img src='unity_1.png' width='40%'>

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

<img src='unity_2.png' width='40%'>

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

<img src='unity_3.png' width='50%'><br>

<img src='unity_4.png' width='50%'>

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

<img src='unity_5.png' width='60%'>

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

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

### GS2 UIKit for Unity 설치 절차

<img src='unity_6.png' width='40%'>

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

<img src='unity_7.png' width='50%'><br>

<img src='unity_8.png' width='50%'>

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

<img src='unity_9.png' width='60%'>

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

## GS2 SDK for Unreal Engine 5 설치 절차

### 프로젝트 플러그인으로 설치

**새로 Unreal 프로젝트를 생성하거나 기존 Unreal 프로젝트를 준비합니다.**
<img src='ue_1.png' width='60%'>

**[GitHub의 GS2 SDK for Unreal Engine 5 저장소](https://github.com/gs2io/gs2-sdk-for-ue5) 에서 소스 코드를 Clone합니다.**

<img src='ue_2.png' width='30%'>

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

<img src='ue_3.png' width='30%'>

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

<img src='ue_4.png' width='100%'>

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

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

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

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

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

<img src='ue_5.png' width='60%'>

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

<img src='ue_6.png' width='35%'>

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

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

### 엔진 플러그인으로 설치

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

**[GitHub의 GS2 SDK for Unreal Engine 5 저장소](https://github.com/gs2io/gs2-sdk-for-ue5) 에서 소스 코드를 Clone합니다.**

<img src='ue_2.png' width='30%'>

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

<img src='ue_3.png' width='30%'>

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

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

<img src='ue_7.png' width='90%'>

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

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

<img src='ue_8.png' width='60%'>

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

## GS2 SDK for Godot 설치 절차

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

**[GitHub의 GS2 SDK for Godot 저장소](https://github.com/gs2io/gs2-sdk-for-godot) 에서 ZIP 파일을 다운로드합니다.**

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

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

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

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

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