> 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/godot/nakama-fish-game.md).

# Nakama Fish Game

Разместите Fish Game от Heroic Labs для Godot 4 на выделенных серверах Edgegap; запуск осуществляется матчмейкером Nakama через плагин nakama-edgegap.

Узнайте, как размещать проекты Godot на Edgegap с [Nakama](https://heroiclabs.com) подбором матчей, используя техники из [Fish Game](https://github.com/heroiclabs/fishgame-godot) образца для 2–4 игроков от Heroic Labs, портированного на Godot 4.

В оригинале каждый матч выполнялся на машине одного игрока и ретранслировался через Nakama. В [нашем форке](https://github.com/edgegap/backend-game-sample-godot-nakama-fishgame) нет хостов среди игроков — Nakama ведёт учётные записи, подбор матчей и таблицу лидеров, а также запускает headless-сервер Godot рядом с подобранными игроками через [Edgegap Fleet Manager для Nakama](https://github.com/edgegap/backend-nakama-edgegap-plugin).

В этом примере показано:

* **Godot 4.7** игру на GDScript, работающую как выделенный headless-сервер через ENet на UDP-порту `7777`,
* **Nakama 3.39** с модулем Go — хук подборщика матчей запускает одно развертывание на каждый матч и отправляет каждому игроку адрес сервера, как только сервер сообщает `READY`,
* **правила матча с авторитетным сервером** - сервер определяет попадания, смерти, подбираемые предметы, спавны, раунды и победителя,
* **проверки игрока** - сервер допускает только игроков с действительной сессией Nakama, которые были сопоставлены с ним,
* **таблица лидеров между серверами** - сервер записывает победу в авторитетную таблицу лидеров Nakama, в которую игроки не могут писать,
* **автоостановка сервера** - сервер просит Nakama остановить его развертывание, когда матч завершён.

{% hint style="success" %}
См. [Развертывание из Nakama](https://docs.edgegap.com/ru/docs/tools-and-integrations/razvertyvanie-iz-nakama.md) для обзора интеграции Nakama, а [EDGEGAP.md](https://github.com/edgegap/backend-game-sample-godot-nakama-fishgame/blob/main/EDGEGAP.md) в репозитории примера — полный список файлов Edgegap, тестов и известных ограничений.
{% endhint %}

{% hint style="warning" %}
Большая часть графики и музыки игры лицензирована [CC BY-NC 4.0](https://creativecommons.org/licenses/by-nc/4.0/) Heroic Labs (см. `assets/LICENSE.txt`). Код распространяется по лицензии Apache 2.0.
{% endhint %}

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

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

* [Пример проекта Fish Game](https://github.com/edgegap/backend-game-sample-godot-nakama-fishgame) (изменённый для Edgegap),
* [Godot 4.7](https://godotengine.org/) (подойдёт версия 4.3 или новее),
* токен API Edgegap — только для Nakama,
* публичный HTTPS-адрес для Nakama — серверы Edgegap вызывают Nakama обратно, поэтому `localhost` не подойдёт (для тестирования достаточно туннеля, см. шаг 2).

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

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

### 1. Соберите образ сервера

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

☑️ Найдите свой [Container Registry](https://docs.edgegap.com/ru/learn/advanced-features/edgegap-container-registry.md#getting-your-credentials) имя проекта и учетные данные, затем войдите с помощью `docker login registry.edgegap.com`.

☑️ Соберите и отправьте образ сервера из корня репозитория. `server/Dockerfile` экспортирует пресет «Linux Server» в `.pck` и запускает его с headless Godot:

{% code collapsedlinecount="10" %}

```bash
docker build --platform linux/amd64 -f server/Dockerfile -t registry.edgegap.com/<project>/fishgame-godot:1.0.0 .
docker push registry.edgegap.com/<project>/fishgame-godot:1.0.0
```

{% endcode %}

{% hint style="danger" %}
:x: **НЕ ДЕЛАЙТЕ — не перезаписывайте существующие теги и не используйте `latest`  тег** — это приведёт к развёртыванию устаревшего кэша.\
:white\_check\_mark: **ДЕЛАЙТЕ — всегда увеличивайте номер версии в теге** и развёртывайте новую сборку.
{% endhint %}

☑️ [Создайте приложение](https://app.edgegap.com/application-management/applications/list) под названием `fishgame-godot`, и версию с именем `1.0.0` со следующими параметрами:

* образ `<project>/fishgame-godot`, тег `1.0.0`, с вашим именем пользователя и токеном реестра,
* ресурсы 0,5 vCPU и 512 МБ памяти,
* [порт](https://docs.edgegap.com/ru/learn/orkestraciya/application-and-versions.md#port-mapping) `7777`, имя `gameport`, протокол **UDP**,
* [максимальная длительность](https://docs.edgegap.com/ru/learn/orkestraciya/application-and-versions.md#safety-guardrails) 30 минут (сервер также останавливается сам).

Вашему серверу не нужны собственные переменные окружения — Fleet Manager передаёт ему callback-URL Nakama при каждом развертывании.

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

### 2. Запустите Nakama

☑️ Скопируйте `nakama/.env.example` на `nakama/.env` и заполните:

* `EDGEGAP_API_TOKEN` - ваш токен API Edgegap, с его `token` префиксом,
* `EDGEGAP_APPLICATION`, `INITIAL_EDGEGAP_VERSION`, `EDGEGAP_PORT_NAME` - название приложения, версия и имя порта из шага 1,
* `NAKAMA_ACCESS_URL` - публичный HTTPS-адрес Nakama,
* `NAKAMA_HTTP_KEY` - длинная случайная строка, игровые серверы получают её внутри своих callback-URL.

{% hint style="danger" %}
Ваш токен API Edgegap даёт доступ ко всей вашей организации. Храните его в `nakama/.env` и только Nakama. **Никогда не помещайте его в клиент игры или образ сервера.**
{% endhint %}

☑️ Для тестирования на своей машине запустите быстрый туннель Cloudflare, чтобы дать Nakama публичный адрес. Вставьте напечатанный `https://….trycloudflare.com` URL в `NAKAMA_ACCESS_URL`:

{% code collapsedlinecount="10" %}

```bash
docker run -d --name fishgame-tunnel cloudflare/cloudflared:latest tunnel --no-autoupdate --url http://host.docker.internal:7350
```

{% endcode %}

☑️ Запустите Nakama и Postgres. `nakama/Dockerfile` собирает модуль Go с Edgegap Fleet Manager в Nakama:

{% code collapsedlinecount="10" %}

```bash
docker compose -p fishgame -f nakama/docker-compose.yml up -d --build
```

{% endcode %}

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

### 3. Играйте

☑️ Укажите в игре Nakama, отредактировав значения по умолчанию в начале `autoload/Online.gd`, или в командной строке:

{% code collapsedlinecount="10" %}

```bash
godot --path . -- --nakama-host=your-tunnel.trycloudflare.com --nakama-port=443 --nakama-scheme=https
```

{% endcode %}

{% hint style="info" %}
Игроки тоже должны обращаться к Nakama через его публичный адрес. Nakama сохраняет IP, с которого входит каждый игрок, а Edgegap использует эти IP, чтобы [развертывать ближе к игрокам](https://docs.edgegap.com/ru/learn/orkestraciya/deployments.md#server-placement).
{% endhint %}

☑️ Запустите два экземпляра игры, выберите **Онлайн**, создайте в каждом аккаунт и нажмите **Матч** в обоих.

После «Match found! Starting a game server...» оба игрока попадают на экран готовности одного и того же сервера Edgegap. Первая рыба, выигравшая 5 раундов, выигрывает матч и получает +1 в таблице лидеров.

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

## 🔄 Жизненный цикл матча

1. Игроки входят в Nakama по электронной почте, затем отправляют заявку в подборщик матчей.
2. Когда Nakama сопоставляет их, хук подборщика модуля просит Fleet Manager создать развертывание, передавая сопоставленные ID пользователей в его метаданных.
3. Игровой сервер запускается, слушает UDP `7777`, и отправляет `READY` в Nakama со своим IP и внешним портом. Nakama уведомляет каждого сопоставленного игрока адресом сервера.
4. Игроки подключаются через ENet. Сервер проверяет сессию Nakama каждого игрока с помощью `/v2/account` и принимает только игроков, сопоставленных с ним. Он сообщает Nakama ID подключённых пользователей каждые 5 секунд, когда они меняются.
5. Когда матч выигран, сервер вызывает `report_match_result` RPC между серверами с HTTP-ключом Nakama, а Nakama добавляет победу в `fish_game_wins` таблицу лидеров. RPC отклоняет сессии игроков и учитывает каждое развертывание только один раз.
6. Сервер отправляет `STOP`, и Nakama останавливает развертывание. Оно также останавливается, когда в середине матча остаётся меньше 2 игроков, когда все уходят, когда никто не присоединяется в течение 60 секунд или через 20 минут.

Каждый игрок по-прежнему управляет движением своей рыбы, как и в оригинале. Перенос управления движением на сервер с клиентским предсказанием — следующий шаг для соревновательной игры.

См. [Развертывание из Nakama](https://docs.edgegap.com/ru/docs/tools-and-integrations/razvertyvanie-iz-nakama.md), [Матчмейкинг](https://docs.edgegap.com/ru/learn/matchmeiking.md) и [Развертывания](https://docs.edgegap.com/ru/learn/orkestraciya/deployments.md) чтобы узнать больше.

## ⚠️ Известные проблемы

* HTML5-экспорт не может играть онлайн — ENet использует UDP, который браузеры не могут использовать. Веб-сборке потребуется WebSocket peer Godot и [WS-порт с обновлением TLS](https://docs.edgegap.com/ru/learn/orkestraciya/deployments.md#websockets-ws-and-secure-websockets-wss).
