InquirerDENR urges protection of rare Atimonan Spikemoss in QuezonThe Jerusalem PostUS and Russia to oppose talks on limiting autonomous weaponsCNN Türkİskoçya'da 20 veri merkezine protesto: 300 milyar sterlinlik yatırıma tepki!PunchKwankwaso’s convoy attacked in Kano – ObiBollywood HungamaTanhaji: The Unsung Warrior and Adipurush director Om Raut to conduct masterclass on making grand films at Chitrapataka 2026한겨레서울 평균 전셋값 5억원 돌파…집값 상승폭은 석 달째 둔화Inquirer EntertainmentBianca Gonzalez shares how PBB prepares evictees for outside lifeZDF heuteAktuelle Pressemitteilungen des ZDFAitnewsعلي بابا تطلق Qwen4-Max بقدرات متعددة الوسائط وسياق مليون رمزDaily MailA right royal pairing! Kate hails 'wonderful' return to Mumbai as she enjoys game of street cricket with William after couple arrive in India for first joint tour in four yearsVarietyKorea Box Office: Anime Sensation ‘Chiikawa’ Holds Off ‘Fall 2: Deadpoint’ for Fifth Consecutive CrownThe IndependentRussell Brand’s wife shares message from disgraced comedian in prison
The Daily Newsstand · Free, Always
Monday, November 16, 2026

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

Translate

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

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

О проекте

В первую очередь - ссылка на проект для тех, кто сначала хочет попробовать, а потом уже решить, интересно ли читать статью дальше: 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 МБ

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

View the original on Хабр →

KioskNews shows a cleaned-up reading view extracted from the publisher’s page — the original always lives on their site, not ours.