> 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/docs.edgegap.com-ko/unity/developer-tools.md).

# 개발자 도구

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

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

#### 시맨틱 버전 관리

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

**버전이 출시되면, 절대 수정/변경되지 않습니다**.

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

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

* [Unity용 전용 서버 플러그인 - 턴키 솔루션, 소스 코드, 전체 릴리스 노트.](https://github.com/edgegap/edgegap-unity-plugin)

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

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

이 플러그인에는 다음을 돕기 위한 기능이 포함되어 있습니다:

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

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

#### 설치

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

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

<details>

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

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

<figure><img src="/files/684daf6ed1c0a4b7fcf2d4351ba474f7c106cc6c" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/82384e76ef4f9397d56cc6284ae017723a0fed5c" 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](/docs.edgegap.com-ko/unity.md) 시작하는 방법과 플러그인 사용에 대한 자세한 지침은
{% endhint %}

<details>

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

Unity 오류: `[패키지 관리자 창] 패키지 추가 중 오류 발생: https://github.com/edgegap/edgegap-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 %}

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

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

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

{% 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: 아이콘을 클릭하고 다음을 선택하세요 `git URL에서 패키지 추가...` ,
4. 안내가 표시되면 SDK의 URL을 입력하세요:

{% code title="" %}

```
https://github.com/edgegap/edgegap-unity-sdk.git
```

{% endcode %}

5. 클릭하세요 `추가`  를 클릭하고 설치가 완료될 때까지 기다리세요.

#### 샘플 가져오기

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

#### 검증된 소스

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

#### 패키지 업데이트

Unity Package Manager에서 Edgegap SDK로 이동한 다음 `업데이트` .

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

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

#### v3로 업데이트

이번 업데이트에는 많은 새로운 [Server Browser](/docs.edgegap.com-ko/unity/server-browser.md) 유틸리티와 예제가 포함되어 있으며, 매치메이킹 오류 처리 등이 개선되었습니다. 다음을 참조하세요 [릴리스 노트](/docs.edgegap.com-ko/docs/release-notes.md) 전체 목록은

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

<details>

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

Unity: `[패키지 관리자 창] 패키지 추가 중 오류 발생: https://github.com/edgegap/edgegap-unity-sdk.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 %}

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

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

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

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