Пронумеровал всю игру

EN RU
16.11.2026 Views: 1
c++directxets2

Всем привет! Последние пару недель я делал мод для Euro Truck Simulator 2: Spotify прямо на штатном экране навигации в кабине. Обложка, название трека, прогресс, всё на приборке. Я вообще люблю прикручивать Spotify туда, куда не просят, в прошлый раз это был Genius.

Небольшой дисклеймер. Вообще я бэкенд-разработчик и пишу в основном на Go и TypeScript. Плагины для ETS2 — это нативные DLL с C-интерфейсом, поэтому мод я писал на C++, так что строго не судите. Чтобы код получился более-менее приличным, я сверялся с гайдом cpp-best-practices: сборка с /W4 /WX и дополнительными предупреждениями, статический анализатор MSVC и AddressSanitizer в CI, clang-format, unit-тесты и офлайн-стенд, который гоняет мод без игры. Если опытный плюсовик увидит что-то странное, буду рад замечаниям.

Официальный SDK игры умеет только отдавать телеметрию: скорость, пауза, какой грузовик. Рисовать он не умеет. Поэтому мод перехватывает Direct3D 11 и в нужный момент подсовывает игре вместо картинки навигатора свою текстуру. Сам перехват оставлю за кадром, а в этой статье расскажу про задачу, на которую ушло больше всего времени: как понять, какая из текстур игры и есть экран навигатора. Без исходников игры, без отладочной информации, только то, что видно снаружи.


Экран — это просто текстура

Игра не рисует навигатор прямо на модели. Сначала она рисует картинку экрана в отдельную текстуру (render target), а потом натягивает её на модельку экрана, как самую обычную текстуру. Значит, если подменить текстуру в тот момент, когда игра отдаёт её шейдеру, на экране окажется моя картинка.

Отдаёт текстуры шейдеру вызов PSSetShaderResources, его я и перехватил. Оставалось понять, какую текстуру подменять. Я ожидал что-то широкоформатное, под форму экрана, условно 1024×512. Забегая вперёд: не угадал.


Красим всё подряд

Раз я не знаю, какая текстура нужна, пусть игра покажет сама. Я сделал диагностический режим: каждый render target, который игра берёт в шейдер, подменяется розовой полосатой заглушкой с крупным номером. Номер это просто индекс текстуры в моём списке.

Какие текстуры попадают в список, решает простой фильтр:

const bool shape = (td.BindFlags & D3D11_BIND_RENDER_TARGET) &&
                   td.SampleDesc.Count == 1 && td.ArraySize == 1 &&
                   !(td.MiscFlags & D3D11_RESOURCE_MISC_TEXTURECUBE) &&
                   td.Width >= 64 && td.Height >= 64;

Одно исключение пришлось добавить сразу: буферы размером с экран и их уменьшенные копии (½, ¼ и так до 1/32, так устроены bloom, SSAO и прочая постобработка). Если подменить и их, вместо кадра получается розовая каша. Заодно выяснилось, что игра рендерит сцену не в 1920×1080, а в 2880×2160: у меня в настройках стоит масштабирование. Так что «размер экрана» пришлось определять по самому большому буферу, а не по окну.

Заходим в кабину, жмём кнопку, и вот что получается:

Кабина Iveco, все render target'ы подменены розовыми заглушками с номерами

