> 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/docs/sample-projects/unity-netcodes/purrnet-incremental.md).

# Purrnet Incremental

Purrnet Incremental 샘플을 사용해 빌드와 배포 과정을 살펴보며 Edgegap에서 Unity Purrnet 게임을 호스팅하세요.

다음의 기법을 사용하여 Edgegap에서 Unity 프로젝트를 호스팅하는 방법을 살펴보세요 [Purrnet 증분 샘플](https://purrnet.dev/docs/full-game-guides/incremental-game-sample).

{% hint style="success" %}
저희의 [샘플의 포크](https://github.com/edgegap/netcode-game-sample-unity-purrnet-incremental) 게임을 Edgegap 전용 서버에서 실행합니다. 다음을 참조하세요 [Edgegap 포크가 추가하는 것](#what-the-edgegap-fork-adds).
{% endhint %}

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

## ✔️ 준비

시작하기 전에 다음이 필요합니다:

* [Unity 6](https://unity.com/releases/unity-6) - Unity Hub를 사용해 다운로드합니다.
* [Purrnet 증분 샘플](https://purrnet.dev/docs/full-game-guides/incremental-game-sample) (업스트림 프로젝트),
  * 또는 [Edgegap용 Purrnet 증분 샘플](https://github.com/edgegap/netcode-game-sample-unity-purrnet-incremental), Edgegap에 맞게 준비된 우리의 포크입니다.
* [Purrnet Unity 패키지](https://purrnet.dev/docs/getting-started/installation-setup) (샘플 프로젝트에 포함됨).
* [Edgegap의 Unity 전용 서버 빠른 시작 플러그인](https://docs.edgegap.com/ko/unity.md).
  * git 또는 Purrnet 패키지에서 설치하세요. 둘 다 동일한 플러그인을 포함합니다.

시작하려면 Unity에서 증분 샘플 프로젝트를 여세요.

## ⚡ 배포 및 연결

{% hint style="success" %}
참조 [Unity](https://docs.edgegap.com/ko/unity.md) 하여 **서버를 빌드하고 커스터마이즈하는 방법을 알아보세요**.
{% endhint %}

### 1. Edgegap에 서버 배포

☑️ 시작하려면 다음이 필요합니다 [Edgegap에 무료 계정을 만드세요](https://app.edgegap.com/auth/register). 신용카드는 필요 없습니다.

☑️ 다음을 따라하세요 [Unity 시작하기 가이드](https://docs.edgegap.com/ko/unity.md) 전용 서버를 빌드하고 업로드하세요.

☑️ [서버를 배포하세요](https://app.edgegap.com/deployment-management/deployments/create) 새로 생성한 Incremental Sample 앱 버전과 함께.

☑️ [새 배포의 세부 정보를 열고](https://app.edgegap.com/deployment-management/deployments/list) 고유한 일회성 연결 정보를 확인하세요:

* **호스트 URL** 형식 `780aa4260e83.pr.edgegap.net` ,
* **외부 포트** 형식 `30854` (5자리).

✅ 이제 다음 단계로 진행할 수 있습니다.

### 2. 에디터에서 연결

☑️ Unity에서 새 프로젝트를 여세요.

☑️ 메인 씬을 열었는지 확인하세요: `Scenes/GameScene.unity`.

☑️ 이전 단계의 Network Manager 연결 정보를 입력하세요.

☑️ ▶️ 재생 버튼을 눌러 게임 클라이언트를 시작하세요.

☑️ 다음을 사용해 두 번째 가상 플레이어를 연결하세요. [Multiplayer Play Mode](https://docs-multiplayer.unity3d.com/mppm/current/about/) 또는 [ParrelSync](https://github.com/VeriorPies/ParrelSync).

🙌 Edgegap에서 첫 배포를 축하합니다!

## 🧩 Edgegap 포크가 추가하는 것

저희의 [포크](https://github.com/edgegap/netcode-game-sample-unity-purrnet-incremental) 업스트림 게임은 유지하고 Edgegap 전용 항목은 모두 다음에 추가합니다 `Assets/Edgegap/`. 해당 파일을 참조하세요 `EDGEGAP.md` 전체 단계는 파일을 확인하세요.

* **런타임 부트스트랩, 씬 수정 없음** - `EdgegapBootstrap` 씬이 로드되기 전에 실행되어 런타임에 Edgegap 구성 요소를 추가하므로 `GameScene` 는 수정되지 않습니다. 빌드에서는 PurrNet의 자동 시작을 비활성화합니다. 에디터에서는 아래의 경우를 제외하고 플레이 모드가 PurrNet의 일반 호스트 및 클론 흐름을 유지합니다 `에디터에서 적용` 가 체크되어 있지 않으면.
* **하나의 설정 에셋** - `Assets/Edgegap/Resources/EdgegapSettings.asset` 모드, 포트, 매치메이커 URL 및 인증 토큰을 보관합니다. 다음과 같은 명령줄 옵션은 `-edgegapAddress` 및 `-edgegapPort` 빌드에서 이를 덮어씁니다.
* **직접 연결(기본값)** - 클라이언트 빌드에는 주소와 포트가 있는 연결 패널이 표시됩니다. Docker의 로컬 서버에 연결하거나, 다음에서 시작한 배포에 연결하세요 [대시보드](https://app.edgegap.com/deployment-management/deployments/list).
* **Edgegap 매치메이커(선택 사항, 기본적으로 비활성화됨)** - 체크하세요 `Edgegap 매치메이커 사용` 를 설정 에셋에서 선택하고 매치메이커의 내용을 붙여넣으세요 `API URL` 및 `Auth Token`. 그러면 플레이어는 `매치 찾기` 를 클릭하고 할당된 서버에 자동으로 연결합니다. 다음을 참조하세요 [매치메이킹](https://docs.edgegap.com/ko/learn/matchmaking.md).
* **서버 자동 중지** - 서버 빌드에서는, `EdgegapServerLifecycle` 에서 PurrNet 서버를 시작합니다 `0.0.0.0:7777`. Edgegap에서는 120초 안에 아무도 참여하지 않거나 마지막 플레이어가 떠난 뒤 30초가 지나면 자체 배포를 중지합니다.
* **UDP 포트 7777** - 앱 버전에는 하나가 필요합니다 [포트](https://docs.edgegap.com/ko/learn/orchestration/application-and-versions.md#port-mapping) 이름이 `gameport`, 포트 `7777`, 프로토콜 `UDP`, 다른 샘플과 동일한 기본값입니다. 이 포크에는 `Dockerfile` 및 Tools / Edgegap / Build Linux Dedicated Server 메뉴가 포함됩니다.

{% hint style="danger" %}
**API 토큰은 계정에 무제한 접근 권한을 제공하므로 게임 클라이언트에 Edgegap API 엔드포인트를 통합하지 마세요. 다음을 참조하세요** [통합](https://docs.edgegap.com/ko/docs/api/integration.md) **안전한 클라이언트용 API 엔드포인트와 기능은 다음을 참조하세요.**
{% endhint %}

{% hint style="info" %}
매치메이킹 인증 토큰은 매치메이커 전용 범위이므로 게임 클라이언트에 포함해 배포해도 안전합니다.
{% endhint %}

{% hint style="info" %}
포크는 업스트림의 한 줄을 변경합니다: `ResourceSpawner.InitSeed` 는 이제 `[ObserversRpc(runLocally: true, bufferLast: true)]`. **없으면 `runLocally`, 전용 서버는 자신의 시드를 받지 못하므로 나무를 생성하지 않습니다.** 호스트 모드에는 영향이 없습니다.
{% endhint %}
