> 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/unity/developer-tools.md).

# Инструменты разработчика

Инструменты разработчика Edgegap для Unity, созданные для быстрой итерации и частого развертывания ваших игровых серверов.

Мы создаём эти инструменты для вас, руководствуясь простым принципом: «ключ к успешным командам — быстрая итерация и частое тестирование». Если вы видите возможность улучшения, пожалуйста, сообщите нам в нашем [Discord сообщества](https://discord.gg/NgCnkHbsGp). Надеемся, вам понравится плавная работа. 🚀

{% hint style="info" %}
[Найдите реальные примеры](https://docs.edgegap.com/ru/docs/sample-projects/unity-netcodes.md) которые можно использовать как основу проекта и далее дорабатывать.
{% endhint %}

#### Семантическое версионирование

Наши инструменты разработчика и управляемые сервисы используют официальную [Семантическое версионирование](https://semver.org/), указывая, какие обновления ✅ безопасны (минорные, патч), а какие могут содержать ⚠️ ломающие изменения (мажорные).

**После выпуска версии она никогда не будет модифицирована/изменена**.

{% hint style="warning" %}
**Чтобы обновить версию сервиса — остановите, измените, перезапустите.** Быстрый перезапуск не применит изменения версии.
{% endhint %}

## ⚡ Плагин быстрого старта Dedicated Servers

Соберите и запустите ваш выделенный игровой сервер в облаке прямо из Unity Editor!

* [Плагин Dedicated Servers для Unity — готовое решение, исходный код и полные примечания к выпуску.](https://github.com/edgegap/buildtool-unity-plugin)

{% hint style="success" %}
Этот плагин предоставляется на 100% бесплатно, в соответствии с Условиями и положениями бесплатного тарифа.
{% endhint %}

Официально поддерживаются все версии Unity3D Long Term Support (LTS) начиная с 2021.3+.

Этот плагин содержит функции, предназначенные помочь вам:

* собирать и контейнеризировать ваши выделенные серверы для Linux,
* локально тестировать docker-образ вашего сервера,
* загружать и развёртывать ваш сервер на Edgegap.

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

#### Установка

Пожалуйста, обратитесь к [официальному репозиторию плагинов](https://github.com/edgegap/buildtool-unity-plugin) за подробными инструкциями по установке.

Этот плагин был протестирован и поддерживает версии Unity 2021.2+, включая все выпуски LTS, Unity 2023 и Unity 6.

{% embed url="<https://youtu.be/3a5veDyxpoE>" %}

<details>

<summary>Установите модули поддержки сборки Unity для Linux</summary>

* Используйте Unity Hub, чтобы выбрать вкладку **Устанавливает**, доступ **Настройки** и **Добавить модули** для каждой версии Unity, которую вы планируете использовать с платформой Edgegap:

<figure><img src="https://3845012722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsR0dHSFv9ymoC0DO5G8J%2Fuploads%2FylRG4r8orenZrw5ijjpJ%2Fimage.png?alt=media&amp;token=fb981825-8a15-4c07-9180-0f79a6a77a91" alt=""><figcaption></figcaption></figure>

* Прокрутите вниз, чтобы выбрать и установить следующие модули Unity:
  * **Поддержка сборки для Linux (IL2CPP),**
    * **Поддержка сборки для Linux (Mono),**
    * **Поддержка сборки выделенного сервера для Linux**

<figure><img src="https://3845012722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsR0dHSFv9ymoC0DO5G8J%2Fuploads%2FuXtyqoLhBOk8CZJ4WdzA%2Fimage.png?alt=media&amp;token=19e956ed-a731-420d-b911-130c334794fc" alt=""><figcaption></figcaption></figure>

</details>

<details>

<summary><a href="https://www.docker.com/products/docker-desktop/">Установите Docker Desktop (или Docker CLI)</a></summary>

* [Установите Docker Desktop из официального источника](https://www.docker.com/products/docker-desktop/) (аккаунт не требуется).
* Перезагрузите компьютер после завершения установки.

</details>

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

<details>

<summary>Устранение неполадок и FAQ</summary>

Ошибка Unity: `[Окно Package Manager] Ошибка при добавлении пакета: https://github.com/edgegap/buildtool-unity-plugin.git`

* Чтобы добавить наш плагин через git URL, вам потребуется установленный git-клиент ([#installation](#installation "mention")).

***

Ошибка Unity: `Отсутствует поддержка сборки для Linux`

* См. [#usage-requirements](#usage-requirements "mention"), у вас, скорее всего, отсутствуют модули Linux Build Support, которые можно установить через Unity Hub. Убедитесь, что выбрали ту же версию Unity, что и в вашем проекте.

</details>

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

{% hint style="info" %}
**Для разработчиков плагинов** - если вы хотите определить наличие этого плагина в редакторе пользователя, это можно сделать с помощью директивы компилятора `#if EDGEGAP_PLUGIN_SERVERS {your code} #endif` .
{% endhint %}

## ⭐ SDK (комплект средств разработки ПО)

Unity SDK содержит дополнительные утилиты интеграции с Deployments, Matchmaking и Server Browser. Этот плагин официально поддерживает Unity версии 2021.3.0f1 и выше.

{% hint style="info" %}
**Последняя версия Unity SDK — `3.5.6`**. Все примеры в этой документации актуальны.
{% endhint %}

{% hint style="success" %}
Этот плагин предоставляется совершенно бесплатно в соответствии с условиями бесплатного тарифа.
{% endhint %}

#### Требования

<details>

<summary>Установите Git-клиент (например, <a href="https://git-scm.com/">git-scm</a>)</summary>

Git-клиент нужен, чтобы Unity могла автоматически скачать и установить наш пакет. После установки вам не придётся пользоваться Git напрямую.

</details>

#### Установка

1. Откройте проект Unity,
2. выберите `Window > Package Management > Package Manager` ,
3. Нажмите значок :heavy\_plus\_sign: и выберите `Add package from git URL...` ,
4. Когда появится запрос, введите URL нашего SDK:

{% code title="" collapsedlinecount="10" %}

```
https://github.com/edgegap/sdk-unity-sessions-matchmaker-server-browser.git
```

{% endcode %}

5. Нажмите `Add`  и дождитесь завершения установки.

#### Импорт примеров

Пакет включает несколько примеров, предназначенных для использования по отдельности (не объединяйте примеры).

#### Проверенные источники

Это единственный официальный канал распространения данного SDK. Не доверяйте непроверенным источникам!

#### Обновление пакета

Откройте Edgegap SDK в Unity Package Manager и нажмите `Update` .

{% hint style="warning" %}
**Импортированные примеры не обновляются автоматически!** Сохраните резервную копию всех пользовательских значений свойств, удалите скрипты примеров, используемые в текущей сцене, и импортируйте примеры заново.
{% endhint %}

{% hint style="info" %}
В некоторых выпусках могут быть несовместимые изменения. Об этом будет свидетельствовать новый номер версии MAJOR.
{% endhint %}

#### Обновление до версии 3

В этом обновлении появилось множество новых [Браузер серверов](https://docs.edgegap.com/ru/unity/server-browser.md) утилит и примеров, улучшена обработка ошибок подбора игроков и многое другое. Полный список см. в [Примечания к релизам](https://docs.edgegap.com/ru/docs/release-notes.md) .

{% hint style="warning" %}
В обновлении Unity SDK до версии 3 есть несколько несовместимых изменений. Тщательно протестируйте интеграцию повторно.
{% endhint %}

<details>

<summary>Несовместимые изменения в Unity SDK v3: область действия, влияние и устранение</summary>

В пространстве имён `Edgegap.Matchmaking`:

* Объединённый метод `Client._Abandon -> Client.StopMatchmaking` .
  * Низкое влияние — затрагивает преимущественно пользовательские реализации обработчика клиента.
  * Решение — замените вызовы `_Abandon` на вызовы `StopMatchmaking` .
* Объединённый обработчик события `onTicketUpdate -> onAssignmentUpdate`.
  * Низкое влияние — большинству реализаций этот обработчик не требовался.
  * Решение — найдите и замените на [новые события](https://docs.edgegap.com/unity/matchmaking#client-events) в разделе `onAssignmentUpdate` прослушивателя.
* Отвязано `Ping` , `SafeHttpRequest`  и `Observable` . Перенесено в пространство имён `Edgegap` .
  * Низкое влияние — функциональность осталась прежней, изменилось только пространство имён.
  * Решение — при необходимости обновите инструкции импорта или ссылки с указанием пространства имён.
* Функция кэширования удалена из-за низкой совместимости с консольными платформами и сложностей при первоначальной настройке.
  * Низкое влияние — у игроков, чей игровой процесс прервался из-за сбоя, могут создаваться повторные заявки вместо возобновления из кэша.
  * Решение — реализуйте собственное кэширование с помощью `onAssignmentUpdate` прослушивателя события.
* Имя сборки изменено `com.edgegap.unity-matchmaking-sdk -> com.edgegap.unity-sdk` .
  * Низкое влияние — затронуты некоторые пользовательские конвейеры сборки, в которых используются ссылки на эту SDK.
  * Решение — обновите ссылки на имя сборки SDK в своих пользовательских инструментах.

</details>

<details>

<summary>Устранение неполадок и FAQ</summary>

Unity: `[Окно Package Manager] Ошибка при добавлении пакета: https://github.com/edgegap/sdk-unity-sessions-matchmaker-server-browser.git`

* Чтобы добавить наш плагин через git URL, вам потребуется установленный git-клиент.

***

Visual Studio: `имя типа или пространства имён не найдено` для пространства имён Edgegap.

1. В редакторе Unity перейдите в **Edit / Preferences / External Tools / Generate .csproj files**.
2. Убедитесь, что включено **Git packages**.
3. Нажмите **Regenerate project files**.

</details>

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

## 📫 Библиотека распределённых Relay-транспортов

Найдите собственный Transport для вашей netcode-библиотеки, чтобы использовать Distributed Relays в играх peer-to-peer.

[Смотреть документацию](https://docs.edgegap.com/ru/learn/distributed-relay/relay-transport-samples.md):

* Скачать примеры Edgegap Relay:
  * [Пример Mirror](https://github.com/edgegap/relay-sample-unity-mirror-),
  * [пример FishNet](https://github.com/edgegap/relay-sample-unity-fishnet-),
  * [пример Unity NGO](https://github.com/edgegap/relay-sample-unity-ngo-helloworld).
* [Библиотека Edgegap Relay Transport — исходный код и примечания к выпуску для поддерживаемых netcode.](https://github.com/edgegap/relay-transport-template-model)
