> For the complete documentation index, see [llms.txt](https://docs.edgegap.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.edgegap.com/ko/unity/developer-tools.md).

# 개발자 도구

빠른 반복 작업과 자주 배포하는 멀티플레이어 게임 서버를 위해 만든 Unity용 Edgegap 개발자 도구입니다.

우리는 “성공적인 팀의 핵심은 빠른 반복과 빈번한 테스트”라는 간단한 신조로 이 도구들을 만듭니다. 개선할 기회가 보이면, 저희의 [커뮤니티 Discord](https://discord.gg/NgCnkHbsGp). 원활한 경험을 즐기시길 바랍니다. 🚀

{% hint style="info" %}
[실제 사례를 찾아보세요](https://docs.edgegap.com/ko/docs/sample-projects/unity-netcodes.md) 프로젝트 시작점으로 사용한 뒤 추가로 수정할 수 있습니다.
{% endhint %}

#### 시맨틱 버저닝

당사의 개발자 도구와 관리형 서비스는 공식 [시맨틱 버저닝](https://semver.org/), 어떤 업데이트가 ✅ 안전한지(마이너, 패치)와 어떤 업데이트에 ⚠️ 파괴적 변경(메이저)이 포함될 수 있는지를 나타냅니다.

**한 번 버전이 릴리스되면 절대 수정/변경되지 않습니다**.

{% hint style="warning" %}
**서비스 버전을 업그레이드하려면 - 중지, 편집, 재시작.** 빠른 재시작은 버전 변경 사항을 적용하지 않습니다.
{% endhint %}

## ⚡ 전용 서버 퀵스타트 플러그인

Unity 에디터에서 바로 전용 게임 서버를 빌드하고 클라우드에 배포하세요!

* [Dedicated Servers for Unity 플러그인 - 즉시 사용 가능한 솔루션, 소스 코드, 전체 릴리스 노트.](https://github.com/edgegap/buildtool-unity-plugin)

{% hint style="success" %}
이 플러그인은 무료 티어의 이용 약관에 따라 100% 무료로 제공됩니다.
{% endhint %}

2021.3+ 이후의 모든 Unity3D 장기 지원(LTS) 버전이 공식 지원됩니다.

이 플러그인에는 다음을 도와주는 기능이 포함되어 있습니다:

* Linux용 전용 서버를 빌드하고 컨테이너화하고,
* 서버의 Docker 이미지를 로컬에서 테스트하고,
* 서버를 Edgegap에 업로드하고 배포하세요.

{% hint style="info" %}
이 플러그인은 게임 동작을 전혀 수정하지 않으며, Edgegap 작업을 위한 편리한 개발 도구일 뿐입니다. 이 플러그인은 서버 빌드 준비 과정에서만 사용되므로 빌드에 포함되지 않습니다.
{% endhint %}

#### 설치

다음을 참조하세요 [공식 플러그인 저장소](https://github.com/edgegap/buildtool-unity-plugin) 설치에 대한 자세한 안내는

이 플러그인은 테스트되었으며, 모든 LTS 릴리스를 포함한 Unity 2021.2 이상, Unity 2023 및 Unity 6을 지원합니다.

{% embed url="<https://youtu.be/3a5veDyxpoE>" %}

<details>

<summary>Unity Linux 빌드 지원 모듈 설치</summary>

* Unity Hub를 사용하여 탭 선택 **설치합니다**, 액세스 **설정** 지역화된 인터넷 서비스 제공업체(ISP)가 일시적으로 사고를 해결하고 있을 수 있습니다, **모듈 추가** Edgegap 플랫폼에서 사용하려는 각 Unity 버전에 대해:

<figure><img src="https://1562312210-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsR0dHSFv9ymoC0DO5G8J%2Fuploads%2FylRG4r8orenZrw5ijjpJ%2Fimage.png?alt=media&amp;token=fb981825-8a15-4c07-9180-0f79a6a77a91" alt=""><figcaption></figcaption></figure>

* 아래로 스크롤하여 다음 Unity 모듈을 선택하고 설치하세요:
  * **Linux 빌드 지원 (IL2CPP),**
    * **Linux 빌드 지원 (Mono),**
    * **Linux 전용 서버 빌드 지원**

<figure><img src="https://1562312210-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsR0dHSFv9ymoC0DO5G8J%2Fuploads%2FuXtyqoLhBOk8CZJ4WdzA%2Fimage.png?alt=media&amp;token=19e956ed-a731-420d-b911-130c334794fc" alt=""><figcaption></figcaption></figure>

</details>

<details>

<summary><a href="https://www.docker.com/products/docker-desktop/">Docker Desktop(또는 Docker CLI) 설치</a></summary>

* [공식 소스에서 Docker Desktop을 설치하세요](https://www.docker.com/products/docker-desktop/) (계정이 필요하지 않습니다).
* 설치를 완료한 후 컴퓨터를 다시 시작하세요.

</details>

{% hint style="success" %}
참조: [Unity](https://docs.edgegap.com/ko/unity.md) 시작하려면, 그리고 플러그인 사용에 대한 자세한 지침은 여기에서 확인하세요.
{% endhint %}

<details>

<summary>문제 해결 및 FAQ</summary>

Unity 오류: `[패키지 관리자 창] 패키지 추가 오류: https://github.com/edgegap/buildtool-unity-plugin.git`

* git URL을 통해 플러그인을 추가하려면 Git 클라이언트가 설치되어 있어야 합니다 ([#installation](#installation "mention")).

***

Unity 오류: `Linux 빌드 지원 누락`

* 참조: [#usage-requirements](#usage-requirements "mention"), 아마도 Linux Build Support 모듈이 누락된 것입니다. 이는 Unity Hub를 통해 설치할 수 있습니다. 프로젝트와 동일한 Unity 버전을 선택했는지 확인하세요.

</details>

{% hint style="info" %}
도움이 필요하시면 [디스코드를 통해 문의해 주세요](https://discord.gg/MmJf8fWjnt). 실시간 게임 지원은 저희의 [티켓 시스템](https://edgegap.atlassian.net/servicedesk/customer/portal/3).
{% endhint %}

{% hint style="info" %}
**플러그인 개발자를 위해** - 사용자의 에디터에서 이 플러그인의 존재를 감지하고 싶다면, 컴파일러 지시문을 사용해 가능합니다 `#if EDGEGAP_PLUGIN_SERVERS {your code} #endif` .
{% endhint %}

## ⭐ 소프트웨어 개발 키트

Unity SDK에는 배포, 매치메이킹, 서버 브라우저를 위한 선택적 통합 유틸리티가 포함되어 있습니다. 이 플러그인은 Unity 버전 2021.3.0f1 이상을 공식 지원합니다.

{% hint style="info" %}
**Unity SDK의 최신 버전은 `3.5.6`**&#xC785;니다. 이 문서의 모든 예제는 최신 상태입니다.
{% endhint %}

{% hint style="success" %}
이 플러그인은 무료 티어 이용약관에 따라 100% 무료로 제공됩니다.
{% endhint %}

#### 요구 사항

<details>

<summary>Git 클라이언트를 설치합니다(예: <a href="https://git-scm.com/">git-scm</a>)</summary>

Unity에서 Unity 패키지를 자동으로 다운로드하고 설치하려면 Git 클라이언트가 필요합니다. 설치한 후에는 Git을 직접 사용할 필요가 없습니다.

</details>

#### 설치

1. Unity 프로젝트를 열고
2. 다음을 선택합니다. `Window > Package Management > Package Manager` ,
3. 아이콘을 클릭한 다음 :heavy\_plus\_sign: 아이콘을 선택합니다. `Add package from git URL...` ,
4. 메시지가 표시되면 SDK URL을 입력합니다.

{% code title="" collapsedlinecount="10" %}

```
https://github.com/edgegap/sdk-unity-sessions-matchmaker-server-browser.git
```

{% endcode %}

5. 다음을 클릭합니다. `Add`  설치가 완료될 때까지 기다립니다.

#### 샘플 가져오기

이 패키지에는 개별적으로 사용하도록 만들어진 여러 샘플이 포함되어 있습니다(샘플을 함께 사용하지 마세요).

#### 검증된 배포처

이 SDK의 공식 배포 채널은 여기뿐입니다. 검증되지 않은 출처를 신뢰하지 마세요!

#### 패키지 업데이트

Unity Package Manager에서 Edgegap SDK로 이동한 다음 `Update` .

{% hint style="warning" %}
**가져온 샘플은 자동으로 업데이트되지 않습니다!** 사용자 지정 속성 값을 백업하고, 현재 씬에서 사용 중인 샘플 스크립트를 삭제한 다음 샘플을 다시 가져오세요.
{% endhint %}

{% hint style="info" %}
일부 릴리스에는 호환성이 깨지는 변경 사항이 포함될 수 있습니다. 이러한 변경 사항이 포함되면 새 MAJOR 버전으로 표시됩니다.
{% endhint %}

#### v3으로 업데이트

이번 업데이트에는 새로운 [서버 브라우저](https://docs.edgegap.com/ko/unity/server-browser.md) 유틸리티와 예제가 다수 포함되어 있고, 매치메이킹 오류 처리가 개선되는 등 다양한 변경 사항이 있습니다. 전체 목록은 [릴리스 노트](https://docs.edgegap.com/ko/docs/release-notes.md) 에서 확인하세요.

{% hint style="warning" %}
Unity SDK v3 업데이트에는 호환성이 깨지는 변경 사항이 몇 가지 포함되어 있습니다. 통합을 꼼꼼히 다시 테스트하세요.
{% endhint %}

<details>

<summary>Unity SDK v3 호환성 파괴 변경 사항 - 범위, 영향 및 해결 방법</summary>

네임스페이스 `Edgegap.Matchmaking`:

* 병합된 메서드 `Client._Abandon -> Client.StopMatchmaking` .
  * 영향 낮음 - 대부분 사용자 지정 클라이언트 핸들러 구현에 해당합니다.
  * 해결 방법 - 다음 호출을 `_Abandon` 로 바꿉니다. `StopMatchmaking` 메서드로 바꿉니다.
* 병합된 이벤트 리스너 `onTicketUpdate -> onAssignmentUpdate`.
  * 영향 낮음 - 대부분의 구현에서 이 리스너를 사용할 필요가 없었습니다.
  * 해결 방법 - 찾아서 다음으로 바꿉니다. [새 이벤트](https://docs.edgegap.com/unity/matchmaking#client-events) 아래 `onAssignmentUpdate` 리스너.
* 분리됨 `Ping` , `SafeHttpRequest` , 그리고 `Observable` . 네임스페이스로 이동됨 `Edgegap` .
  * 영향 낮음 - 기능은 그대로이며 다른 네임스페이스로 이동했을 뿐입니다.
  * 해결 방법 - 필요에 따라 import 문 또는 네임스페이스가 지정된 참조를 업데이트합니다.
* 콘솔 호환성이 낮고 온보딩에 불편을 초래하여 캐싱 기능을 제거했습니다.
  * 영향 낮음 - 충돌한 플레이어가 캐시에서 재개하는 대신 티켓을 중복 생성할 수 있습니다.
  * 해결 방법 - 다음을 사용하여 사용자 지정 캐시를 구현합니다. `onAssignmentUpdate` 이벤트 리스너.
* 어셈블리 이름 변경 `com.edgegap.unity-matchmaking-sdk -> com.edgegap.unity-sdk` .
  * 영향 낮음 - 이 SDK를 참조하는 일부 고도로 사용자 지정된 빌드 파이프라인에 영향을 줍니다.
  * 해결 방법 - 사용자 지정 도구에서 SDK 어셈블리 이름 참조를 업데이트합니다.

</details>

<details>

<summary>문제 해결 및 FAQ</summary>

Unity: `[패키지 관리자 창] 패키지 추가 오류: https://github.com/edgegap/sdk-unity-sessions-matchmaker-server-browser.git`

* git URL을 통해 플러그인을 추가하려면 Git 클라이언트가 설치되어 있어야 합니다.

***

Visual Studio: `형식 또는 네임스페이스 이름을 찾을 수 없습니다` Edgegap 네임스페이스에 대해.

1. Unity 에디터에서 다음으로 이동하세요 **편집 / 기본 설정 / 외부 도구 / .csproj 파일 생성**.
2. 다음이 활성화되어 있는지 확인하세요 **Git 패키지**.
3. 클릭 **프로젝트 파일 다시 생성**.

</details>

{% hint style="info" %}
도움이 필요하시면 [디스코드를 통해 문의해 주세요](https://discord.gg/MmJf8fWjnt). 실시간 게임 지원은 저희의 [티켓 시스템](https://edgegap.atlassian.net/servicedesk/customer/portal/3).
{% endhint %}

## 📫 분산 릴레이 전송 라이브러리

피어 투 피어 게임에서 분산 릴레이를 활용할 수 있도록 네트코드 라이브러리에 맞는 맞춤형 Transport를 찾아보세요.

[문서 보기](https://docs.edgegap.com/ko/learn/distributed-relay/relay-transport-samples.md):

* Edgegap 릴레이 샘플 다운로드:
  * [Mirror 샘플](https://github.com/edgegap/relay-sample-unity-mirror-),
  * [FishNet 샘플](https://github.com/edgegap/relay-sample-unity-fishnet-),
  * [Unity NGO 샘플](https://github.com/edgegap/relay-sample-unity-ngo-helloworld).
* [Edgegap Relay Transport Library - 지원되는 네트코드의 소스 코드와 릴리스 노트.](https://github.com/edgegap/relay-transport-template-model)
