> 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/arena-shooter.md).

# Арена-шутер

Разместите многопользовательский арена-шутер для Godot 4 на Edgegap с выделенными серверами и подбором матчей, используя образец Edgegap Arena Shooter.

Узнайте, как размещать проекты Godot на Edgegap, используя техники из [Super Star Fighter](https://github.com/DumpsterFireLabs/SuperStarFighter) top-down шутера-арены от Dumpster Fire Labs.

Игроки нажимают **FIND MATCH**, [Edgegap Matchmaker](https://docs.edgegap.com/ru/learn/matchmeiking.md) группирует их и запускает выделенный сервер рядом с ними, а сервер останавливается сам, когда матч заканчивается.

Этот пример показывает:

* **Godot 4.7.2** игру на GDScript, экспортированную как выделенный Linux-сервер без интерфейса,
* **сетевая архитектура с авторитетом сервера** через один порт WebSocket — сервер выполняет всю симуляцию, а клиенты подключаются через `wss://`,
* **Edgegap Matchmaker** интеграцию — клиент создаёт билет, ждёт сервер, затем подключается к нему,
* **автоостановка сервера** — сервер завершает собственное развёртывание после матча или когда никто не подключается,
* **заполнение NPC** — NPC занимают пустые места, так что даже одиночный игрок всё равно получает матч.

{% hint style="success" %}
Смотрите [EDGEGAP.md](https://github.com/edgegap/game-sample-godot-arena-shooter/blob/main/EDGEGAP.md) в репозитории примера для полного списка файлов Edgegap и настроек сервера.
{% endhint %}

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

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

* [проект Arena Shooter Sample](https://github.com/edgegap/game-sample-godot-arena-shooter) (изменённый для Edgegap),
* Godot 4.7.2 — пример скачает свою собственную копию (см. ниже),
* Python 3 — для запуска скрипта сборки примера.

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

☑️ Скачайте закреплённую версию Godot и шаблоны экспорта в игнорируемую `.tools` папку из PowerShell в корне вашего репозитория:

{% code collapsedlinecount="10" %}

```powershell
.\tools\bootstrap.ps1
```

{% endcode %}

Ничего не устанавливается в систему глобально.

## ⚡ Развернуть и подключиться

### 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`.

☑️ Экспортируйте выделенный Linux-сервер, затем соберите и отправьте свой образ:

{% code collapsedlinecount="10" %}

```bash
python tools/build.py bootstrap
python tools/build.py build server-linux-x64 --skip-gate
docker build --platform linux/amd64 -f edgegap/Dockerfile -t registry.edgegap.com/<project>/arena-shooter:<tag> builds/beta-19/server-linux-x86_64
docker push registry.edgegap.com/<project>/arena-shooter:<tag>
```

{% endcode %}

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

Ваш сервер слушает на порту WebSocket `7000`. Вне развёртывания Edgegap он ведёт себя точно так же, как и исходная игра.

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

### 2. Создайте версию приложения

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

* ваш `registry.edgegap.com/<project>/arena-shooter:<tag>` образ,
* ваше имя пользователя и токен Container Registry, чтобы Edgegap мог получить ваш образ,
* ресурсы: 0.5 vCPU и 1 ГБ памяти,
* [порт](https://docs.edgegap.com/ru/learn/orkestraciya/application-and-versions.md#port-mapping) `7000`, именованный `gameport`, протокол **WS**, с **включённым TLS Upgrade** .

{% hint style="warning" %}
Клиенты подключаются через `wss://`, поэтому **TLS Upgrade должен быть включён**, иначе клиенты не смогут подключиться. См. [Websockets (WS) и Secure Websockets (WSS)](https://docs.edgegap.com/ru/learn/orkestraciya/deployments.md#websockets-ws-and-secure-websockets-wss).
{% endhint %}

При желании задайте переменные окружения для версии приложения:

* `EDGEGAP_NPC_FILL` — заполнить матч NPC до указанного количества кораблей (по умолчанию `4`, `0` отключает NPC),
* `EDGEGAP_START_GRACE` — количество секунд ожидания всех сопоставленных игроков после подключения первого (по умолчанию `30`),
* `EDGEGAP_JOIN_TIMEOUT` — количество секунд до самостановки пустого сервера (по умолчанию `120`),
* `EDGEGAP_ROUNDS_TO_WIN` — количество раундов, необходимых для победы в матче (по умолчанию `3`).

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

### 3. Создайте Matchmaker

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

☑️ Загрузите `edgegap/matchmaker-config.json` из примера. Измените `application.name` и `application.version` если у вас они другие.

В конфигурации есть один `casual` профиль для 2–4 игроков. После 30 секунд ожидания один игрок может быть подобран в одиночку.

☑️ Нажмите **Создать и запустить**, и дождитесь, пока ваш matchmaker будет готов.

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

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

### 4. Подключите клиент

☑️ Вставьте URL вашего matchmaker и Auth Token в `src/client/edgegap/edgegap_settings.gd`:

{% code collapsedlinecount="10" %}

```gdscript
const MATCHMAKER_URL := "https://<your-matchmaker-url>"
const MATCHMAKER_AUTH_TOKEN := "<your-auth-token>"
```

{% endcode %}

Вы также можете задать `EDGEGAP_MATCHMAKER_URL` и `EDGEGAP_MATCHMAKER_TOKEN` переменные окружения при запуске клиента.

{% hint style="info" %}
Auth Token принадлежит вашему matchmaker и не даёт доступа к вашей учётной записи Edgegap, поэтому его безопасно включать в игровые клиенты. **Никогда не помещайте свой токен API Edgegap в клиент.**
{% endhint %}

☑️ Соберите Windows-клиент с помощью `python tools/build.py build windows --skip-gate`, или запустите `.\tools\start-client.ps1`.

☑️ Запустите два клиента и нажмите **FIND MATCH** в обоих.

Оба клиента получают один и тот же сервер и подключаются к нему. Матч начинается, когда все сопоставленные игроки подключились, или через 30 секунд после подключения первого, а пустые места заполняются NPC.

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

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

1. Клиент создаёт билет с `casual` профилем, затем проверяет его каждые 2 секунды, пока не будет назначен сервер.
2. Matchmaker развёртывает `godot-arena-shooter` рядом с игроками. Сервер считывает, сколько игроков было сопоставлено, из [`MM_TICKET_IDS`](https://docs.edgegap.com/ru/learn/matchmeiking/matchmaker-in-depth.md#injected-variables).
3. Клиент подключается к `wss://<host>:<external port>` через код Direct Connect игры. Пароль лобби — это request ID развёртывания, поэтому войти могут только сопоставленные игроки.
4. Сервер запускает матч и заполняет пустые места NPC, до 4 кораблей.
5. Через 20 секунд после финальных результатов сервер вызывает `ARBITRIUM_DELETE_URL` чтобы остановить своё развёртывание. Он также останавливается, если никто не подключается в течение 120 секунд, или если все вышли на 30 секунд.

Каждое развёртывание запускает один матч. После матча игроки нажимают **FIND MATCH** снова.

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

## 🎵 Изменения по сравнению с исходным проектом

Лицензия на исходные ресурсы сохраняет название игры, музыку и логотип студии только для неизменённых сборок. Этот форк переименован в Edgegap Arena Shooter, а музыка и логотип удалены. Звуковые эффекты генерируются в коде и по-прежнему воспроизводятся.
