> 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/veb-igry/fal-ai-relic-rumble.md).

# Relic Rumble на fal.ai

Создайте многопользовательскую игру на fal.ai с помощью edgegap: игру на three.js, написанную агентом для программирования, с 3D-персонажами, предметами и звуками, сгенерированными fal, подбором игроков и одним авторитетным сервером node.js для каждого матча.

Узнайте, как разместить сетевые ресурсы игры, созданной с помощью [fal.ai](https://fal.ai/) , для многопользовательской игры по сети на Edgegap.

![Relic Rumble: четыре персонажа, созданных с помощью fal, в матче](https://raw.githubusercontent.com/edgegap/netcode-sample-fal-relic-rumble/main/docs/images/gameplay.jpg)

Relic Rumble — это [three.js](https://threejs.org/) вечеринка-игра для 4 игроков: схватите реликвию, отнесите её в свой угол и оттолкните всех, кто попытается сделать то же самое. Код написал ИИ-агент, а fal.ai сгенерировал всё, что вы видите и слышите: четырёх персонажей с риггингом и анимациями ходьбы и бега, предметы, пол и звуки.

* **fal.ai**: используется во время разработки игры для генерации её ресурсов.
* **Edgegap**: используется во время игры — для подбора игроков и запуска выделенного сервера для каждого матча рядом с его участниками.

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

* **Правила в одном файле**: `client/rules.js` не содержит браузерного кода, поэтому страница выполняет его для одиночной игры, а игровой сервер использует тот же файл для сетевой игры.
* **Ресурсы остаются на странице**: сервер представляет персонажей в виде кругов, а столбы — в виде прямоугольных параллелепипедов. В образ сервера не включаются модели, текстуры и звуки, а для добавления новых визуальных ресурсов не требуется выпускать новую версию сервера.
* **Любой ресурс можно не использовать**: с пустым файлом `client/assets.js` игра отображает простые фигуры. Пример был создан и протестирован в сетевом режиме именно так, ещё до генерации ресурсов.
* **Процесс генерации в fal**: сначала концепт-изображение для каждого персонажа, затем преобразование изображения в 3D-модель с риггингом. Все промпты, модели и цены приведены в файле примера `PROMPTS.md`.
* **Найти матч прямо со страницы** с помощью [JavaScript SDK Edgegap](https://www.npmjs.com/package/@edgegap/sdk): от 2 до 4 игроков в матче, а боты занимают свободные места.

{% hint style="info" %}
См. [репозиторий примера](https://github.com/edgegap/netcode-sample-fal-relic-rumble) с игрой, скриптами и промптами fal, игровым сервером и сквозным тестом всего процесса.
{% endhint %}

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

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

* [пример fal.ai Relic Rumble](https://github.com/edgegap/netcode-sample-fal-relic-rumble), загруженный в ваш собственный репозиторий GitHub.
* [Node.js](https://nodejs.org/) версии 22 или новее — для локального запуска сервера и страницы.
* Чтобы сгенерировать собственные ресурсы, понадобятся [учётная запись fal.ai](https://fal.ai/dashboard) с несколькими долларами на балансе и CLI fal `genmedia` или [MCP-сервер fal](https://fal.ai/mcp) , подключённый к вашему ИИ-агенту для программирования. Ресурсы примера уже включены, поэтому это необязательно.

☑️ Сначала запустите игру локально:

{% code collapsedlinecount="10" %}

```bash
npm install
npm run test:local
npm run client
```

{% endcode %}

`npm run test:local` запускает полноценный матч с двумя безголовыми игроками на локальном сервере. Откройте `http://localhost:8080` и нажмите **Играть против ботов** , чтобы играть в одиночку.

☑️ Чтобы играть онлайн на своём компьютере, запустите `npm run server` во втором терминале, затем нажмите **Локальный сервер :7777** в двух вкладках браузера.

## 🎨 Генерация ресурсов с помощью fal.ai

### 1. Персонажи, предметы и звуки

☑️ Создайте по одному концепт-изображению для каждого персонажа. Запросите изображение в полный рост, в A-позе, с отведёнными от тела руками и пустыми ладонями, чтобы персонажа можно было автоматически оснастить скелетом:

{% code collapsedlinecount="10" %}

```bash
bash art/gen-concepts.sh
```

{% endcode %}

☑️ Преобразуйте каждое изображение в 3D-модель со скелетом. Результат включает модель и отдельные анимации ходьбы и бега:

{% code collapsedlinecount="10" %}

```bash
genmedia run meshy/v7.1/image-to-3d --image_url "<concept url>" --enable_rigging true --pose_mode "a-pose" --target_polycount 12000 --async --json
genmedia status meshy/v7.1/image-to-3d <request_id> --result --json
```

{% endcode %}

☑️ Скачайте каждую модель, уменьшите размер её текстуры для веба и добавьте её в `client/assets.js`:

{% code collapsedlinecount="10" %}

```bash
python art/fetch.py raider-blue
bash art/build.sh raider-blue
```

{% endcode %}

Для предметов, текстуры пола и звуков выполните те же шаги с помощью `art/gen-props.sh` и `art/gen-sfx.sh`.

{% hint style="success" %}
**Ваши ресурсы никогда не попадают на игровой сервер.** Столкновения, дальность и скорость задаются числовыми значениями в `client/rules.js`. Рендерер масштабирует каждую модель до размера в мировых единицах, поэтому любую модель можно заменить, не меняя правила.
{% endhint %}

{% hint style="warning" %}
**Модель со скелетом имеет неправильный размер** в стандартной ограничивающей рамке three.js, потому что скелет задаёт собственный масштаб. Вместо этого измеряйте вершины скинированной геометрии, как это делает `fit()` в `client/render.js`, иначе персонаж будет отображаться слишком маленьким.
{% endhint %}

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

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

### 2. Сборка образа сервера

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

☑️ Найдите название проекта и учётные данные для [реестра контейнеров](https://docs.edgegap.com/ru/learn/advanced-features/edgegap-container-registry.md) .

☑️ В репозитории GitHub откройте **Настройки**, затем **Секреты и переменные**, затем **Действия**и добавьте:

* переменную `EDGEGAP_REGISTRY_PROJECT` — имя проекта в вашем реестре,
* секрет `EDGEGAP_REGISTRY_USERNAME` — ваше имя пользователя в реестре,
* секрет `EDGEGAP_REGISTRY_TOKEN` — ваш токен реестра.

☑️ Запустите рабочий процесс **Образ сервера** на вкладке **Действия** . Он выполняет локальный тест матча, затем собирает и отправляет `registry.edgegap.com/<project>/relic-rumble:<tag>`, используя время сборки в качестве тега. Тег указан в сводке запуска.

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

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

☑️ [Создайте приложение](https://app.edgegap.com/application-management/applications/list) с именем `relic-rumble`и одной версией, названной в соответствии с вашим тегом:

* **Образ**: реестр `registry.edgegap.com`, репозиторий `<project>/relic-rumble`, тег `<tag>`,
* **Ресурсы**: 0,25 vCPU и 512 МБ памяти,
* **Порт**: `7777`, имя `gameport`, протокол **WS**, с включённым **обновлением до TLS** ,
* **Политика перезапуска**: Никогда,
* **Переменные окружения**:
  * `EMPTY_TIMEOUT_S` - `15`— для остановки сервера, который покинули все игроки,
  * `FIRST_JOIN_TIMEOUT_S` - `60`— для остановки сервера, к которому никто не присоединился,
  * `RESULTS_SECONDS` - `8`,
  * `IDLE_TIMEOUT_S` - `75`— для отключения игроков, чья страница больше недоступна,
* **Максимальная продолжительность**: 30 минут в качестве меры предосторожности: сервер останавливается самостоятельно.

{% hint style="warning" %}
**Настройка TLS** позволяет браузерам на `https` страницах подключаться к `wss://<id>.pr.edgegap.net:<port>`. Edgegap завершает TLS и перенаправляет обычный трафик WebSocket на порт `7777`.
{% endhint %}

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

### 4. Создайте матчмейкер

☑️ Установите `application.version` в `matchmaker/rumble.json` из примера на свою версию и добавьте адрес своей страницы в `allowed_cors_origins`.

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

Профиль `rumble` подбирает матчи для 2–4 игроков. Через 20 секунд игрок, ожидающий в одиночку, получит сервер, а свободные места займут боты.

☑️ Когда у матчмейкера появится статус **«В сети»**, скопируйте его **URL API** и **токен авторизации** в `client/config.local.js`, копию файла `client/config.js`.

{% hint style="success" %}
Токен авторизации **матчмейкера безопасно включать в веб-страницы**: с его помощью можно только запрашивать подбор матча. Никогда не добавляйте токен API Edgegap в страницу или образ сервера.
{% endhint %}

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

### 5. Найдите матч

☑️ Откройте свою страницу в двух вкладках браузера и нажмите **«Найти матч»** в обеих вкладках в течение 20 секунд.

Каждая страница:

1. подключается к матчмейкеру и ожидает `HOST_ASSIGNED`,
2. подключается к `wss://<fqdn>:<port>` и отправляет свой идентификатор билета,
3. участвует в игре: отправляет команды и отображает полученное от сервера состояние, используя тот же рендерер и ресурсы, что и в одиночной игре.

Игровой сервер:

1. ожидает подобранных игроков, а затем заполняет свободные места ботами,
2. выполняет `client/rules.js` 60 раз в секунду и отправляет позиции 20 раз в секунду,
3. самостоятельно останавливает развёртывание после экрана результатов.

🙌 Теперь оба игрока находятся в одном матче на сервере, расположенном поблизости от них.

☑️ Чтобы проверить весь процесс без браузера, запустите сквозной тест. Он ставит в очередь двух игроков без графического интерфейса, проводит матч и ждёт, пока развёртывание остановится самостоятельно:

{% code collapsedlinecount="10" %}

```bash
MM_URL=<API URL> MM_TOKEN=<Auth Token> node tests/e2e.mjs rumble 2
```

{% endcode %}

## 📦 Публикация игры

* Разместите страницу где угодно: `client/` содержит статические файлы, для которых не требуется сборка. В примере есть workflow для GitHub Pages.
* Перед публикацией проверьте размер `client/assets/` Четыре персонажа, три объекта, пол и звуки в примере занимают 7 МБ.
* Сохраните свои промпты для fal, чтобы позже можно было создать ещё один ресурс в том же стиле.
* Отключите `inspect` в конфигурации матчмейкера перед запуском.
* Чтобы выпустить новые правила, отправьте новый тег образа и укажите его в версии приложения. Новые матчи будут использовать его, а уже запущенные продолжат работать на старой сборке. Чтобы обновить ресурсы, достаточно заново опубликовать страницу.

{% hint style="info" %}
Используете агента для программирования? Навык `edgegap-fal` в [наборе навыков агентов Edgegap](https://github.com/edgegap/llm-agent-skills) содержит описание игры, конвейер создания ресурсов fal, шаблоны сервера и тесты, а также помогает агенту выполнить те же шаги для вашей игры.
{% endhint %}
