> 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/tools-and-integrations/razvertyvanie-iz-nakama.md).

# Развертывание из Nakama

Объедините Nakama с Edgegap, чтобы обеспечивать стабильный онлайн-многопользовательский опыт — от инди-проектов до AAA-игр.

Игроки в многопользовательские игры ожидают одинаково высокого качества онлайн-опыта — от инди до AAA — независимо от того, играют ли они в Нью-Йорке или Джакарте.

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

Развертывайте выделенные игровые серверы для популярных игровых движков или собственных движков, полностью интегрированные с открытыми сервисами данных игроков и игровыми сервисами Nakama, для удобного готового решения.

{% hint style="success" %}
Это проверенное решение, совместно поддерживаемое независимым партнером — [Heroic Labs](https://heroiclabs.com).
{% endhint %}

## 🚀 Начало работы

Интеграция между Nakama (от Heroic Labs) и Edgegap призвана упростить процесс развертывания масштабируемых игровых серверов с низкой задержкой. Вот обзор того, как это работает:

1. **Подбор матчей и управление игроками с помощью Nakama**: [Nakama обрабатывает учетные записи пользователей, подбор матчей и управление данными игроков](https://heroiclabs.com/docs/nakama/getting-started/index.html), используя надежную архитектуру для поддержки взаимодействия между игроками в реальном времени. Как только Nakama определяет, что матч должен начаться, он запускает игровой экземпляр на Edgegap.
2. **Динамическое развертывание серверов с Edgegap**: Edgegap получает запрос от Nakama и [развертывает экземпляр сервера в оптимальном месте](https://docs.edgegap.com/ru/learn/orkestraciya/deployments.md) на основе данных в реальном времени, таких как местоположение игроков и информация об их устройствах. Это обеспечивает близость игровых серверов к игрокам, минимизируя задержку и создавая плавный игровой опыт.
3. **Связь в реальном времени**: Интеграция обеспечивает бесшовную связь между игровым backend Nakama и сетью развертывания Edgegap. Nakama предоставляет подбор матчей, систему лобби и общие функции мета-игрового процесса, тогда как Edgegap обеспечивает максимально эффективную работу основного игрового цикла (запущенного на безголовом игровом движке, таком как Unity), где бы ни находились игроки. Связь между Edgegap и Nakama означает, что игроки могут лучше подбирать друг друга в матчах, а также присоединяться к существующим или новым матчам, работающим на Edgegap.
4. **Масштабируемость и управление нагрузкой**: Система Edgegap динамически увеличивает или уменьшает ресурсы в зависимости от спроса игроков, а Nakama масштабируется для обслуживания миллионов пользователей даже в пиковые периоды. Такое сочетание позволяет разработчикам поддерживать стабильную производительность во время всплесков трафика, не резервируя лишние ресурсы.

<figure><img src="https://3845012722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsR0dHSFv9ymoC0DO5G8J%2Fuploads%2FeeqFSOPBIvtytnPI2neT%2Fimage.png?alt=media&amp;token=96127320-d7bd-4a66-a5df-cea0cf886d25" alt=""><figcaption></figcaption></figure>

## ⚡ Интеграция

{% hint style="info" %}
**Версия Nakama**: [плагин nakama-edgegap](https://github.com/edgegap/backend-nakama-edgegap-plugin) поддерживает **Nakama 3.41.0**. Соберите свой Go-модуль с `heroiclabs/nakama-pluginbuilder:3.41.0` и `github.com/heroiclabs/nakama-common v1.48.0` (Go 1.27.1) — версии, требуемые Nakama 3.41.0.
{% endhint %}

☑️ **Установите и настройте Nakama**: [Начните с настройки Nakama в качестве backend вашего игры](https://heroiclabs.com/docs/nakama/getting-started/install/). Настройте его для обработки учетных записей пользователей, подбора матчей, многопользовательских сессий и другой игровой логики:

* API развертывания V2 [Heroic Cloud](https://heroiclabs.com/heroic-cloud/), [создайте новый Builder](https://heroiclabs.com/docs/heroic-cloud/concepts/builders/) с использованием [репозитория плагина nakama-edgegap](https://github.com/edgegap/backend-nakama-edgegap-plugin),
* API развертывания V2 [самостоятельно размещаемый Nakama](https://docs.edgegap.com/ru/learn/advanced-features/managed-clusters.md#nakama-by-heroic-labs), [следуйте инструкциям по использованию плагина, чтобы собрать образ локально](https://github.com/edgegap/backend-nakama-edgegap-plugin?tab=readme-ov-file#usage)

☑️ **Зарегистрируйтесь в Edgegap**: [Зарегистрируйтесь на веб-платформе Edgegap](https://app.edgegap.com/auth/register) чтобы загрузить образ вашего выделенного сервера и получить API-ключи и секреты, необходимые для следующего шага. Хостинг Edgegap бесплатен на этапе разработки благодаря бесплатному пробному периоду, а его гибкая, без обязательств, конкурентная оплата поминутно гарантирует, что студии платят только тогда, когда игроки активны, без авансовых затрат или фиксированной ежемесячной платы:

* [Начало работы с серверами (Unity)](https://docs.edgegap.com/ru/unity.md),
* [Начало работы с серверами (Unreal Engine)](https://docs.edgegap.com/ru/unreal-engine.md).

☑️ **Подключите Nakama к Edgegap**: Используйте реализацию FleetManager в Nakama для подключения к сервису развертывания Edgegap. Следуйте [руководству по интеграции Heroic Labs](https://heroiclabs.com/docs/nakama/guides/concepts/edgegap-integration/) чтобы настроить оба сервиса, и смотрите [README плагина](https://github.com/edgegap/backend-nakama-edgegap-plugin?tab=readme-ov-file#nakama-setup) для каждого переменного окружения.

🙌 Поздравляем с интеграцией Nakama с развертываниями Edgegap!

{% hint style="success" %}
**Автоматизируйте интеграцию игрового сервера** с помощью [плагина Edgegap Server Nakama для Unity](https://github.com/edgegap/backend-nakama-unity-template-model).
{% endhint %}

{% hint style="success" %}
См. [Nakama Fish Game](https://docs.edgegap.com/ru/docs/sample-projects/godot/nakama-fish-game.md) для **полного примера Godot 4** с подбором матчей Nakama.
{% endhint %}

## 🚨 Устранение неполадок

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