Играть

Как сделан Punchnaut

Punchnaut - бесплатная онлайн-игра про космос с рукопашным боем, которая идёт в браузере на WebGPU. Здесь техническая история её первых недель: что мы берём от three.js, что написали сами, как свет прошёл путь от запечённого к свету в реальном времени и как один разработчик делает игру вместе с моделями ИИ.

Коротко

  • Punchnaut - бесплатная многопользовательская игра в браузере. Нужен WebGPU, запасного пути на WebGL нет.
  • Код на обычном JavaScript поверх рендерера WebGPU из three.js. Финальный кадр, свечение и данные освещения у нас свои.
  • Свет за четыре дня сменил три версии: цвет вершин, потом карты освещения, потом свет в реальном времени от восьми лучших источников на клетку 15 м.
  • Ореолы не рисуются фигурами. Всё, что ярче белого, светится само.
  • Две круглые планеты радиусом 400 и 560 м, между ними нет экрана загрузки.
  • 3D-модели - это скрипты Blender на Python. Цвет хранится в вершинах, а не в текстурах.
  • Мобов ведёт страница одного из игроков. Сервер передаёт их другим и хранит здоровье, смерти и опыт.
  • Игру делает один разработчик вместе с GPT 6 Astra, GPT 6 Sol, Claude Fable 5.2 и Claude Opus 5.5.

Почему браузер и почему WebGPU

Мы хотели онлайн-игру, которая открывается по ссылке, не требует установки и при этом идёт на обычных ноутбуках со встроенной графикой. Выбрали только WebGPU, без запасного WebGL.

Punchnaut вырос из более раннего браузерного проекта того же разработчика. Первый коммит космической игры датирован 1 ноября 2026 года. К 16 ноября в ней было больше 600 коммитов и собственное имя.

5 ноября мы убрали последние ветки WebGL. Два рендерера - это два набора ошибок и картинка, подогнанная под более слабый. Если браузер не даёт рендереру WebGPU, игра не запускается. Более медленного пути, на который можно откатиться, нет.

Слабые видеокарты определили многое. Плотность пикселей ограничена 1.5, поэтому экраны высокой плотности рисуют меньше пикселей, чем могли бы. Предметы слиты в общие сетки, а не рисуются по одному. У большинства моделей нет текстур вовсе.

Что берём от three.js и что написали сами

От three.js у нас рендерер WebGPU, сцена и материалы-узлы на TSL. Финальный кадр, свечение, объединение предметов, отсечение и структуры данных для света - наш код.

Мы используем three.js 0.186.1 через его рендерер WebGPU. Материалы - это материалы-узлы three, написанные на TSL, его языке шейдеров внутри JavaScript. Наш код света подключён к этим материалам дополнительными узлами.

Последние шаги кадра наши. Сцена рисуется в буфер с половинной точностью с плавающей точкой, поэтому цвет может быть больше 1.0. Наш проход добавляет свечение, слегка подкрашивает тени и света, затемняет края и переводит результат для экрана. Он написан на WGSL и работает с устройством видеокарты рендерера напрямую.

Предметы не отдельные объекты. Всё, что стоит на участке земли, слито в одну сетку этого участка. Участки за горизонтом планеты или дальше своей дальности не рисуются. На второй планете вид с высоты полёта на ранце укладывается в 25 вызовов отрисовки и 40 тысяч треугольников.

  • Отказались: от запасного WebGL, травы и ветра, северного сияния, кольца пыли при приземлении, световых столбов над местами для исследования.
  • Отказались после сбоя: от отдельного объекта света со своим узлом освещения. У игрока зависла видеокарта с ошибкой DXGI_ERROR_DEVICE_HUNG. Причину мы так и не воспроизвели, но этот путь убрали. Теперь при потере устройства кадры останавливаются и появляется кнопка перезагрузки.
  • Перешли на обратную глубину с плавающей точкой. С обычным буфером глубины и ближней плоскостью 0.1 свечение в 5 см над полом начинало мерцать вместе с ним уже с 290 м. С обратной глубиной ошибка растёт с расстоянием, а не с его квадратом.

Одна мелочь TSL стоила нам эксперимента. Цепочка вида a.mix(b, t) считает a коэффициентом, а не первым цветом. Гранёные нормали земли покрылись чёрной зернистостью, и эксперимент мы отменили. Теперь пишем mix(a, b, t) явно.

