Бекарыс

CS2 Skin Viewer

3D-инспектор скинов CS2 в браузере — оружие, нож, перчатки, стикеры и брелоки, вид от первого лица и инспект. Скины рисуются портом шейдеров самой игры. Not affiliated with Valve.

  • Next.js
  • React
  • TypeScript
  • three.js
  • React Three Fiber
  • WebGL2
  • Python

Задача

Перед покупкой скина хочется увидеть, как он выглядит с конкретным float и паттерном, вместе с ножом и перчатками. Обычные просмотрщики показывают приближённую картинку: цвета, износ и расположение рисунка отличаются от игры. Цель проекта — показать скин в браузере так же, как его рисует сама CS2.

Решение

Главный принцип — портировать, а не приближать. Скин собирается тем же алгоритмом, что и в игре: компоновщик скинов CS2 перенесён в WebGL2, а не подобран на глаз. Если картинка отличается от игры, причина ищется в исходном шейдере, а не подкручивается вручную.

Вся сборка — оружие, нож, перчатки, float, паттерн, стикеры, брелок — хранится в адресе страницы, поэтому ей можно поделиться ссылкой. Любой предмет можно открыть прямо в игре: сайт сам собирает inspect-ссылку CS2, предмет при этом не обязан существовать ни в чьём инвентаре. Сервера нет: сайт статический, а около 3,4 ГБ моделей и текстур отдаются из облачного хранилища.

Проект независимый, not affiliated with Valve. Модели и текстуры принадлежат Valve и в репозиторий не попадают.

Сложности

  • Шейдеры игры в браузере. Шейдеры компоновщика (csgo_customweapon.vfx для оружия, csgo_customglove.vfx для перчаток) декомпилируются из файлов игры и автоматически переводятся из Vulkan GLSL в GLSL для WebGL2 собственным транслятором. Новые несовместимости исправляются в трансляторе, а не руками в результате.
  • Ограничения WebGL. В WebGL2 доступно 16 текстурных слотов, а компоновщику нужно больше: текстуры собираются в массивы, мипмапы для них строятся вручную. UV-острова моделей выходят за пределы 0..1, поэтому цели компоновки используют повтор текстуры.
  • Паттерны как в игре. Расположение рисунка зависит от сида паттерна. Для совпадения перенесён генератор случайных чисел игры (CUniformRandomStream): каждый параметр компоновщика берёт из него число в том же порядке, что и игра. Результат сверен с известными сидами Karambit Fade.
  • Проверка точности. Служебные страницы /audit и /compare рисуют скины нашим рендером, сравнивают с официальными иконками CS2 и ранжируют по отличию цвета — худшие сверху. Так находятся ошибки порта.
  • Вид от первого лица. Оружие и руки стоят на скелете анимаций игры: осмотр, перезарядка, смена руки. Стикеры наносятся патчем шейдера оружия, брелок висит на точке крепления модели.
  • Офлайн-конвейер. Данные вытаскиваются из файлов игры скриптами на Python: каталог предметов, модели, наборы скинов, стикеры, фоны карт. Длинные экспорты идут часами, повторная выгрузка в хранилище — только изменённые файлы.

Архитектура

  1. Файлы игрымодели, текстуры, шейдеры, описания скинов
  2. Офлайн-конвейер

    экспорт моделей, декомпиляция и перевод шейдеров, каталог предметов

  3. Хранилище ассетовстатические файлы, около 3,4 ГБ, отдельно от кода
  4. Компоновщик в браузере

    скин собирается на видеокарте из параметров в адресе

  5. Сценавид от первого лица, инспект, фон карты

Фрагменты кода

Порт генератора случайных чисел CUniformRandomStream. Он решает, где окажется рисунок при заданном сиде, поэтому повторяет оригинал шаг в шаг:

export class ValveRandom {
  private idum = 0
  private iy = 0
  private iv = new Array<number>(32).fill(0)
  constructor(seed: number) {
    this.idum = seed < 0 ? seed : -seed
    this.iy = 0
  }
  private next(): number {
    const IA = 16807, IM = 2147483647, IQ = 127773, IR = 2836, NTAB = 32
    const NDIV = 1 + Math.floor((IM - 1) / NTAB)
    let k: number
    if (this.idum <= 0 || this.iy === 0) {
      this.idum = -this.idum < 1 ? 1 : -this.idum
      for (let j = NTAB + 7; j >= 0; j--) {
        k = Math.floor(this.idum / IQ)
        this.idum = IA * (this.idum - k * IQ) - IR * k
        if (this.idum < 0) this.idum += IM
        if (j < NTAB) this.iv[j] = this.idum
      }
      this.iy = this.iv[0]
    }
    k = Math.floor(this.idum / IQ)
    this.idum = IA * (this.idum - k * IQ) - IR * k
    if (this.idum < 0) this.idum += IM
    const j = Math.floor(this.iy / NDIV)
    this.iy = this.iv[j]
    this.iv[j] = this.idum
    return this.iy
  }
  /** RandomFloat(low, high) */
  float(low: number, high: number): number {
    const f = Math.min((1 / 2147483647) * this.next(), 1 - 1.2e-7)
    return f * (high - low) + low
  }
}

Конец inspect-ссылки CS2. Описание предмета упаковывается в protobuf, а игра проверяет контрольную сумму. Без неё ссылка не откроется:

/** 00 | block | checksum, upper-case hex. */
export function inspectHex(block: number[]): string {
  const buffer = [0, ...block]
  const crc = crc32(buffer)
  // (crc & 0xffff) ^ (len * crc), kept to 32 bits; Math.imul wraps the product like the game does
  const sum = ((crc & 0xffff) ^ Math.imul(block.length, crc)) >>> 0
  const bytes = [...buffer, sum >>> 24, (sum >>> 16) & 0xff, (sum >>> 8) & 0xff, sum & 0xff]
  return bytes.map((b) => b.toString(16).padStart(2, "0")).join("").toUpperCase()
}

Как пользоваться

  1. Откройте сайт и выберите оружие, нож, перчатки и агента, задайте float и паттерн. Сцена с моделями грузится 10–20 секунд.
  2. В виде от первого лица переключайтесь между оружием, ножом и перчатками клавишами 1, 3 и 6. F — анимация осмотра, R — перезарядка, H — сменить руку.
  3. Включите инспект и вращайте модель мышью. К оружию можно добавить стикеры и брелок, а стикер — поставить на нужное место в режиме нанесения, как в игре. P сохраняет скриншот вместе с фоном карты.
  4. «Share combo» копирует ссылку на всю сборку, а «Open in CS2» открывает выбранный предмет прямо в игре.