> 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).

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Пожалуйста, обратитесь к [официальному репозиторию плагина](https://github.com/edgegap/edgegap-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](/ru/unity.md) чтобы начать и получить подробные инструкции по использованию плагина.
{% endhint %}

<details>

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

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

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

***

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

* Смотрите [#usage-requirements](#usage-requirements "mention"), скорее всего, у вас отсутствуют модули поддержки сборки для Linux, которые можно установить через 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 {ваш код} #endif` .
{% endhint %}

## ⭐ Набор средств разработки

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

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

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

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

<details>

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

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

</details>

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

1. Откройте свой проект Unity,
2. Выберите `Окно > Управление пакетами > Менеджер пакетов` ,
3. Нажмите на :heavy\_plus\_sign: значок и выберите `Добавить пакет из git URL...` ,
4. Когда появится запрос, введите URL нашего SDK:

{% code title="" %}

```
https://github.com/edgegap/edgegap-unity-sdk.git
```

{% endcode %}

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

#### Импортировать примеры

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

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

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

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

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

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

{% hint style="info" %}
Некоторые выпуски могут содержать критические изменения. Это будет обозначено новой MAJOR-версией.
{% endhint %}

#### Обновление до v3

Это обновление включает множество новых [Браузер серверов](/ru/unity/brauzer-serverov.md) утилит и примеров, улучшает обработку ошибок matchmaking и многое другое. См. [Примечания к выпуску](/ru/docs/release-notes.md) полный список.

{% hint style="warning" %}
Обновление Unity SDK v3 включает несколько критических изменений. Пожалуйста, тщательно повторно протестируйте вашу интеграцию.
{% endhint %}

<details>

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

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

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

***

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

1. В редакторе Unity перейдите в **Правка / Параметры / Внешние инструменты / Создать файлы .csproj**.
2. Убедитесь, что включены **Пакеты Git**.
3. Нажмите **Пересоздать файлы проекта**.

</details>

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

## 📫 Библиотека транспортов Distributed Relay

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

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

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