> 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/unity-netcode-on-edgegap.md).

# Unity NGO

Разместите проект Unity Netcode for GameObjects на Edgegap, следуя примеру NGO Boss Room от сборки до рабочего развертывания.

Узнайте, как размещать проекты Unity на Edgegap, используя методы из [Пример NGO Boss Room](https://unity.com/demos/small-scale-coop-sample).

{% hint style="info" %}
Этот пример **не требует каких-либо Unity Gaming Services (UGS)**, Multiplay или Relays для запуска.
{% endhint %}

{% embed url="<https://youtu.be/8Qi-wXswjkw>" %}

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

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

* [Unity 6](https://unity.com/releases/unity-6) - загрузка через Unity Hub,
* [Проект-пример Unity NGO \[Netcode for Game Objects\] Boss Room](https://github.com/edgegap/netcode-game-sample-unity-ngo-bossroom) (изменённый для Edgegap).

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

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

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

☑️ [Создайте новую версию приложения для вашего приложения](https://app.edgegap.com/application-management/applications/unity-ngo-bossroom-sample/versions/create), выберите NGO Boss Room Sample.

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

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

* **Внешний порт**, например `30854` (выбран случайно).

☑️ Перейдите на вкладку Logs и найдите (CTRL+F) свои уникальные одноразовые данные подключения:

* `ARBITRIUM_PUBLIC_IP` , например IPv4: `172.234.244.38` .

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

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

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

☑️ Убедитесь, что вы открыли сцену: `Assets/Scenes/MainMenu.unity`.

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

* нажмите **НАЧАТЬ С ПРЯМОГО IP** кнопку,
* выберите вкладку **ПОДКЛЮЧИТЬСЯ ПО IP.**

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

☑️ Нажмите **JOIN** кнопку, чтобы подключиться к вашему серверу.

☑️ Подключите второго виртуального игрока с помощью [Multiplayer Play Mode](https://docs-multiplayer.unity3d.com/mppm/current/about/) или [ParrelSync](https://github.com/VeriorPies/ParrelSync).

🙌 Поздравляем с вашим первым развертыванием на Edgegap!

## 🎯 Подбор игроков (необязательно)

Сопоставляйте игроков с [Edgegap Matchmaker](https://docs.edgegap.com/ru/learn/matchmeiking.md) - он группирует игроков, Edgegap запускает сервер рядом с ними, и каждый клиент подключается к нему автоматически. Подбор игроков по умолчанию отключён; включите его, когда прямое подключение заработает.

{% hint style="success" %}
Скрипты подбора игроков находятся в `Assets/Edgegap/` и добавляют себя во время выполнения, поэтому **сцены и префабы Boss Room не изменяются**. См. [EDGEGAP.md](https://github.com/edgegap/netcode-game-sample-unity-ngo-bossroom/blob/main/EDGEGAP.md) для полного списка файлов и параметров командной строки.
{% endhint %}

### 1. Создайте матчмейкер

☑️ Установите `application.name` и `application.version` в ваше приложение и версию в `matchmaker-config.json`.

В конфигурации есть один `casual` профиль для 2–8 игроков. Он заполняется до 8 игроков, когда это возможно, а его [расширение](https://docs.edgegap.com/ru/learn/matchmeiking/matchmaker-in-depth.md#rule-expansion) через 15 секунд позволяет начать с меньшим числом игроков (не менее 2).

☑️ Откройте [Matchmaker](https://app.edgegap.com/matchmaker-management-v2/matchmakers/list) на странице, нажмите **Создать матчмейкер**, загрузите `matchmaker-config.json`, затем нажмите **Создать и запустить**.

☑️ Скопируйте **API URL** и **Auth Token**.

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

### 2. Найдите матч

☑️ Выберите `Assets/Edgegap/Resources/EdgegapSettings.asset` и установите флажок **Use Edgegap Matchmaker**.

☑️ Вставьте свой **API URL** в **URL матчмейкера** и **Auth Token** в **токен авторизации Matchmaker**.

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

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

☑️ Пересоберите клиент и запустите его дважды. Чтобы запустить две копии на одном ПК, задайте каждой свой профиль: `Game.exe -AuthProfile p1` и `Game.exe -AuthProfile p2`.

☑️ Нажмите **Найти матч** на панели слева от главного меню в обоих клиентах.

Статус проходит через поиск, нахождение матча и подключение, затем оба игрока попадают на экран выбора персонажа на одном и том же сервере. Выберите героев и нажмите **Готов** чтобы войти в подземелье вместе.

🙌 Поздравляем с вашим первым развёртыванием с подбором игроков на Edgegap!

{% hint style="warning" %}
Оставьте этап расширения в конфигурации вашего матчмейкера. Без него матчмейкер создаёт только [частичное совпадение](https://docs.edgegap.com/ru/learn/matchmeiking/matchmaker-in-depth.md#partial-matches) когда срок действия тикетов истекает (5 минут).
{% endhint %}

## 🛑 Автоостановка сервера

Вне зависимости от наличия подбора игроков ваш сервер сам завершает своё развертывание, чтобы простаивающие серверы не стоили денег:

* когда никто не присоединяется в течение 120 секунд,
* через 30 секунд после ухода последнего игрока.

Измените эти тайм-ауты с помощью **Секунды тайм-аута первого игрока** и **Секунды тайм-аута пустого сервера** в `EdgegapSettings.asset`. Если запрос на остановку не удаётся, сервер вместо этого завершает работу.

## ✏️ Настройка сборки сервера

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

### Запуск в режиме выделенного сервера

Чтобы этот пример работал как выделенный сервер, мы внесли следующие изменения:

{% tabs %}
{% tab title="Инициализация сервера" %}
Новый скрипт (добавленный в вашу `MainMenu` сцену в новом пустом `GameObject`):

<pre class="language-csharp" data-title="Assets/Scripts/EdgegapServerStarter.cs" data-line-numbers data-collapsed-line-count="10"><code class="lang-csharp">using System;
using System.Collections;
using System.Collections.Generic;
using Unity.BossRoom.ConnectionManagement;
using UnityEngine;

namespace Unity.Multiplayer.Samples.BossRoom
{
    public class EdgegapServerStarter : MonoBehaviour
    {
        // Вызов Start происходит перед первым обновлением кадра
        void Start()
        {
            if (Application.isBatchMode)
            {
                ConnectionManager connectionManager = GameObject.Find("ConnectionManager").GetComponent&#x3C;ConnectionManager>();
<strong>                string internalPortAsStr = Environment.GetEnvironmentVariable($"<a data-footnote-ref href="#user-content-fn-1">ARBITRIUM_PORT_GAMEPORT_INTERNAL</a>");
</strong>
                ushort port;
                if (internalPortAsStr == null)
                {
                    // Не на Edgegap (локальный запуск или запуск в Docker): используйте EdgegapSettings.ListenPort или -edgegapListenPort.
                    port = EdgegapBootstrap.Settings != null ? EdgegapBootstrap.Settings.ListenPort : (ushort)9998;
                    Debug.LogWarning($"Не найден ARBITRIUM_PORT_GAMEPORT_INTERNAL, запуск не на Edgegap: прослушивание на порту {port}.");
                }
                else if (!ushort.TryParse(internalPortAsStr, out port))
                {
                    throw new Exception($"Не удалось найти сопоставление портов, убедитесь, что имя порта версии вашего приложения совпадает с \"{portMapName}\"");
                }

                Debug.Log($"Edgegap Server | Запуск сервера на 0.0.0.0:{port}.");
<strong>                connectionManager.StartHostIp("<a data-footnote-ref href="#user-content-fn-2">SERVER</a>", "0.0.0.0", port);
</strong>            }
        }
    }
}
</code></pre>

{% endtab %}

{% tab title="Управление подключением" %}
Изменённые файлы:

<pre class="language-csharp" data-title="Assets/Scripts/ConnectionManagement/ConnectionMethod.cs" data-collapsed-line-count="10"><code class="lang-csharp"><strong>116        public override async Task SetupHostConnectionAsync()
</strong>117        {
<strong>118            <a data-footnote-ref href="#user-content-fn-3">//SetConnectionPayload(GetPlayerId(), m_PlayerName); // Нужно также задавать полезную нагрузку подключения для хоста, так как хост тоже является клиентом</a>
</strong>119            var utp = (UnityTransport)m_ConnectionManager.NetworkManager.NetworkConfig.NetworkTransport;
120            utp.SetConnectionData(m_Ipaddress, m_Port);
121        }
</code></pre>

<pre class="language-csharp" data-title="Assets/Scripts/ConnectionManagement/ConnectionState/StartingHostState.cs" data-collapsed-line-count="10"><code class="lang-csharp"><strong>66        async void StartHost()
</strong>67        {
              ...

72                // StartHost в NGO запускает всё
<strong>--                <a data-footnote-ref href="#user-content-fn-3">//if (!m_ConnectionManager.NetworkManager.StartHost())</a>
</strong><strong>73                <a data-footnote-ref href="#user-content-fn-4">if (!m_ConnectionManager.NetworkManager.StartServer())</a>
</strong>74                {
75                    StartHostFailed();
76                }

              ...
</code></pre>

<pre class="language-csharp" data-title="Assets/Scripts/Gameplay/GameplayObjects/Character/ClientCharacter.cs" data-collapsed-line-count="10"><code class="lang-csharp"><strong>112        public override void OnNetworkSpawn()
</strong>113        {
               ...

125            m_ServerCharacter.IsStealthy.OnValueChanged += OnStealthyChanged;
126            m_ServerCharacter.MovementStatus.OnValueChanged += OnMovementStatusChanged;
<strong>127            <a data-footnote-ref href="#user-content-fn-3">//OnMovementStatusChanged(MovementStatus.Normal, m_ServerCharacter.MovementStatus.Value);</a>
</strong> 
               ...
</code></pre>

{% endtab %}

{% tab title="Совместимость с редактором/сервером" %}
Измените файлы:

<pre class="language-csharp" data-title="Assets/Scripts/ConnectionManagement/ConnectionState/HostingState.cs" data-collapsed-line-count="10"><code class="lang-csharp"><strong>148        ConnectStatus GetConnectStatus(ConnectionPayload connectionPayload)
</strong>149        {
               ...
                
<strong>155            <a data-footnote-ref href="#user-content-fn-5">//if (connectionPayload.isDebug != Debug.isDebugBuild)</a>
</strong><strong>156            //{
</strong><strong>157            //    return ConnectStatus.IncompatibleBuildType;
</strong><strong>158            //}
</strong>
               ...
</code></pre>

{% endtab %}
{% endtabs %}

[^1]: имя порта по умолчанию на Edgegap — 'gameport'

[^2]: имя игрока для сервера может быть любым значением

[^3]: только p2p ⇒ закомментируйте это

[^4]: вместо этого запускайте как выделенный сервер

[^5]: совместимость с редактором ⇒ закомментируйте это
