Приветствую всех, в первую очередь тех, кто хочет почитать статью без нейрослопа, написанную руками, как это было когда‑то раньше, а так же всех, кто ищет вдохновение на свой проект или просто зашел почитать про мой кейс.
Думаю, что статей будет несколько, потому что убрать все мысли в одну будет слишком долго, тренды нынче на быстрое потребление контента и красивые схемки (вот схемки, конечно, будут сгенерированные). Пойдем от общего к частному — в данной статье расскажу про общую идею проекта и ключевые моменты разработки.
О проекте
В первую очередь — ссылка на проект для тех, кто сначала хочет попробовать, а потом уже решить, интересно ли читать статью дальше: 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 смотрят в |
|
Строк кода в проекте |
~28 k |
С учетом документации |
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 МБ |
Буду рад ответить на все имеющиеся вопросы, как по общим механикам, так и по реализации, следующей статьей планирую описать сам цикл разработки из разряда «можете попробовать повторить» или описать подробнее, как работает движок, смотря, что будет интереснее. Об этом предлагаю подискутировать в комментариях...
skreiven
Для Fable5.2 выглядит... простовато довольно, играется не очень приятно, вроде целишься точно в противника но полоска жизни стоит на месте у него, сами боты прикольно получились, крутятся.. уворачиваются, кидают гранаты.
istrebitel-1 Автор
Смотря какой пинг, на пинге до ~100мс с попаданиями все хорошо, потом может немного начать тротлить. Здесь ещё сильно решает сам VPS, на котором идет деплой, он не самый лучший, а точнее, самый простой...
skreiven
Да, реально пинг, после выстрела чувствуется задержка..
Попросите агента сетевую оптимизацию провести может для слабого железа подкрутит. У меня племяш опусом 5.5 почти полноценныйCS:GO собрал прямо на домашнем пк со скинами и лутбоксами, одноклассников говорит доить буду через них))
istrebitel-1 Автор
Для большого пинга есть механизмы предсказания, но они могут для пользователя работать так, что иногда регирстрация урона получается неочевидная (как раз проблемы CS, когда попал на своем мониторе, но не на сервере), на бэклог агент уже себе такую задачу поставил, чтобы это компенсировать.
Идея с шутером от 1-го лица у меня тоже была, но это пока всё откладывается в виду отсутсвия хороших идей для сюжета. А аналогов контры / call of duty уже полно, просто повторять, как мне кажется, не интерено. Но, может быть, придет в голову идея, которую можно будет монетизировать, потому что на одной волне "получилось - прикольно" далеко не уехать...