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

# Photon Fusion 2 BR200

Разместите образец королевской битвы BR200 от Photon (Photon Fusion 2) на выделенных серверах Edgegap: по одному развертыванию на матч, используя комплект Edgegap BR200.

Узнайте, как размещать проекты Unity на Edgegap, используя методы из [BR200 Battle Royale Sample](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**, так что вы получаете BR200 из Unity Asset Store по собственной лицензии.
{% endhint %}

В этом примере показано:

* **BR200 как выделенный сервер** - одно развертывание на матч, [размещается рядом с игроками](https://docs.edgegap.com/ru/learn/orkestraciya/deployments.md#server-placement).
* **Без изменений кода BR200** - скрипт запуска сопоставляет [внедряемые переменные](https://docs.edgegap.com/ru/learn/orkestraciya/deployments.md#injected-environment-variables) с собственными параметрами командной строки BR200.
* **Прямые подключения** - сервер привязывается `0.0.0.0`, поэтому клиенты подключаются напрямую, а не через ретранслятор Photon.
* **Выбор региона Photon** - сервер выбирает регион Photon, ближайший к своему развертыванию.
* **Автоостановка сервера** - сервер останавливает собственное развертывание, когда матч заканчивается.

{% hint style="success" %}
См. [Photon Fusion 2](https://docs.edgegap.com/ru/docs/sample-projects/unity-netcodes/photon-fusion-2-on-edgegap.md) для **общего руководства по Photon Fusion 2 на Edgegap**. См. [README](https://github.com/edgegap/netcode-game-sample-photon-fusion2-battleroyale-200) для полного списка файлов, переменных времени выполнения и результатов тестов.
{% endhint %}

## ✔️ Подготовка

Прежде чем начать, вам понадобится:

* [BR200 Battle Royale (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).
* App ID Photon Fusion — найдите его в своей [панели управления Photon](https://dashboard.photonengine.com).

{% hint style="info" %}
Откройте свой проект и установите инструменты сборки сервера, выполнив [Unity](https://docs.edgegap.com/ru/unity.md) шаги подготовки.
{% endhint %}

Этот набор был протестирован с BR200 2.1.0, Fusion 2.1.1 (build 2177) и Unity 6000.3.11f1 на Windows.

{% hint style="warning" %}
Ваш сервер **должен быть сборкой IL2CPP** (по умолчанию в BR200). Серверы Mono приводят к сбою RPC BR200 с `MethodAccessException` и игроки так и не получают персонажа.
{% endhint %}

☑️ Чтобы собрать Linux IL2CPP на Windows, добавьте Linux toolchain Unity в Window / Package Manager / + / Add package by name:

* 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/`.

☑️ Вставьте свой Fusion App ID в Tools / Fusion / Realtime Settings и запомните свой **версию приложения**.

{% hint style="info" %}
Клиенты и сервер **должны использовать один и тот же App ID, App Version и регион Photon**, иначе они не найдут друг друга.
{% endhint %}

☑️ Установите **режим Peer** в `Single` в Tools / Fusion / Network Project Config.

☑️ Запустите Tools / Edgegap BR200 / Check Project и исправьте все отмеченные проблемы.

Вам не нужно редактировать сцену или скрипт Loader. Режим сервера, адрес, порт, сессия и регион передаются через командную строку.

{% hint style="info" %}
Если в консоли отображается `Unsafe code may only appear if compiling with /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 **Server** подцель в `Builds/EdgegapServer`.

☑️ Откройте Tools / Edgegap Server Hosting. На шаге **3. Контейнеризуйте свой сервер**, нажмите **Path To Dockerfile** и выберите `edgegap/Dockerfile`. Оставьте **Relative Build Path** на `Builds/EdgegapServer`, затем выполните контейнеризацию и загрузку.

☑️ Оставьте порт `7777` / UDP, когда плагин создаст версию вашего приложения.
{% endtab %}

{% tab title="Терминал (для агентов)" %}
☑️ Найдите свой [Container Registry](https://docs.edgegap.com/ru/learn/advanced-features/edgegap-container-registry.md#getting-your-credentials) имя проекта и учетные данные, затем войдите с помощью `docker login registry.edgegap.com`.

☑️ Соберите свой сервер, затем упакуйте и отправьте образ (Git Bash работает на Windows):

{% 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/ru/learn/orkestraciya/application-and-versions.md#port-mapping) `7777`, протокол **UDP**, имя `gameport`,
* [политика перезапуска](https://docs.edgegap.com/ru/learn/orkestraciya/application-and-versions.md#safety-guardrails) `never` - развертывание завершается, когда матч заканчивается и сервер выходит,
* максимальная длительность немного выше, чем у вашего самого длинного матча (60 минут в примере),
* ресурсы 1 vCPU и 2 ГБ — как отправная точка.

✅ Теперь можете перейти к следующему шагу.

### 3. Локальное тестирование

☑️ Запустите свой образ локально с теми же внедряемыми переменными, что получает реальное развертывание:

{% code collapsedlinecount="10" %}

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

{% endcode %}

☑️ Присоединитесь к напечатанному имени сессии из двух редакторов или двух клиентских сборок, используя **Вариант B** из следующего шага с этим именем сессии и переданным вами регионом.

{% hint style="info" %}
Локальные клиенты подключаются **Через ретранслятор**, поскольку клиенты на одном компьютере не могут напрямую достичь NAT-адреса Docker Desktop. На Edgegap тот же образ подключается **Напрямую**.
{% endhint %}

✅ Теперь можете перейти к следующему шагу.

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

☑️ Запустите развертывание из плагина, [панели управления](https://app.edgegap.com/deployment-management/deployments/list), или `POST /v2/deployments` с `examples/deploy-request.json`. Передайте публичные IP ваших игроков в [разверните рядом с ними](https://docs.edgegap.com/ru/learn/orkestraciya/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 (nearest to Frankfurt (50.11, 8.68)) max_players=200 mode=default scene=default
```

{% endcode %}

☑️ Подключите клиента одним из следующих способов:

* **Вариант A: Меню** - откройте `TPSBR/Scenes/Menu`, нажмите ▶️ Play, выберите тот же регион и подключитесь к серверу из списка,
* **Вариант B: автоматическое присоединение Standalone Manager** - откройте сцену, заданную как **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/ru/learn/orkestraciya/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/ru/learn/orkestraciya/deployments.md) чтобы узнать больше.

## ⚙️ Переменные среды

Edgegap [внедряет `ARBITRIUM_*` переменные](https://docs.edgegap.com/ru/learn/orkestraciya/deployments.md#injected-environment-variables) автоматически. Установите эти `BR200_*` переменные в версии вашего приложения (каждый матч) или в запросе на развертывание (только этот матч):

| Переменная               | По умолчанию                                                                                            | параметр BR200                                   |
| ------------------------ | ------------------------------------------------------------------------------------------------------- | ------------------------------------------------ |
| `BR200_SESSION`          | FQDN развертывания, `<ARBITRIUM_REQUEST_ID>.pr.edgegap.net`                                             | `-sessionName`                                   |
| `BR200_SERVER_NAME`      | То же, что и сессия                                                                                     | `-serverName`                                    |
| `BR200_REGION`           | `auto`: ближайший к развертыванию регион Photon. `best`: пусть Fusion пингует. Или код, такой как `eu`. | `-region`                                        |
| `BR200_REGION_ALLOWLIST` | Все регионы Photon. Коды через запятую, из которых `auto` можно выбирать.                               |                                                  |
| `BR200_MAX_PLAYERS`      | `200` (1 до 200)                                                                                        | `-maxPlayers`                                    |
| `BR200_MODE`             | по умолчанию BR200. `battleRoyale`, `deathmatch` или `elimination`.                                     | `-battleRoyale` / `-deathmatch` / `-elimination` |
| `BR200_SCENE`            | 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` в развертывании, или ограничьте `auto` из набора с `BR200_REGION_ALLOWLIST`.

## 🔌 Прямое подключение

BR200 `IP` и `Порт` установите адрес, к которому ваш сервер **привязывается** . Набор привязывается `0.0.0.0:7777`, Fusion находит публичный адрес развертывания самостоятельно, и клиенты подключаются **Напрямую** - даже несмотря на то, что Edgegap дает игрокам другой [внешний порт](https://docs.edgegap.com/ru/learn/orkestraciya/application-and-versions.md#port-mapping).

| Server `IP`                | Результат                                                                                                                                          |
| -------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- |
| `0.0.0.0` (этот набор)     | **Напрямую** на Edgegap.                                                                                                                           |
| `127.0.0.1`                | Сервер запускается, но клиенты **Через ретранслятор** через Photon, что добавляет задержку. Ничто вне контейнера не может достичь адреса loopback. |
| Публичный 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>Не найден Toolchain для платформы хоста</code> или <code>Не найден Linux sysroot</code></summary>

* Пакеты Linux toolchain отсутствуют, см. [Подготовка](#preparation).

</details>

<details>

<summary>Клиент получает <code>GameNotFound</code></summary>

* Версия приложения или регион Photon отличаются между клиентом и сервером. Сравните с `строкой журнала photon_region=` .

</details>

<details>

<summary>Клиент получает <code>InvalidAuthentication</code></summary>

* Ваш App ID Fusion указан неверно или отсутствует в сборке.

</details>

<details>

<summary>Вкладка Overlay показывает CT Relayed</summary>

* Ваш сервер привязывается `127.0.0.1`, см. [Прямое подключение](#direct-connection).

</details>

<details>

<summary>Сервер не отображается в меню</summary>

* Регион клиента отличается от региона сервера, или 120-секундный таймер ожидания уже истек.

</details>

<details>

<summary>Развертывание немедленно завершается с <code>ошибка: ...</code></summary>

* Значение `BR200_*` недопустимо. В строке журнала указано, какое именно.

</details>

{% hint style="info" %}
Если вам нужна помощь, [свяжитесь с нами через Discord](https://discord.gg/MmJf8fWjnt). Для поддержки по играм в реальном времени см. нашу [систему тикетов](https://edgegap.atlassian.net/servicedesk/customer/portal/3).
{% endhint %}
