> 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/purrnet-incremental.md).

# Purrnet Incremental

Разместите игру Unity Purrnet на Edgegap, используя пример Purrnet Incremental, чтобы пройти через сборку и развертывание.

Узнайте, как размещать проекты Unity на Edgegap, используя техники из [Purrnet Incremental Sample](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 Incremental Sample](https://purrnet.dev/docs/full-game-guides/incremental-game-sample) (основной проект),
  * или [Purrnet Incremental Sample для Edgegap](https://github.com/edgegap/netcode-game-sample-unity-purrnet-incremental), наш форк, готовый для Edgegap.
* [Purrnet Unity Package](https://purrnet.dev/docs/getting-started/installation-setup) (включён в проект-пример).
* [Плагин быстрого старта выделенных серверов Unity от Edgegap](https://docs.edgegap.com/ru/unity.md).
  * Установите из git или пакетов Purrnet — оба включают один и тот же плагин.

Откройте ваш проект инкрементального примера в Unity, чтобы начать.

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

{% hint style="success" %}
См. [Unity](https://docs.edgegap.com/ru/unity.md) в **узнать, как собирать и настраивать серверы**.
{% endhint %}

### 1. Разверните сервер на Edgegap

☑️ Для начала вам нужно будет [создать бесплатную учетную запись в Edgegap](https://app.edgegap.com/auth/register). Кредитная карта не требуется.

☑️ Следуйте [Руководство Unity Getting Started](https://docs.edgegap.com/ru/unity.md) чтобы собрать и загрузить ваш выделенный сервер.

☑️ [Разверните сервер](https://app.edgegap.com/deployment-management/deployments/create) с новой созданной версией приложения Incremental Sample.

☑️ [Откройте сведения о новом развертывании](https://app.edgegap.com/deployment-management/deployments/list) и найдите свои уникальные одноразовые данные подключения:

* **Host URL** в формате `780aa4260e83.pr.edgegap.net` ,
* **Внешний порт** в формате `30854` (5 цифр).

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

### 2. Подключение из редактора

☑️ Откройте новый проект в Unity.

☑️ Проверьте, что вы открыли основную сцену: `Scenes/GameScene.unity`.

☑️ Введите данные подключения Network Manager из предыдущего шага.

☑️ Нажмите кнопку ▶️ Play, чтобы запустить клиент игры.

☑️ Подключите второго виртуального игрока с помощью [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` файл для полного описания шагов.

* **Bootstrap во время выполнения, без правок сцены** - `EdgegapBootstrap` запускается до загрузки сцены и добавляет компоненты Edgegap во время выполнения, поэтому `GameScene` не изменяется. В сборках он отключает автозапуск PurrNet. В редакторе режим Play сохраняет обычный поток host и clone PurrNet, если только `Apply In Editor` не отмечен.
* **Один asset с настройками** - `Assets/Edgegap/Resources/EdgegapSettings.asset` содержит режим, порты, URL матчмейкера и Auth Token. Параметры командной строки, такие как `-edgegapAddress` и `-edgegapPort` переопределяют их в сборках.
* **Прямое подключение (по умолчанию)** - клиентские сборки показывают панель подключения с адресом и портом. Подключайтесь к локальному серверу в Docker или к развёртыванию, которое вы запускаете из [панели управления](https://app.edgegap.com/deployment-management/deployments/list).
* **Edgegap Matchmaker (необязательно, по умолчанию отключён)** - отметьте `Use Edgegap Matchmaker` в asset настроек и вставьте `API URL` и `Auth Token`вашего матчмейкера. Затем игроки нажимают `Find Match` и автоматически подключаются к назначенному серверу. См. [Матчмейкинг](https://docs.edgegap.com/ru/learn/matchmeiking.md).
* **Автоостановка сервера** - в серверных сборках, `EdgegapServerLifecycle` запускает сервер PurrNet на `0.0.0.0:7777`. На Edgegap он останавливает своё развёртывание, если никто не присоединится в течение 120 секунд, или через 30 секунд после выхода последнего игрока.
* **UDP-порт 7777** - вашей версии приложения нужен один [порт](https://docs.edgegap.com/ru/learn/orkestraciya/application-and-versions.md#port-mapping) под названием `gameport`, порт `7777`, протокол `UDP`, тот же порт по умолчанию, что и у других примеров. Форк включает `Dockerfile` и меню Tools / Edgegap / Build Linux Dedicated Server.

{% hint style="danger" %}
**Не интегрируйте endpoints API Edgegap в игровой клиент, поскольку ваш API-токен предоставляет неограниченный доступ к вашей учётной записи. См.** [Интеграция](https://docs.edgegap.com/ru/docs/api/integraciya.md) **для безопасных client-facing endpoints API и функций.**
{% endhint %}

{% hint style="info" %}
Auth Token для матчмейкинга привязан только к вашему матчмейкеру, поэтому его безопасно включать в игровые клиенты.
{% endhint %}

{% hint style="info" %}
Форк изменяет одну строку в основном проекте: `ResourceSpawner.InitSeed` теперь `[ObserversRpc(runLocally: true, bufferLast: true)]`. **Без `runLocally`выделенный сервер никогда не получает свой seed, поэтому он никогда не создаёт деревья.** Режим Host не затрагивается.
{% endhint %}