Освещение: от запечённых карт к свету в реальном времени

Планету освещают светящиеся кристаллы, грибы и фонари - около 1600 неподвижных источников. За четыре дня мы попробовали цвет вершин, потом заранее запечённые карты освещения и остановились на свете в реальном времени от восьми лучших источников на клетку 15 м, без теней.

Версия 1: свет в цвете вершин

Сначала игра считала свет на процессоре при постройке мира и записывала его в цвет вершин. Рисовать это дёшево, но свет меняется только от вершины к вершине. На больших треугольниках края световых пятен выходили ломаными.

Версия 2: запечённые карты освещения

12 ноября мы перешли на текстурные карты освещения. Инструмент на Node заранее запекал все неподвижные источники в текстуры с текселем 0.25 м. Края теней сглаживались 16 отсчётами (4×4) на тексель. Первый единый файл весил 30 МБ, его текстуры занимали 54.7 МБ памяти видеокарты. Потом мы разбили данные по областям, и игроку у базы нужно было скачать 52 файла на 6.6 МБ вместо всей планеты.

Мелкие предметы давали некрасивые тени. Высокий фонарь бросал на землю длинную полосу: 278 из 315 перекрытых лучей попадали в две его наклонные опоры. Мы ввели правило. Форма уже 0.8 м в двух направлениях тени не даёт, а широкая тонкая стена даёт. Фонари и флаги не дают тени никогда. В локальной проверке число проверок видимости упало с 25 688 до 16 964, а время с 93.8 до 37.5 мс.

неподвижных источников в запекании
~1600
области данных освещения
363
сжатых данных освещения
~56 МБ
полное запекание перед каждым выпуском
5-9 мин

Что сломалось

Каждый выпуск теперь тянул за собой запекание на несколько минут. Кэш хранил отпечаток мира, чтобы клиент мог понять, подходит ли свет к геометрии. 13 ноября игрок увидел мир совсем без света. Его браузер перечислял грани выпуклых форм не в том порядке, что Node, отпечатки разошлись, и клиент отбросил все карты освещения. Помогла сортировка граней перед подсчётом отпечатка. В тот же день мы добавили свет в реальном времени как вариант и позже в тот же день убрали выбор запечённого света. 14 ноября удалили 2805 строк кода и инструментов запекания.

Версия 3: свет в реальном времени

Обе планеты поделены на клетки не больше 15 м на кубе, натянутом на сферу. В каждой клетке хранится список до восьми источников, которые для неё важнее всего. Источники и клетки лежат в буферах видеокарты. Шейдер находит клетку точки, которую освещает, и складывает эти восемь источников. Добыча кристалла просто выключает его источник. Перенос редкого кристалла пересчитывает клетки вокруг него.

  • Земля получает свет фонарей в каждом пикселе. Её вершины стоят в метрах друг от друга, и свет по вершинам размазал бы пятна.
  • Предметы получают свет фонарей в углах своих граней, это дешевле, чем в каждом пикселе.
  • Начиная со 120 и до 220 м свет на земле переходит в несколько общих мягких пятен вместо света по клеткам.
  • Движущихся персонажей освещает набор из трёх точечных источников. Ближайшие источники выбираются по сетке десять раз в секунду.
  • Свет фонарей теней не даёт.

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

Свечение: ореол даёт кадр, а не фигура

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

В ранних сборках ореолы были геометрией: кольца вокруг кристаллов, столбы света над местами, лучи у ярких звёзд. Каждый был ещё одной прозрачной отрисовкой, и нарисованный ореол могла разрезать земля. Мы убрали их один за другим.

Теперь у части модели, которая должна светиться, цвет больше 1.0. В файле ракеты такие части помечены множителем яркости. Проход свечения выбирает пиксели выше порога, несколько раз уменьшает картинку и увеличивает её обратно. Так свет расходится мягко, а цена кадра не меняется.

Одни видеокарты возвращают NaN или бесконечность там, где другие дают число. Один такой пиксель раньше заливал всё свечение белым. Теперь проход яркости заменяет NaN нулём и ограничивает каждое значение числом 16. Свечение можно выключить в настройках без перезагрузки.

Планеты и рельеф

Обе планеты - шары с притяжением к центру, между ними летают без экрана загрузки. Рельеф родной планеты прошёл путь от шума к гладкой сфере и потом к названным формам с ровными площадками под всем, что стоит.

