Приветствую всех, в первую очередь тех, кто хочет почитать статью без нейрослопа, написанную руками, как это было когда-то раньше, а так же всех, кто ищет вдохновение на свой проект или просто зашел почитать про мой кейс.
Думаю, что статей будет несколько, потому что убрать все мысли в одну будет слишком долго, тренды нынче на быстрое потребление контента и красивые схемки (вот схемки, конечно, будут сгенерированные). Пойдем от общего к частному - в данной статье расскажу про общую идею проекта и ключевые моменты разработки.
О проекте
В первую очередь - ссылка на проект для тех, кто сначала хочет попробовать, а потом уже решить, интересно ли читать статью дальше: 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 и регистрацию/вход. Интерфейса красивого тут не получилось, зато за два часа работы агента был написан основной движок игры - и он был вполне рабочим. Позвал приятеля потестировать, всё работает. Прилив сил и энергии делать проект дальше получен, переходим к улучшениям во все стороны.Два дня доработок и мы имеем стабильную версию с адекватными механиками
Его можно почитать под спойлером
Описание всего функционала из 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) |
Коммитов в | 176 | |
Pull Requests | 45 с учетом последовательных, 21 смотрят в | |
Строк кода в проекте | ~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 МБ |
Буду рад ответить на все имеющиеся вопросы, как по общим механикам, так и по реализации, следующей статьей планирую описать сам цикл разработки из разряда "можете попробовать повторить" или описать подробнее, как работает движок, смотря, что будет интереснее. Об этом предлагаю подискутировать в комментариях...
