> 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/photon-fusion-2-br200.md).

# 포톤 퓨전 2 BR200

Edgegap 전용 서버에서 Photon의 BR200 배틀로얄 샘플(Photon Fusion 2)을 호스팅하세요. 매 경기마다 하나의 배포를 사용하며, Edgegap BR200 키트를 사용합니다.

다음의 기법을 사용해 Edgegap에서 Unity 프로젝트를 호스팅하는 방법을 살펴보세요 [BR200 배틀 로열 샘플](https://assetstore.unity.com/packages/templates/packs/br200-battle-royale-multiplayer-photon-fusion-226753), 최대 200명의 플레이어를 위한 배틀 로열입니다.

{% hint style="info" %}
저희의 [Edgegap BR200 키트](https://github.com/edgegap/netcode-game-sample-photon-fusion2-battleroyale-200) 는 BR200 프로젝트에 복사하는 파일 세트입니다. 이것은 **어떤 Photon 라이선스 코드도 변경하거나 포함하지 않습니다**, 따라서 Unity Asset Store에서 자체 라이선스로 BR200을 받게 됩니다.
{% endhint %}

이 샘플은 다음을 보여줍니다:

* **전용 서버로서의 BR200** - 매치당 하나의 배포, [플레이어와 가까운 곳에 배치](https://docs.edgegap.com/ko/learn/orchestration/deployments.md#server-placement).
* **BR200 코드 변경 없음** - 시작 스크립트가 매핑합니다 [주입된 변수](https://docs.edgegap.com/ko/learn/orchestration/deployments.md#injected-environment-variables) 를 BR200의 자체 명령줄 옵션에.
* **직접 연결** - 서버가 바인딩합니다 `0.0.0.0`, 따라서 클라이언트는 Photon 릴레이를 거치지 않고 직접 연결합니다.
* **Photon 지역 선택** - 서버가 자신의 배포에 가장 가까운 Photon 지역을 선택합니다.
* **서버 자동 중지** - 매치가 끝나면 서버가 자신의 배포를 중지합니다.

{% hint style="success" %}
참조 [Photon Fusion 2](https://docs.edgegap.com/ko/docs/sample-projects/unity-netcodes/photon-fusion-2-on-edgegap.md) 에 대한 **Edgegap에서 Photon Fusion 2를 사용하는 일반 가이드**. 키트의 [README](https://github.com/edgegap/netcode-game-sample-photon-fusion2-battleroyale-200) 에서 전체 파일 목록, 런타임 변수 및 테스트 결과를 확인하세요.
{% endhint %}

## ✔️ 준비

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

* [BR200 배틀 로열 (Photon Fusion)](https://assetstore.unity.com/packages/templates/packs/br200-battle-royale-multiplayer-photon-fusion-226753) - 지원되는 Unity 버전으로 다운로드하여 여세요.
* [Edgegap BR200 키트](https://github.com/edgegap/netcode-game-sample-photon-fusion2-battleroyale-200).
* Photon Fusion App ID - 다음에서 찾으세요 [Photon 대시보드](https://dashboard.photonengine.com).

{% hint style="info" %}
프로젝트를 열고 다음을 따라 서버 빌드 도구를 설치하세요 [Unity](https://docs.edgegap.com/ko/unity.md) 준비 단계.
{% endhint %}

이 키트는 Windows에서 BR200 2.1.0, Fusion 2.1.1(빌드 2177) 및 Unity 6000.3.11f1로 테스트되었습니다.

{% hint style="warning" %}
서버는 **IL2CPP 빌드여야 합니다** (BR200의 기본값). `MethodAccessException` 그리고 플레이어는 캐릭터를 받지 못합니다.
{% endhint %}

☑️ Windows에서 Linux IL2CPP를 빌드하려면 Window / Package Manager / + / Add package by name에서 Unity의 Linux 툴체인을 추가하세요:

* Unity 6000.3 이상: `com.unity.toolchain.win-x86_64-linux` 및 `com.unity.sdk.linux-x86_64`,
* 이전 버전: `com.unity.toolchain.win-x86_64-linux-x86_64`.

## ⚡ 배포 및 연결

### 1. 키트를 프로젝트에 추가

☑️ 복사 `Assets/EdgegapBR200`, `edgegap/`, `scripts/`, `.dockerignore` 및 `.gitattributes` 를 키트에서 BR200 프로젝트 루트로, 다음 항목 옆에 `Assets/`.

☑️ Tools / Fusion / Realtime Settings에 Fusion App ID를 붙여넣고, 다음을 확인하세요 **App Version**.

{% hint style="info" %}
클라이언트와 서버는 **같은 App ID, App Version 및 Photon 지역을 사용해야 합니다**, 그렇지 않으면 서로를 찾지 못합니다.
{% endhint %}

☑️ 설정하세요 **Peer Mode** 을 `Single` 를 Tools / Fusion / Network Project Config에서.

☑️ Tools / Edgegap BR200 / Check Project를 실행하고 보고된 문제를 수정하세요.

Loader 씬이나 스크립트를 수정할 필요는 없습니다. 서버 모드, 주소, 포트, 세션 및 지역은 명령줄로 전달됩니다.

{% hint style="info" %}
콘솔에 다음이 표시되면 `Unsafe code는 /unsafe로 컴파일할 때만 나타날 수 있습니다` 첫 번째 가져오기 직후 프로젝트를 닫았다가 다시 여세요.
{% endhint %}

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

### 2. 서버 빌드 및 업로드

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

☑️ Edgegap 플러그인 또는 터미널에서 서버를 빌드하고 업로드하세요:

{% tabs %}
{% tab title="Edgegap 플러그인(권장)" %}
☑️ Tools / Edgegap BR200 / Build Linux Server를 실행하세요. 프로젝트를 검사하고 다음을 활성화합니다 *Allow 'unsafe' Code* 필요한 경우, 그리고 Linux를 빌드합니다 **서버** 하위 대상(subtarget)을 `Builds/EdgegapServer`.

☑️ Tools / Edgegap Server Hosting을 여세요. 단계 **3. 서버 컨테이너화**, 다음을 클릭하세요 **Path To Dockerfile** 그리고 선택하세요 `edgegap/Dockerfile`. 유지하세요 **Relative Build Path** 을 `Builds/EdgegapServer`, 그런 다음 Containerize하고 업로드하세요.

☑️ 포트를 유지하세요 `7777` / UDP. 플러그인이 앱 버전을 생성할 때.
{% endtab %}

{% tab title="터미널(에이전트용)" %}
☑️ 다음을 찾으세요 [Container Registry](https://docs.edgegap.com/ko/learn/advanced-features/edgegap-container-registry.md#getting-your-credentials) 프로젝트 이름과 자격 증명을 찾은 다음, 다음으로 로그인하세요 `docker login registry.edgegap.com`.

☑️ 서버를 빌드한 다음 이미지를 패키징하고 푸시하세요(Windows에서는 Git Bash가 작동합니다):

{% code collapsedlinecount="10" %}

```bash
scripts/build-server.sh
scripts/package.sh registry.edgegap.com/<your-registry-project>/br200
```

{% endcode %}

`package.sh` 푸시한 새 태그를 출력합니다.

☑️ [애플리케이션을 생성하세요](https://app.edgegap.com/application-management/applications/list) 및 이미지용 버전을 만드세요. 또한 키트의 다음 항목을 사용할 수 있습니다 `examples/app-version.json` 와 함께 `POST /v1/app/{app}/version`.
{% endtab %}
{% endtabs %}

{% hint style="danger" %}
:x: **금지 - 기존 태그를 덮어쓰거나 다음을 사용하지 마세요. `latest`  태그** - 이렇게 하면 오래된 캐시가 배포됩니다.\
:white\_check\_mark: **권장 - 버전 태그를 항상 올리고** 새 빌드를 배포하세요.
{% endhint %}

☑️ 앱 버전을 다음과 같이 구성하세요:

* [포트](https://docs.edgegap.com/ko/learn/orchestration/application-and-versions.md#port-mapping) `7777`, 프로토콜 **UDP**, 이름 `gameport`,
* [재시작 정책](https://docs.edgegap.com/ko/learn/orchestration/application-and-versions.md#safety-guardrails) `never` - 매치가 끝나고 서버가 종료되면 배포도 종료됩니다,
* 최대 지속 시간은 가장 긴 매치보다 조금 길게 설정합니다(예시에서는 60분),
* 리소스는 시작점으로 1 vCPU와 2 GB로 설정합니다.

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

### 3. 로컬 테스트

☑️ 실제 배포와 동일한 주입 변수를 사용해 이미지를 로컬에서 실행하세요:

{% code collapsedlinecount="10" %}

```bash
scripts/run-local.sh eu
```

{% endcode %}

☑️ 다음을 사용하여 두 개의 에디터 또는 두 개의 클라이언트 빌드에서 출력된 세션 이름으로 참여하세요 **옵션 B** 다음 단계의 해당 세션 이름과 전달한 지역으로.

{% hint style="info" %}
로컬 클라이언트는 연결됩니다 **릴레이됨**, 같은 머신의 클라이언트는 Docker Desktop의 NAT 주소에 직접 도달할 수 없기 때문입니다. Edgegap에서는 동일한 이미지가 연결됩니다 **직접**.
{% endhint %}

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

### 4. 배포 및 연결

☑️ 플러그인에서 배포를 시작하고, [대시보드](https://app.edgegap.com/deployment-management/deployments/list), 또는 `POST /v2/deployments` 키트의 다음 항목으로 `examples/deploy-request.json`. 플레이어의 공용 IP를 다음에 전달하세요 [그들에게 가까운 곳에 배포](https://docs.edgegap.com/ko/learn/orchestration/deployments.md#server-placement).

배포의 FQDN(예: `0a1b2c3d4e5f.pr.edgegap.net`)는 BR200 세션 및 서버 이름이기도 합니다. 첫 서버 로그 줄에는 바인드 주소, 공용 주소 및 선택된 Photon 지역이 표시됩니다:

{% code collapsedlinecount="10" %}

```
[edgegap-br200] deployment=0a1b2c3d4e5f session=0a1b2c3d4e5f.pr.edgegap.net bind=0.0.0.0:7777/udp public=203.0.113.10:31502
[edgegap-br200] photon_region=eu (프랑크푸르트(50.11, 8.68)에 가장 가까움) max_players=200 mode=default scene=default
```

{% endcode %}

☑️ 다음 옵션 중 하나로 클라이언트를 연결하세요:

* **옵션 A: 메뉴** - 열기 `TPSBR/Scenes/Menu`, ▶️ Play를 누르고 같은 지역을 선택한 다음 목록에서 서버에 참여하세요,
* **옵션 B: Standalone Manager 자동 참여** - Loader의 설정된 씬을 여세요 **Batch Mode Scene**. **Standalone Manager**, Game Mode를 설정하고 `Client`, Server Name과 Session Name을 FQDN으로 설정하고, Region을 서버의 지역으로 설정한 다음 ▶️ Play를 누르세요.

{% hint style="warning" %}
BR200은 다음을 시작합니다 **서버가 부팅될 때 120초 대기 타이머**. 타이머가 끝난 후 참여한 플레이어는 탈락으로 간주됩니다. 그룹이 준비되면 한 번 배포하고, 배포가 Ready가 되면 즉시 클라이언트를 연결하세요.
{% endhint %}

☑️ 누르세요 **Tab** 연결된 클라이언트에서. 오버레이의 왼쪽 상단에는 **CT** (Connection Type)가 표시되며, 이는 다음을 의미해야 합니다 **직접**.

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

## 🔄 매치 수명 주기

1. Edgegap이 배포를 시작하고 [주입합니다 `ARBITRIUM_*` 변수](https://docs.edgegap.com/ko/learn/orchestration/deployments.md#injected-environment-variables).
2. `edgegap/start-server.sh` 이것들을 BR200의 명령줄 옵션으로 변환합니다. 항상 다음을 전달합니다 `-dedicatedServer -ip 0.0.0.0 -port 7777`, 세션 이름을 배포 FQDN으로 지정하고, 배포에 가장 가까운 Photon 지역을 선택합니다.
3. 클라이언트는 같은 Photon 지역에서 서버를 찾아 직접 연결합니다.
4. 매치 종료 시 BR200이 종료되면 스크립트가 다음을 호출합니다 `ARBITRIUM_DELETE_URL` 배포를 중지하여 완료된 매치가 즉시 과금 중지되도록 합니다. Edgegap이 배포를 중지하면, 대신 스크립트가 중지 신호를 BR200에 전달합니다.

참조 [배포](https://docs.edgegap.com/ko/learn/orchestration/deployments.md) 자세한 내용은.

## ⚙️ 환경 변수

Edgegap [주입합니다 `ARBITRIUM_*` 변수](https://docs.edgegap.com/ko/learn/orchestration/deployments.md#injected-environment-variables) 가 자동으로 설정합니다. 다음을 설정하세요 `BR200_*` 앱 버전(매치마다) 또는 배포 요청(이 매치에만)에서 이러한 변수를 설정하세요:

| 변수                       | 기본값                                                                      | BR200 옵션                                         |
| ------------------------ | ------------------------------------------------------------------------ | ------------------------------------------------ |
| `BR200_SESSION`          | 배포 FQDN, `<ARBITRIUM_REQUEST_ID>.pr.edgegap.net`                         | `-sessionName`                                   |
| `BR200_SERVER_NAME`      | 세션과 동일                                                                   | `-serverName`                                    |
| `BR200_REGION`           | `자동`: 배포에 가장 가까운 Photon 지역. `최적`: Fusion이 ping하게 하세요. 또는 다음과 같은 코드 `eu`. | `-region`                                        |
| `BR200_REGION_ALLOWLIST` | 모든 Photon 지역. 쉼표로 구분된 코드로 `자동` 선택할 수 있습니다.                               |                                                  |
| `BR200_MAX_PLAYERS`      | `200` (1\~200)                                                           | `-maxPlayers`                                    |
| `BR200_MODE`             | BR200의 기본값. `battleRoyale`, `deathmatch` 또는 `elimination`.               | `-battleRoyale` / `-deathmatch` / `-elimination` |
| `BR200_SCENE`            | Loader의 Batch Mode Scene                                                 | `-scene`                                         |
| `BR200_LOBBY`            | BR200의 기본값                                                               | `-lobby`                                         |
| `BR200_FPS`              | Fusion의 틱 속도                                                             | `-fps`                                           |
| `BR200_RECORD`           | `false`. `true` 세션 통계를 다음에 기록합니다 `/data`.                                | `-recordSession -dataPath /data`                 |
| `BR200_EXTRA_ARGS`       | 없음. 다른 옵션은 마지막에 추가됩니다.                                                   |                                                  |
| `BR200_SELF_STOP`        | `true`. BR200이 종료되면 배포를 중지합니다.                                           |                                                  |

클라이언트가 고정된 Photon 지역을 사용하거나 Photon 앱이 일부 지역만 허용하는 경우, 다음을 설정하세요 `BR200_REGION` 배포에서, 또는 제한하세요 `자동` 와 함께 `BR200_REGION_ALLOWLIST`.

## 🔌 직접 연결

BR200의 `IP` 및 `포트` 서버가 **바인딩하는** 주소를 설정하세요. 이 키트는 다음에 바인딩합니다 `0.0.0.0:7777`, Fusion이 배포의 공용 주소를 스스로 찾고, 클라이언트는 연결합니다 **직접** - Edgegap이 플레이어에게 다른 [외부 포트](https://docs.edgegap.com/ko/learn/orchestration/application-and-versions.md#port-mapping).

| 서버 `IP`          | 결과                                                                                         |
| ---------------- | ------------------------------------------------------------------------------------------ |
| `0.0.0.0` (이 키트) | **직접** Edgegap에서.                                                                          |
| `127.0.0.1`      | 서버는 시작되지만 클라이언트는 **릴레이됨** Photon을 통해 연결되며, 이로 인해 지연이 추가됩니다. 컨테이너 외부에서는 루프백 주소에 도달할 수 없습니다. |
| 배포의 공용 IP        | 서버가 **시작하지 않습니다** (`소켓 바인딩 실패`), 왜냐하면 컨테이너가 해당 주소의 소유자가 아니기 때문입니다. 클라이언트는 `GameNotFound`.  |

{% hint style="warning" %}
비워 두세요 `IP` 비우거나 `0.0.0.0`. **다음으로 설정하지 마세요 `127.0.0.1` 또는 배포의 공용 IP로.**
{% endhint %}

## 🚨 문제 해결

<details>

<summary><code>MethodAccessException ... CheckInvokeRpc</code> 서버 로그에서</summary>

* 서버가 Mono로 빌드되었습니다. IL2CPP로 다시 빌드하세요.

</details>

<details>

<summary><code>호스트 플랫폼에 대한 툴체인을 찾을 수 없습니다</code> 또는 <code>Linux sysroot를 찾을 수 없습니다</code></summary>

* Linux 툴체인 패키지가 누락되었습니다, 다음을 참조하세요 [준비](#preparation).

</details>

<details>

<summary>클라이언트가 다음을 받습니다 <code>GameNotFound</code></summary>

* 클라이언트와 서버 간 App Version 또는 Photon 지역이 다릅니다. 서버의 다음 항목과 비교하세요 `photon_region=` 로그 줄.

</details>

<details>

<summary>클라이언트가 다음을 받습니다 <code>InvalidAuthentication</code></summary>

* 빌드에서 Fusion App ID가 잘못되었거나 누락되었습니다.

</details>

<details>

<summary>Tab 오버레이에 CT Relayed가 표시됨</summary>

* 서버가 바인딩하는 `127.0.0.1`, 다음을 참조하세요 [직접 연결](#direct-connection).

</details>

<details>

<summary>서버가 메뉴에 표시되지 않음</summary>

* 클라이언트 지역이 서버와 다르거나 120초 대기 타이머가 이미 종료되었습니다.

</details>

<details>

<summary>배포가 즉시 종료되며 다음 오류가 표시됩니다 <code>error: ...</code></summary>

* 하나의 `BR200_*` 값이 유효하지 않습니다. 로그 줄에 어떤 값인지 표시됩니다.

</details>

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