Радиус родной планеты 400 м. У второй планеты, Янтаря, 560 м и притяжение у поверхности 3.6 м/с². Притяжение убывает с квадратом расстояния, и игра выбирает планету, которая тянет сильнее. Потолка у ранца нет. На ховербайке с ускорением путь до Янтаря занимает около 12 секунд.

Земля - это куб, натянутый на сферу, разбитый на куски с уровнями детализации и юбками, которые прячут стыки. Пока игра загружается, планеты строятся порциями по 8 мс, поэтому экран загрузки не замирает.

Рельеф, три раза

В первых сборках был резкий рельеф и четыре биома. 12 ноября родная планета получила каменные ярусы, впадины и гранёные нормали. В тот же день мы убрали процедурные впадины, террасы, гребни и шум. 13 ноября родная планета снова стала чистой сферой.

16 ноября рельеф вернулся в другом виде. Это уже не шум повсюду, а список названных форм на спокойной земле: вершины с отрогами, по которым можно зайти пешком, гребни, столовая гора с пологим подъёмом, каньон с открытыми концами, кратеры и кальдера. Одна из вершин, Игла, поднимается на 52 м.

  • У базы и под местами, собранными из моделей, рельефа нет.
  • Каждая стоянка мобов, ориентир и находка стоят на ровной площадке, врезанной в форму. Список площадок пишет скрипт по направлениям этих мест, а направления от рельефа не зависят. Поэтому правка горы не двигает площадки.
  • Ориентиры выбирают место на ровной сфере, рельеф их только поднимает. Иначе любая правка переставила бы все ориентиры и кристаллы, привязанные к ним.
  • Сетка земли идёт с шагом 3 м, это слишком крупно для острой скалы. Скальный вид дают 132 валуна на вершинах, гребнях и краях кратеров.

3D-модели: скрипты Blender и цвет вершин

Каждая модель - это скрипт Blender на Python в репозитории, а не файл, поправленный руками. Цвет хранится в вершинах, а не в текстурах, каждый файл сжат meshopt.

Скрипт строит сетку, называет её части по ролям и выгружает файл glTF. Роли говорят, что освещается, что светится, что только сталкивается и где стоит источник света. Изменить модель - значит изменить код, который можно проверить и запустить заново.

Цвет живёт в вершинах. Текстура стоит памяти, выборок и текстурной координаты на каждой вершине. Плоские грани с цветом вершин подходят к виду игры и остаются дешёвыми на встроенной графике.

Каждый файл сжат meshopt: позиции квантуются до 16 бит, нормали до 10. Потом треугольники переупорядочиваются под кэш вершин видеокарты, потому что meshopt упорядочивает их под размер файла.

ракета: текстура заменена цветом вершин
378 808 → 88 900 байт
треугольников в космонавте
8130 → 2388
источников света на ракете
15 → 10
вызова отрисовки на космонавта в любом костюме
2

Костюм собран как набор: каркас и десять комплектов шлемов, торсов, ног и ботинок на одном скелете. Что бы ни было надето, всё сливается в два вызова отрисовки. Новая ракета рисуется одной оболочкой, а сталкивается пятью невидимыми выпуклыми частями. Большие места вроде пещеры или упавшего крейсера - каждое одна модель. Земля под ними вырезана, а игрок, камера, мобы и ховербайк сталкиваются с настоящими треугольниками модели.

Сеть: кто ведёт мобов

Сервер никогда не считает мобов сам. Каждую группу мобов ведёт страница одного из игроков рядом и шлёт их состояние, а сервер передаёт его остальным. Здоровье, смерти, опыт и всё, чем владеет игрок, хранится на сервере.

Сервер написан на Node.js с WebSocket. У каждой группы мобов есть владелец - страница одного игрока: она считает их движение и бой и шлёт строку на каждого моба. Строка уходит только при изменениях и ещё раз в секунду, чтобы моб не пропал. Строки идут упакованными байтами. Когда владелец уходит, сервер передаёт группу другому игроку.

Сервер хранит то, что нельзя подделать или потерять: кто какой группой владеет, здоровье каждого моба и сколько он остаётся мёртвым. Убитый моб возвращается через десять минут, страж места через тридцать. Опыт тоже считает сервер. Сфера опыта выпадает, только если моб того вида, что записан для этого места, погиб рядом со своим домом и не слишком быстро после появления. Формула уровня - общий код: 40 очков за первый уровень и на 18% больше за каждый следующий.

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

