Приветствую всех, в первую очередь тех, кто хочет почитать статью без нейрослопа, написанную руками, как это было когда-то раньше, а так же всех, кто ищет вдохновение на свой проект или просто зашел почитать про мой кейс.
Думаю, что статей будет несколько, потому что убрать все мысли в одну будет слишком долго, тренды нынче на быстрое потребление контента и красивые схемки (вот схемки, конечно, будут сгенерированные). Пойдем от общего к частному — в данной статье расскажу про общую идею проекта и ключевые моменты разработки.
О проекте
В первую очередь — ссылка на проект для тех, кто сначала хочет попробовать, а потом уже решить, интересно ли читать статью дальше: 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 — Контейнеры
Деплоймент и его ограничения:
Дабы не тратить большие деньги на хостинг этого добра, взял небольшой 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)
Коммитов в 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