На одном кадре сразу несколько находок:

  • На приборке #30, это дисплей в щитке приборов.
  • Зеркала тоже текстуры (#33, #34). Логично: отражение в зеркале это отдельный рендер сцены с другой камеры.
  • Порозовели даже машины на парковке, видимо, им достались текстуры отражений.
  • А на навигаторе номер обрезан. Это первая подсказка: экран показывает не всю текстуру, а только кусок из её середины.

Дальше режим «по одной»: подменяется только одна текстура, я листаю номера кнопками, пока заглушка не окажется на навигаторе, и подтверждаю, мод записывает её описание в файл. И тут сюрприз: экран навигатора это квадратная текстура 256×256 с флагом GENERATE_MIPS (игра сама строит ей уменьшенные копии, mip-уровни). Никакого широкоформата: на экран идёт только полоса посередине, меньше половины высоты.


Номер каждый раз разный

Нашёл, отлично. Только номер это порядок, в котором текстуры попались мне на глаза, а адрес текстуры меняется при каждом запуске и в каждом грузовике. Нужно правило, а не номер.

Первое наблюдение: все экраны в кабине, и навигатор, и дисплей в щитке, это render target'ы с GENERATE_MIPS размером не больше 1024. Среди остальных render target'ов игры таких я не встретил. Получилось определение «дисплея»:

bool IsDisplay(const D3D11_TEXTURE2D_DESC& d) {
    return (d.MiscFlags & D3D11_RESOURCE_MISC_GENERATE_MIPS) &&
           (d.BindFlags & D3D11_BIND_RENDER_TARGET) && d.ArraySize == 1 && d.Width >= 64 &&
           d.Height >= 64 && std::max(d.Width, d.Height) <= 1024;
}

Но дисплеев несколько, и навигатор надо отличать от щитка. Для этого я сделал запись кадра: несколько кадров подряд мод пишет в лог каждую смену render target'а и каждую текстуру, которую берёт шейдер. Такой RenderDoc на коленке. В логе цепочка видна как на ладони:

карта (1024×1024, без мипов, перерисовывается каждый кадр)
  → дисплей 256×256 → дисплей 256×256          навигатор
UI щитка → дисплей 512×512 → дисплей 512×512    щиток приборов
сцена: модельки экранов берут последний дисплей каждой цепочки

Выходит, навигатор это дисплей, в начале цепочки которого карта. А карта это обычный render target без мипов. Первая версия так и работала: раз в несколько секунд искала дисплеи, которые рисуют из обычного render target'а, и брала самый большой.


Спидометр украл мой плеер

Всё работало ровно до первого выхода из меню паузы. После меню плеер переехал с навигатора на дисплей в щитке, прямо между спидометром и тахометром.

Оказалось, игра подмешивает в дисплеи ещё одну текстуру без мипов, судя по всему, кеш шрифтов. После меню щиток тоже начал из неё рисовать и по моему правилу стал выглядеть «подключённым к карте». А так как он больше навигатора (512 против 256), выбор пал на него.

Отличие нашлось простое: карту игра перерисовывает каждый кадр, а кеш шрифтов нет. Значит, картой считаем только тот render target, в который рисовали в этом же кадре.

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


Итоговый алгоритм

Каждый кадр мод собирает граф «какой дисплей из чего рисовал» и решает так:

  1. Дисплей, который рисовал из обычного render target'а, перерисованного в этом же кадре, показывает карту.
  2. «Показывает карту» передаётся по цепочке: дисплей, который рисовал из такого дисплея, тоже показывает карту.
  3. Кандидаты — дисплеи с картой в конце цепочки, то есть те, которые никто больше к себе не рисует.
  4. Выбор «липкий»: текущая текстура остаётся, пока она кандидат. Иначе берётся размер, сохранённый для этого грузовика, иначе самый маленький, экраны навигации маленькие.

Шаги 1 и 2 в коде:

for (const auto& [display, sources] : f.plainSources) {
    for (TextureId s : sources) {
        if (f.rendered.count(s)) {  // в этот render target рисовали в этом кадре
            a.showsMap.insert(display);
            break;
        }
    }
}

for (bool changed = true; changed;) {
    changed = false;
    for (const auto& [display, sources] : f.displaySources) {
        if (a.showsMap.count(display)) { continue; }
        for (TextureId s : sources) {
            if (a.showsMap.count(s)) {
                a.showsMap.insert(display);
                changed = true;
                break;
            }
        }
    }
}

Всё это происходит на потоке рендера, а PSSetShaderResources игра вызывает тысячи раз за кадр. Поэтому в горячем пути никаких аллокаций, а вся тяжёлая работа делается один раз в конце кадра. По моим замерам хук добавляет к вызову от 4 до 12 наносекунд.

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

Обложка и название трека на штатном навигаторе Iveco

Заключение

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

Исходный код — на GitHub:
👉 ets-spotify

mowl@dev: ~
mowl@dev:~$