«Обход»: как Python-разработчик без опыта в геймдеве сделал игру про сети — руками агентов

в 9:04, , рубрики: dpi, React, tcp, TypeScript, геймдев, геймдизайн, ии-агенты, компьютерные сети, нейросети, разработка игр

Я пишу на Python, увлекаюсь OSINT, последний год разбираюсь с нейросетями и агентами. В геймдеве у меня нет вообще ничего: ни Unity, ни Godot, ни одной строчки шейдера, ни одной законченной игры за спиной. При этом про компьютерные сети в голове был набор красивых слов и очень мало понимания: я мог объяснить, что такое DPI, но не мог сказать, почему конкретное соединение не проходит. Курсы и статьи читаются легко и выветриваются так же, поэтому вместо очередного конспекта я решил сделать симулятор, в котором пакет либо доходит до сервера, либо нет, а игрок сам выясняет, что именно ему помешало. Так появился «Обход» — сначала маленькая головоломка на один вечер, а теперь игра с десятью главами, тридцатью восемью уровнями, энциклопедией на тридцать две статьи и стратегией на карте вымышленной страны.

«Обход»: как Python-разработчик без опыта в геймдеве сделал игру про сети — руками агентов - 1

Что получилось в итоге

Основа игры — уровни-головоломки. На схеме стоят ноутбук игрока, домашний роутер, провайдеры, магистраль, фильтры и сервер, и маршрут между ними игрок собирает сам, кликая по узлам по порядку. Потом он выбирает протокол, порт, маскировку и тип DNS, запускает симуляцию и смотрит, как пакеты ползут по линиям, где-то исчезают и где-то получают отказ. Главное отличие от обычного учебного квиза в том, что правила фильтрации скрыты от игрока: в журнале видно только наблюдаемое поведение сети — «пакет пропал после узла X», «получен RST», «соединение замедлилось», — а причину нужно вывести из этих улик самостоятельно. Звёзды при этом дают только за время доставки, а не за число попыток, и это принципиально: перебирать варианты бессмысленно, сокращать путь и разбираться в происходящем приходится по-настоящему.

Второй режим появился позже. Это стратегия на карте вымышленной Вельмарии из десяти регионов, где можно играть за обе стороны. Смутьяны распространяют обход, растят аудиторию и держат серверы, а Цифропорядок наводит порядок устройством «Сетевой страж», лоббирует законы и следит, чтобы недовольство граждан не дошло до отставки. Одна и та же сеть показана с двух сторон, и это, пожалуй, самая интересная часть проекта: игрок своими руками убеждается, что идеальная фильтрация ломает банки и запись к врачу, а обход без инфраструктуры разваливается на перегруженных серверах. Отдельно стоит оговорка, которую я вписал в подвал сайта и в каждую статью энциклопедии: всё это образовательная модель, узлы и правила вымышлены, и игра не является руководством по обходу блокировок.

«Обход»: как Python-разработчик без опыта в геймдеве сделал игру про сети — руками агентов - 2

Как я это делал и кто писал код

Код писал не только я. Вернее, код писал в основном агент, а я писал требования, проверки и потом много часов ругался с балансом. Начал я с Claude, но доступ из моего региона стал проблемой, и я перешёл на Arena.ai — платформу, которая выросла из LMArena, где модели сравнивают голосованием людей. В режиме Agent Mode задача ставится целиком: агент сам планирует шаги, правит файлы в песочнице, запускает тесты, ищет в интернете и при необходимости открывает pull request, а модели под капотом меняются от запуска к запуску.

Для меня это оказалось удобно по двум причинам. Во-первых, агент видит весь репозиторий, а не куски кода в переписке, и мне не нужно объяснять, где какой файл лежит. Во-вторых, его работу можно проверить объективно: запустил тесты и увидел результат, а не «поверь мне». Шаги при этом видны, и если агент поехал не туда, его можно остановить на середине. Чего переход не дал — так это магии: всё, что я не сформулировал явно, агент додумал по-своему, и потом это приходилось разгребать.

Самое полезное, что я сделал до первой строчки кода, — написал два документа, техническое задание и геймдизайн-план. Это звучит как бюрократия, но когда через несколько недель сменился инструмент, объяснять ничего заново не пришлось: требования жили в репозитории, а не в истории чата. Второй по важности вещью оказались ограничения вместо вкусовых пожеланий: фраза «только эти шрифты, только эта палитра, ядро без DOM» работает, а «сделай красиво» превращается в средний дашборд. Ядро не знает про React — и это не пожелание, а правило ESLint, которое действует именно на папку core/: без него модель через пару итераций начнёт чинить логику прямо в компоненте, поскольку так короче.

// этот забор в линтере — половина успеха работы с агентом
{
  files: ['src/core/**/*.ts'],
  rules: {
    'no-restricted-imports': ['error', { patterns: ['react', 'react-dom', '*/ui/*', '*/render/*'] }],
    'no-restricted-globals': ['error', 'window', 'document', 'localStorage'],
  },
}

