> 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/ru/docs/sample-projects/unity-netcodes/playfab-mps-mirror.md).

# PlayFab MPS Mirror

Сэмпл PlayFab для Unity Mirror Multiplayer Servers, перенесённый в Edgegap: без GSDK, серверы запускаются по запросу рядом с игроками, а также инструмент-аллокатор в API Edgegap.

Узнайте, как перенести игровой сервер с **PlayFab Multiplayer Servers** (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**: сервер слушает фиксированный порт при запуске, без агента, heartbeat или вызова ready,
* **EdgegapAllocatorSample**: консольное .NET-приложение, которое запускает сервер рядом с игроками и ждёт его адреса, перечисляет версии и развёртывания и останавливает развёртывание, используя [API Edgegap](https://docs.edgegap.com/ru/docs/api/vydelennye-servery.md),
* **самоостановка сервера**: сервер останавливает собственное развёртывание, когда никто не подключается, или после того, как все уйдут.

{% hint style="info" %}
Проверено на Edgegap 29 октября 2026 года: аллокатор запустил сервер в Торонто за несколько секунд, два клиента Windows подключились, и сервер остановил своё развёртывание после их выхода.
{% endhint %}

{% hint style="success" %}
Используете PlayFab Matchmaking? [Развёртывание из PlayFab](https://docs.edgegap.com/ru/docs/tools-and-integrations/playfab-bridge.md) запускает сервер Edgegap для каждого матча.
{% endhint %}

## 🗺️ От MPS к Edgegap

| PlayFab Multiplayer Servers                                    | Edgegap                                                                                                                                                                                                          |
| -------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| GSDK `Запуск`, `ReadyForPlayers`, слушайте на `OnServerActive` | Слушайте фиксированный порт 7777 при запуске (`EdgegapServer.cs`).                                                                                                                                               |
| Порт из `GetGameServerConnectionInfo`                          | Фиксированный внутренний порт в версии приложения. Edgegap сопоставляет его с публичным портом.                                                                                                                  |
| `UpdateConnectedPlayers`                                       | Не нужно. Сервер только считает игроков, чтобы понять, когда остановиться.                                                                                                                                       |
| `OnShutDownCallback`                                           | Edgegap отправляет SIGTERM. Игроки получают то же самое `ShutdownMessage` когда Unity завершает работу.                                                                                                          |
| Сборка, размер ВМ, серверов на ВМ, резервные серверы           | Версия приложения: образ, 0,5 vCPU / 1 ГБ на сервер, порт `gameport` TCP 7777. Ничего не подготовлено заранее.                                                                                                   |
| `RequestMultiplayerServer`                                     | `POST /v2/deployments` с IP-адресами игроков или координатами (`EdgegapAllocatorSample`).                                                                                                                        |
| Сервер работает, пока MPS не остановит его                     | Сервер останавливает собственное развёртывание через `ARBITRIUM_DELETE_URL`, [вставляемый в каждое развёртывание](https://docs.edgegap.com/ru/learn/orkestraciya/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),
* токен API Edgegap из [Панель управления → Настройки пользователя → Токены](https://app.edgegap.com/user-settings?tab=tokens). Он остаётся на вашем компьютере или в вашем бэкенде, никогда — в игровом клиенте.

## ⚡ Разверните и подключитесь

### 1. Соберите и загрузите сервер

Откройте `UnityMirror/UnityServer` в Unity, затем **Инструменты → Edgegap Server Hosting**:

1. **Войдите через Edgegap**, затем **Соберите сервер**.
2. **Контейнеризуйте с Docker**: имя образа `mps-unity-mirror`, тег образа пустой (плагин использует текущее UTC-время).
3. Необязательная локальная проверка: параметры запуска `-p 7777:7777/tcp`, затем **Развернуть локальный контейнер**.
4. **Загрузить в Edgegap**: приложение `mps-unity-mirror`, затем **Загрузить образ и создать версию приложения**. В форме версии задайте один порт с именем `gameport`, 7777, **TCP**, 0,5 vCPU / 1 ГБ и максимальную длительность 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/ru/docs/tools-and-integrations/playfab-bridge.md) или [Edgegap Matchmaker](https://docs.edgegap.com/ru/learn/matchmeiking.md).
* **Сервер не проверяет, кто подключается.** Для продакшна передавайте ожидаемых игроков в развёртывание как переменные окружения и отклоняйте остальных.