Бой кулаками и приёмы

Оружия у игрока нет. Дерутся кулаками: серия из трёх ударов, удар с разворота, уклонение и всего 15 приёмов, которые открываются с уровнями.

Левая кнопка даёт серию из трёх ударов: выпад, апперкот с подъёмом и хук с разворотом. Каждый двигает всё тело и работает на бегу. Правая кнопка - удар с разворота, он длится 0.62 секунды. Shift - уклонение с наградой за точно выбранный момент.

Новые приёмы открываются с уровнями в три ячейки правой кнопки. Апперкот открывается на 9 уровне, вращение в воздухе на 16. Удар держит направление на врага, с которого начался, пока кулак не дойдёт. Поэтому враг, отступивший во время замаха, всё равно получает удар.

Мобы отвечают на вид удара: вздрагивают, отлетают, падают, кувыркаются, если их подбросить, или шатаются оглушённые. Если ответить ударом в течение 3 секунд после урона, можно вернуть до 40% потерянного.

Шесть языков

Игра говорит по-английски, по-русски, по-испански, по-португальски (Бразилия), по-немецки и по-французски. Словарь загружается, только когда выбран его язык, а сборка падает на пропущенном или лишнем ключе.

У каждого языка свой словарь. Это отдельный кусок, который скачивается, только когда игрок выбрал этот язык: все шесть никто не загружает. Формы множественного числа идут по правилам каждого языка.

Проверка работает внутри сборки. Текст для игрока может жить только в словарях. Все шесть словарей должны иметь одинаковые ключи с одинаковыми {параметрами}. Каждый ключ должен использоваться, и каждый используемый ключ должен существовать.

Как мы работаем с моделями ИИ

Punchnaut делает один разработчик вместе с OpenAI GPT 6 Astra и GPT 6 Sol и Anthropic Claude Fable 5.2 и Claude Opus 5.5. Разработчик ставит задачи, играет в сборки и принимает решения. Модели пишут код и скрипты Blender и проверяют работу друг друга.

  • Разработчик играет и решает. Модели игру не запускают: картинку, управление и бой разработчик проверяет в игре и принимает или отклоняет.
  • Модели пишут код и 3D-модели. Многие модели начинаются со сгенерированной картинки-образца, потом под неё пишется скрипт Blender.
  • Модели проверяют друг друга. Крупные изменения получают независимое ревью другой модели, которая заново прогоняет нужные проверки и читает изменение.
  • Сначала замер, потом ускорение. Каждое ускорение начинается с числа: вызовы отрисовки, треугольники, запросы, миллисекунды на одной и той же проверке. То, что не измерено, так и называется - не измерено.
  • Сборка ловит обычные ошибки: материалы вне модуля красок, имена, изменение состояния вне его действий и правила переводов выше.
  • Решения и их причины записываются. Руководство по проекту и журнал причин позволяют следующему сеансу или следующей модели продолжить работу.

Большая часть проверок идёт в Node без браузера: ходьба по склонам, ховербайк, мобы двух страниц против настоящего сервера мобов, реестр света, отпечатки кэша. Саму игру запускает разработчик.

Что мы поняли

  • Запечённый кэш надёжен ровно настолько, насколько надёжен его отпечаток. Порядок граней, разный в двух движках, однажды выключил свет целиком.
  • Свет в реальном времени от нескольких ближайших источников на клетку достаточен для ночной планеты, а любая правка модели требует только пересборки, без запекания.
  • Свечение от яркости лучше свечения от геометрии: меньше отрисовок, нет ореолов, разрезанных землёй, одна настройка, чтобы выключить.
  • Рельеф, на котором что-то стоит, лучше задавать руками, а не генерировать. Ровные площадки и неизменные направления ориентиров держат мир на месте, пока горы меняются.
  • Цвет вершин и скрипты Blender держат модели маленькими и проверяемыми. Ракета потеряла три четверти файла вместе с текстурой.
  • Пусть мобов ведёт страница игрока, но здоровье, смерти и опыт остаются на сервере.
Играть в Punchnaut

Бесплатно, в браузере, без установки. Нужен WebGPU: свежий Chrome или Edge на компьютере.