Где агент стабильно проваливался — это числа и вкус. Баланс оказался не задачей про «напиши код»: модель уверенно выдаёт правдоподобные константы, и они правдоподобно не работают, а спасают только прогоны сотен партий. Отдельная привычка, которую пришлось выработать: если проверка красная, агент с заметной охотой правит сам тест, а не баг, поэтому у меня есть правило — тест меняется только вместе с явным решением, что изменилось требование. И ещё размер: агент легко сгенерировал сборку в семьсот шестьдесят килобайт одним чанком, сборка при этом зелёная, а думать про code splitting пришлось мне.

«Обход»: как Python-разработчик без опыта в геймдеве сделал игру про сети — руками агентов - 3

Что стоит за кулисами

Модель игры — чистые функции без DOM и без обращений к хранилищу, и это тоже проверяется линтером, а не силой воли. Случайность выводится из seed и номера дня, поэтому одна и та же партия воспроизводится бит в бит: без этого нельзя ни отладить, ни протестировать, а «у меня не воспроизводится» — самый дорогой ответ в разработке. Побочный эффект оказался приятным: у каждой партии есть номер, который видно на экране итогов, и по нему можно переиграть ту же партию или прислать мне воспроизведение бага.

Контент лежит в JSON, а не в коде. Уровень — это файл со схемой сети, скрытыми правилами, доступными инструментами, порогами времени и списком решений; файл кидается в папку, подхватывается автоматически и проходит валидацию схемой. Новый уровень не требует программиста, и это сильно ускорило работу. Интерфейс собран на React, но модель от него не зависит: TypeScript, Vite, Vitest и Zod, без бэкенда, с прогрессом в localStorage, локальными шрифтами и PWA-манифестом. Звук сделан не файлами, а синтезом в Web Audio — три коротких сигнала на осцилляторах, около сорока строк кода, и по умолчанию он выключен.

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

Где было по-настоящему тяжело

Сбалансировать асимметричную стратегию руками невозможно: две стороны с разными ресурсами и целями, и любое изменение одного числа тянет за собой пять других. Поэтому я написал ботов трёх уровней для обеих сторон и скрипт, который гоняет партии и печатает таблицу с долей побед, длиной партии и причинами исходов. Последний прогон на шестнадцати партиях в каждой паре показал, что сложность монотонна, партия идёт положенные два игровых года и бездействие проигрывает, но при игре «средний против среднего» Смутьяны выигрывают шестьдесят девять процентов партий — многовато, хочется ближе к половине.

И тут самое важное, что я вынес из всей этой затеи: интересно ли играть, прогон ботов не показывает вообще. Тест «обе стороны выигрывают» проходит и при шестидесяти девяти процентах, и при тринадцати, он говорит только о том, что игра не сломана. Проверяется это исключительно людьми, и именно поэтому мне нужны те, кто просто поиграет и скажет, где застрял. Я могу прогнать тысячу партий ботов и не узнать того, что узнаю из одного живого комментария.

«Обход»: как Python-разработчик без опыта в геймдеве сделал игру про сети — руками агентов - 4

Что пока плохо

Честный список того, что я знаю за своим проектом. Баланс аркады сырой: те самые шестьдесят девять процентов — мало. Сборка идёт одним чанком на семьсот шестьдесят два килобайта, что для игры с телефона тяжеловато. Музыки и звукового дизайна нет совсем, только короткие сигналы событий, и те выключены по умолчанию. Перевода нет, игра только на русском, а то, что сознательно не входит в текущую версию — вторая кампания, мультиплеер, аккаунты и локализация, — лежит в TODO, потому что приоритет сейчас у стабильности, баланса и обратной связи.

Зачем я это написал

Мне нужны игроки и их отзывы, причём не вежливое «класс», а конкретика: на каком уровне стало понятно, что происходит, и на каком вы перестали понимать; где игра кажется сломанной, хотя это задумано; что хочется убрать и что добавить. Баги удобнее всего присылать через кнопку «Сообщить о проблеме» в главном меню — она копирует контекст, браузер и размер экрана, останется дописать, что вы нажимали.

Ссылка на игру: http://162.244.32.61/ — игра открыты всем, регистрации нет, прогресс хранится в браузере. Репозиторий пока закрыт: открою, когда причешу баланс и сборку. Если решите поиграть, напишите в комментариях одну вещь — на каком уровне вы поняли, что происходит, и на каком перестали: мне это скажет больше, чем любой отзыв «понравилось / не понравилось».

Игра «Обход» — образовательная модель. Все узлы, правила фильтрации и показатели вымышлены и упрощены; игра не описывает реальные системы и не является руководством по обходу блокировок. Материал написан по собственному опыту разработки, ссылка на игру приведена для того, чтобы читатели могли проверить описанное, а не ради продвижения.

Автор: tromv3

Источник

* - обязательные к заполнению поля


https://ajax.googleapis.com/ajax/libs/jquery/3.4.1/jquery.min.js