> 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/playfab-mps-mirror.md).

# PlayFab MPS 미러

PlayFab의 Unity Mirror 멀티플레이어 서버 샘플이 Edgegap으로 이전됨: GSDK 없음, 서버는 플레이어 근처에서 요청 시 시작되며, Edgegap API의 할당 도구가 있습니다.

게임 서버를 다음에서 이전하는 방법을 알아보세요 **PlayFab 멀티플레이어 서버** (MPS)에서 **Edgegap** 와 함께 [PlayFab MPS Mirror 샘플](https://github.com/edgegap/backend-game-sample-unity-mirror-playfab-mps), Microsoft의 포크인 [MpsSamples](https://github.com/PlayFab/MpsSamples) 여기서 `UnityMirror` 샘플이 Edgegap에서 실행됩니다.

이 샘플에는 매치메이커가 없습니다. 작은 명령줄 도구로 서버를 시작하며, 이는 PlayFab의 `MpsAllocatorSample`, 그리고 출력된 주소로 클라이언트를 연결합니다. 플레이어가 떠나면 서버가 스스로 종료됩니다.

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

* **Unity 2021.3.45f2** 서버와 클라이언트를 **Mirror** (Telepathy, TCP 7777), 서버는 다음을 사용해 Linux 전용 서버로 빌드됩니다: [Edgegap Unity 플러그인](https://github.com/edgegap/buildtool-unity-plugin),
* **GSDK 없음**: 서버는 시작 시 고정 포트에서 수신 대기하며, 에이전트, 하트비트 또는 ready 호출이 없습니다.
* **EdgegapAllocatorSample**: 플레이어 근처에서 서버를 시작하고 주소를 기다리며, 버전과 배포를 나열하고, 배포를 중지하는 .NET 콘솔 앱으로, 다음을 사용합니다: [Edgegap API](https://docs.edgegap.com/ko/docs/api/dedicated-servers.md),
* **서버 자동 종료**: 아무도 참여하지 않거나 모두 떠난 뒤 서버가 자체 배포를 중지합니다.

{% hint style="info" %}
2026년 10월 29일에 Edgegap에서 검증됨: 할당기가 몇 초 만에 토론토에서 서버를 시작했고, 두 Windows 클라이언트가 연결되었으며, 그들이 종료한 후 서버가 자체 배포를 중지했습니다.
{% endhint %}

{% hint style="success" %}
PlayFab 매치메이킹을 사용하시나요? [PlayFab에서 배포](https://docs.edgegap.com/ko/docs/tools-and-integrations/playfab-bridge.md) 각 매치마다 Edgegap 서버를 시작합니다.
{% endhint %}

## 🗺️ MPS에서 Edgegap으로

| PlayFab 멀티플레이어 서버                                          | Edgegap                                                                                                                                                      |
| ---------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| GSDK `시작`, `ReadyForPlayers`, 다음에서 수신 대기: `OnServerActive` | 시작 시 고정 포트 7777에서 수신 대기(`EdgegapServer.cs`).                                                                                                                 |
| 포트는 `GetGameServerConnectionInfo`                          | 앱 버전의 고정 내부 포트입니다. Edgegap이 이를 공용 포트에 매핑합니다.                                                                                                                 |
| `UpdateConnectedPlayers`                                   | 필요하지 않습니다. 서버는 중지 시점을 알기 위해 플레이어 수만 셉니다.                                                                                                                     |
| `OnShutDownCallback`                                       | Edgegap이 SIGTERM을 보냅니다. 플레이어는 동일한 `ShutdownMessage` Unity가 종료될 때.                                                                                            |
| 빌드, VM 크기, VM당 서버 수, 대기 서버                                 | 앱 버전: 이미지, 서버당 0.5 vCPU / 1GB, 포트 `gameport` TCP 7777. 사전 프로비저닝된 것은 없습니다.                                                                                    |
| `RequestMultiplayerServer`                                 | `POST /v2/deployments` 플레이어의 IP 또는 좌표와 함께 (`EdgegapAllocatorSample`).                                                                                        |
| 서버는 MPS가 종료할 때까지 실행됩니다                                     | 서버는 다음을 통해 자체 배포를 중지합니다 `ARBITRIUM_DELETE_URL`, [모든 배포에 주입됨](https://docs.edgegap.com/ko/learn/orchestration/deployments.md#injected-environment-variables). |

## ✔️ 준비

시작하기 전에 필요한 것은 다음과 같습니다:

* Unity `2021.3.45f2` 와 함께 **Linux 빌드 지원** 및 **Linux 전용 서버 빌드 지원**,
* [Docker Desktop](https://www.docker.com/products/docker-desktop/), 실행 중,
* the [.NET SDK](https://dotnet.microsoft.com/download) 8 이상, 할당기용,
* [샘플 프로젝트](https://github.com/edgegap/backend-game-sample-unity-mirror-playfab-mps),
* 다음에서 Edgegap API 토큰: [대시보드 → 사용자 설정 → 토큰](https://app.edgegap.com/user-settings?tab=tokens). 이는 사용자 기기나 백엔드에만 저장되며, 게임 클라이언트에는 절대 저장되지 않습니다.

## ⚡ 배포 및 연결

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

열기 `UnityMirror/UnityServer` Unity에서, 그런 다음 **도구 → Edgegap 서버 호스팅**:

1. **Edgegap으로 로그인**, 그런 다음 **서버 빌드**.
2. **Docker로 컨테이너화**: 이미지 이름 `mps-unity-mirror`, 이미지 태그는 비워 둡니다(플러그인이 현재 UTC 시간을 사용합니다).
3. 선택적 로컬 확인: 실행 매개변수 `-p 7777:7777/tcp`, 그런 다음 **로컬 컨테이너 배포**.
4. **Edgegap에 업로드**: 애플리케이션 `mps-unity-mirror`, 그런 다음 **이미지 업로드 및 앱 버전 생성**. 버전 양식에서 다음 이름의 포트 하나를 설정하세요: `gameport`, 7777, **TCP**, 0.5 vCPU / 1GB 및 최대 지속 시간 60분. 양식에서 레지스트리 자격 증명을 요청하면 대시보드의 다음에서 사용자 이름과 토큰을 사용하세요: **컨테이너 레지스트리** 페이지.

명령줄에서, CI 또는 스크립트 테스트용:

{% code collapsedlinecount="10" %}

```bash
"<Unity>" -batchmode -projectPath UnityMirror/UnityServer -executeMethod EdgegapPluginBuild.BuildServer -logFile build-server.log
```

{% endcode %}

### 2. 서버 시작

토큰, 애플리케이션 및 버전과 함께 할당기를 실행합니다:

{% code collapsedlinecount="10" %}

```bash
cd EdgegapAllocatorSample
export EDGEGAP_API_TOKEN="token xxxxxxxx" EDGEGAP_APP=mps-unity-mirror EDGEGAP_VERSION=<version name>
dotnet run -- deploy <your public IP>
```

{% endcode %}

클라이언트 인수를 출력합니다. 예를 들어 `-server 1a2b3c.pr.edgegap.net:31202`, 서버가 준비되면. 인수가 없으면, `dotnet run` 버전과 배포를 나열하거나 배포를 중지하는 메뉴가 열립니다.

### 3. 클라이언트 연결

빌드 `UnityMirror/UnityClient` Windows용으로 빌드한 다음 다음 주소로 시작하세요:

{% code collapsedlinecount="10" %}

```bash
"<Unity>" -batchmode -quit -projectPath UnityMirror/UnityClient -buildTarget Win64 -buildWindows64Player Builds/Client/win64/Client.exe
UnityMirror/UnityClient/Builds/Client/win64/Client.exe -server <host>:<port>
```

{% endcode %}

클라이언트를 종료하세요: 서버는 마지막 플레이어가 떠난 후 30초 뒤, 또는 아무도 참여하지 않으면 시작 후 120초 뒤에 배포를 중지합니다.

{% hint style="info" %}
무료 티어는 한 번에 하나의 배포만 실행합니다. 테스트하기 전에 다른 배포를 중지하세요.
{% endhint %}

## 🔧 알려진 제한 사항

* **매치메이커 없음.** 서버는 할당기 또는 대시보드에서 시작됩니다. 플레이어용으로는 백엔드에서 시작하거나 다음을 사용하세요: [PlayFab에서 배포](https://docs.edgegap.com/ko/docs/tools-and-integrations/playfab-bridge.md) 또는 [Edgegap Matchmaker](https://docs.edgegap.com/ko/learn/matchmaking.md).
* **서버는 누가 연결하는지 확인하지 않습니다.** 운영 환경에서는 예상되는 플레이어를 환경 변수로 배포에 전달하고, 다른 플레이어는 거부하세요.
