Браузерный онлайн-шутер «руками» ИИ-агента

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

Думаю, что статей будет несколько, потому что убрать все мысли в одну будет слишком долго, тренды нынче на быстрое потребление контента и красивые схемки (вот схемки, конечно, будут сгенерированные). Пойдем от общего к частному — в данной статье расскажу про общую идею проекта и ключевые моменты разработки.

О проекте

В первую очередь — ссылка на проект для тех, кто сначала хочет попробовать, а потом уже решить, интересно ли читать статью дальше: https://istrebitel-game.duckdns.org.

Проект называется Battlecringe — название такое, потому что я изначально вообще не думал, что эта история зайдет так далеко и получит собственный деплоймент.

Battlecringe — low-poly браузерный шутер с видом сверху. PvP до 10 человек, кооперативное «Выживание» и процедурно-генерируемые карты с различными механиками. Так же не забыты стандартные игровые механики: кланы, друзья, магазин и скины.

..

1. Идея

Желание написать свою собственную игру, наверное, было у многих, но не многие действительно собрались с силами и реализовали проект. Еще меньшее количество проектов выстрелило. Помню времена, когда я делал небольшие проекты на Unity, используя гайды с ютуба и готовые темплейты для игровых механик, но, естественно, ничего дальше локальных прототипов не уходило, да и они сами были не сильно играбельны.

Затем появились LLM, способные писать код, и идея вернулась ко мне во второй раз. Тогда я попытался реализовать подобный top-down шутер с помощью Cursor-а, но все попытки не увенчались успехом, сетевой код был сырой, ping и FPS были ужасными, а графика около-нулевой, интерес было потух и проект был заброшен.

Но на прошлой неделе, после выхода Fable5.2 меня зацепил проект Saltline — AAA-шутер с одним уровнем в духе Call of Duty. Там есть две версии, через one-shot промпт, и дотюненная. Мысль о том, что полноценный играбельный проект на WebGL и Three.js можно написать за один промпт не дала мне покоя, и я решил попробовать возродить свой проект, естественно, выкинув весь код который был.

2. Архитектура решения

С учетом своего опыта, выбирал из SOTA-решений и того, что знаю сам. Нейросети вернули моду на браузерные игры, раньше был Flash player, сейчас Three.js и WebGL/WebGPU. Соответственно, стек строил отталкиваясь от популярных библиотек.

Основа:

  • Клиент: ts, React, Three.js, WebGL

  • Сервер: go — два микросервиса, game (движок) и api (управление данными)

  • СУБД: mongodb

  • Deployment: VPS, docker, Caddy

Ниже можно посмотреть, как все устроено внутри

C2 - КонтейнерыC2 — Контейнеры

Деплоймент и его ограничения:

Дабы не тратить большие деньги на хостинг этого добра, взял небольшой VPS c 1Gb RAM, 1vCPU — этого должно хватить с головой на нагрузку до 50 человек (проверено пока мксимум на 5 единовременно, метрики почти такие же, как и в простое).

Ну, соответственно, по деплою база — docker / docker-compose и веб-сервер/реверс-прокси Caddy сверху. Автоматизация через github actions. Хостинг взял на duckdns.

3. Первый релиз, доработка новых фичей и игровых механик

Идея есть, архитектура продумана — пора идти в реализацию.

  1. Harness. Базовые правила и воркфлоу работы
    Как раз-таки тема для отдельной статьи №1. С вайбкодингом знаком не первый день, настраиваю примерно стандартный пайплайн работы агента: «не пушить в мастер, релизные политики, когда и как запускать тесты и тому подобное»

  2. Бэклог и приоритеты реализации
    Была создана папка docs, поделена на бэклог фичи с их описанием и все перенесено туда, можно начинать

  3. Первый релиз
    Из фичей — главное было реализовать игровой движок, два режима PvP / PvE и регистрацию/вход. Интерфейса красивого тут не получилось, зато за два часа работы агента был написан основной движок игры — и он был вполне рабочим. Позвал приятеля потестировать, всё работает. Прилив сил и энергии делать проект дальше получен, переходим к улучшениям во все стороны.

  4. Два дня доработок и мы имеем стабильную версию с адекватными механиками
    Его можно почитать под спойлером

Описание всего функционала из changelog-а (сгенерировано).

Игровые механики

Бой (общее)

  • Вид сверху, управление WASD, прицел мышью, огонь на ЛКМ или пробел.

  • Магазин патронов и перезарядка, рывок, восстановление здоровья, граната летит в точку прицела.

  • Аптечки на карте, криты, серии убийств.

  • Четыре вида оружия: пистолет, пистолет-пулемет, дробовик, винтовка.

  • Туман войны: видно только то, что в прямой видимости.

  • Сервер авторитетный. Клиент предсказывает своё движение, сервер учитывает задержку при попаданиях.

PvP

  • Все против всех, до 10 игроков, матч по таймеру. При ничьей наступает внезапная смерть: побеждает первое убийство.

  • Команды 5×5, огонь по своим включается в лобби.

  • Захват флага: две команды, флаги на базах.

  • Три карты, комната берёт одну случайно.

