РоссияСтатьяАгенты
Браузерный онлайн-шутер «руками» ИИ-агента
Содержание
Приветствую всех, в первую очередь тех, кто хочет почитать статью без нейрослопа, написанную руками, как это было когда-то раньше, а так же всех, кто ищет вдохновение на свой проект или просто зашел почитать про мой кейс.
Думаю, что статей будет несколько, потому что убрать все мысли в одну будет слишком долго, тренды нынче на быстрое потребление контента и красивые схемки (вот схемки, конечно, будут сгенерированные). Пойдем от общего к частному - в данной статье расскажу про общую идею проекта и ключевые моменты разработки.
О проекте
В первую очередь - ссылка на проект для тех, кто сначала хочет попробовать, а потом уже решить, интересно ли читать статью дальше: 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
Ниже можно посмотреть, как все устроено внутри
Деплоймент и его ограничения:
Дабы не тратить большие деньги на хостинг этого добра, взял небольшой VPS c 1Gb RAM, 1vCPU - этого должно хватить с головой на нагрузку до 50 человек (проверено пока мксимум на 5 единовременно, метрики почти такие же, как и в простое).
Ну, соответственно, по деплою база - docker / docker-compose и веб-сервер/реверс-прокси Caddy сверху. Автоматизация через github actions. Хостинг взял на duckdns.
3. Первый релиз, доработка новых фичей и игровых механик
Идея есть, архитектура продумана - пора идти в реализацию.
- Harness. Базовые правила и воркфлоу работы Как раз-таки тема для отдельной статьи №1. С вайбкодингом знаком не первый день, настраиваю примерно стандартный пайплайн работы агента: "не пушить в мастер, релизные политики, когда и как запускать тесты и тому подобное"
- Бэклог и приоритеты реализации Была создана папка docs, поделена на бэклог фичи с их описанием и все перенесено туда, можно начинать
- Первый релиз Из фичей - главное было реализовать игровой движок, два режима PvP / PvE и регистрацию/вход. Интерфейса красивого тут не получилось, зато за два часа работы агента был написан основной движок игры - и он был вполне рабочим. Позвал приятеля потестировать, всё работает. Прилив сил и энергии делать проект дальше получен, переходим к улучшениям во все стороны.
- Два дня доработок и мы имеем стабильную версию с адекватными механиками Его можно почитать под спойлером
Игровые механики
Бой (общее)
- Вид сверху, управление 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 МБ
Буду рад ответить на все имеющиеся вопросы, как по общим механикам, так и по реализации, следующей статьей планирую описать сам цикл разработки из разряда "можете попробовать повторить" или описать подробнее, как работает движок, смотря, что будет интереснее. Об этом предлагаю подискутировать в комментариях...
Комментарии
Обсуждайте статью, отвечайте и оценивайте комментарии. Вход — через ваш Яндекс ID.
Загружаем обсуждение…