Выживание (PvE)

  • Бесконечные волны мобов, можно играть одному или вместе.

  • Закуп между волнами за лом: аптечка, здоровье, урон.

  • Временные бустеры «Ярость» и «Броня» на 60 секунд.

  • Пауза по F9, только в одиночной игре.

Операции (PvE)

  • Процедурно сгенерированная карта.

  • Задачи: захват точек, спасение заложника, оборона объекта, зачистка, охота на босса, прорыв. Можно пройти полную цепочку.

  • Мобы: ближнего боя, бегуны, стрелки. У босса есть фазы, и он зовет подмогу.

  • Разные уровни сложности. Модификаторы увеличивают награду.

Общее для матча

  • Режим зрителя: после гибели в PvE до конца волны и вход в комнату только для наблюдения.

  • Реконнект: после обрыва слот держится 15 секунд.

  • Таблица счёта по Tab, пинг, чат в матче.

  • Звук и музыка синтезируются на лету. Музыка меняется по ходу матча.

Функционал вокруг игры

Аккаунт и прогресс

  • Регистрация и вход.

  • Статистика PvP и PvE в профиле.

  • Таблицы лидеров по PvP и по PvE.

  • Достижения с прогрессом.

  • Задание дня, каждые сутки новое.

Экономика

  • Монеты за матчи.

  • Магазин оружия.

  • Постоянные бустеры здоровья и урона, работают только в PvE.

  • Скины: цвет, головной убор, рамка ника, примерка перед покупкой.

Социальное

  • Друзья: заявки, статус «в сети», «в лобби», «в матче».

  • Приглашение друга в свою комнату.

  • Кланы с ролями, заявками и чатом. Есть топ кланов. Клановый буст дает +20 % монет, если в матче играл соклановец.

  • Чат в лобби и в матче.

Комнаты и подбор

  • Выбор комнаты перед боем или автоподбор в самую заполненную.

  • Приватные комнаты с входом по коду.

  • Брифинг операции: выбор задачи и модификатора, состав отряда.

Интерфейс

  • Меню с вкладками: бой, арсенал, достижения, клан, друзья, лидеры.

  • Окно «Что нового» при обновлении и по номеру версии в углу.

  • Настройки качества графики и громкости. Разрешение рендера динамически подстраивается, если кадры тяжелые.

  • Полноэкранный режим, F5 в бою не перезагружает страницу.

А вот как выглядит сама игра

Скриншоты игрыГлавная страницаГлавная страницаЛоббиЛоббиРежим выживанияРежим выживанияАрсеналАрсеналРежим захват флагаРежим захват флага

4. Ошибки, которые всплывали в процессе разработки

На самом деле, ошибок было не так много, т.к. агенту была выдана полноценная инструкция с поставками фичей, цикл был примерно следующий:

Постановка задачи текстом → Анализ постановки агентом → [Опционально] Grilling сессия с ответами на вопросы в чате → Создание файла спецификации фичи → Разработка → Прогон тестов (unit, smoke) → Полноценные e2e сессии на локальной машине, матч между скриптами-«Ботами» со скриншотами в процессе игры → PR на github → Ручной аппрув и megre в master

Из минусов данного цикла только длительность e2e сессий (т.к. самые сложные сценарии это sudden death и окончание матча по таймеру) занимает около 10 минут на один прогон, поэтому они запускались только один раз на весь pull request и там могло попадать несколько фич, от чего не с первого раза тесты были успешные. Этот пайплайн достаточно много раз правился в Claude.md.

5. Итоги и цифры проекта

Теперь давайте в цифрах, чтобы все было красиво.

Кодовая база

Что измеряем

Сколько вышло

Почему так?

От идеи до реализации

2 часа до прототипа, еще 2 вечера на доработки

Собрали v1, пересобрали до v2 (формально там семантическая версия 0.3.x)

Коммитов в master

176

Pull Requests

45 с учетом последовательных, 21 смотрят в master

Строк кода в проекте

~28k

С учетом документации

Epic-ов

14

Code coverage

~91%

Только для Go, для ts не замерялось

Работа агентов

Что измеряем

Сколько вышло

Почему так?

Рабочее время агента

~20 часов

Долгие ожитания e2e тестов

Токены

8,3 млн сгенерировано, ≈945 млн прочитано (в основном из кэша)

Ресурсы и производительность

Что измеряем

Сколько вышло

Почему так?

FPS

целевое 60 FPS

время кадра, p99 — 16.8 мс.

Draw calls

По разрешениям: low 39, med 49, high 68

До исправления v2 пик был 279–304

Треугольники (полигоны)

73 тыс. на low, 141 тыс. на med/high

Бандл

284 КБ gzip

Загрузка CPU

0.1 vCPU в простое

Загрузка RAM

~200MiB в простое

~150 из них — MongoDB

Размер Docker-образов

api 23,6 МБ, game 18,7 МБ

Буду рад ответить на все имеющиеся вопросы, как по общим механикам, так и по реализации, следующей статьей планирую описать сам цикл разработки из разряда «можете попробовать повторить» или описать подробнее, как работает движок, смотря, что будет интереснее. Об этом предлагаю подискутировать в комментариях…

Источник: habr.com

0 0 голоса
Рейтинг новости
1
0
Подписаться
Уведомить о
0 комментариев