RU Getting Started

🚀 Быстрый старт и настройка vJoy

🌐 Language / Язык: English | Русский

В этом руководстве подробно описан процесс первого запуска vWheel Hub, установки драйвера виртуального джойстика vJoy, автоматической диагностики, настройки автосимуляторов и работы с интерактивным Dashboard.

---

📋 Предварительные требования и системные требования

Перед запуском vWheel Hub убедитесь, что ваш ПК соответствует следующим требованиям:

Компонент	Минимальные / Рекомендуемые требования
Операционная система	Windows 10 (64-bit, Version 1909+) или Windows 11 (64-bit)
Среда выполнения	Microsoft .NET 10 Desktop Runtime (x64) — Обязательно для запуска 👉 Скачать .NET 10 Desktop Runtime (x64)
Устройства ввода	Любая стандартная оптическая/лазерная мышь (рекомендуется 1600–3200 DPI) и клавиатура
Виртуальный драйвер устройства	vJoy Virtual Joystick Driver (v2.1.9.1 или новее) 👉 Скачать драйвер vJoy (GitHub Releases)

Important

Требование .NET 10 Desktop Runtime: vWheel Hub нативно скомпилирован под .NET 10. Если при запуске vWheelHub.exe появляется ошибка об отсутствии среды выполнения .NET Desktop Runtime, скачайте и установите .NET 10 Desktop Runtime (x64) с официального сайта Microsoft.

---

🛠️ Шаг 1: Установка виртуального драйвера vJoy

Что такое vJoy?

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

1. Скачайте последнюю версию инсталлятора vJoy: 👉 Скачать драйвер vJoy.
2. Запустите файл установки (vJoySetup.exe) и следуйте указаниям мастера.
3. Если появится запрос системы безопасности Windows на проверку сертификата драйвера, разрешите установку.
4. Перезагрузите компьютер, если этого потребует инсталлятор.

---

⚡ Шаг 2: Запуск vWheel Hub и авто-настройка vJoy в 1 клик

1. Распакуйте архив vWheel Hub в любую удобную папку (например, C:\Games\vWheelHub\ или D:\Tools\vWheelHub\).
2. Запустите vWheelHub.exe.
3. Обратите внимание на карточку vJoy Diagnostic Card в верхней части вкладки Dashboard.

flowchart TD
    Start[Запуск vWheel Hub] --> Diag[Диагностика драйвера vJoy]
    Diag -->|Зеленый: Valid & Ready| Ready[Все готово к заезду!]
    Diag -->|Красный: Not Configured| Click[Нажмите 'Auto-Configure vJoy']
    Click --> Script[vWheel Hub запускает встроенный CLI-фиксер]
    Script --> Ready

Loading

Статусы диагностики:

• 🟢 Зеленый статус («Valid / Ready»): Устройство vJoy #1 обнаружено и корректно настроено: выделены 3 аналоговые оси (Руль, Газ, Тормоз) и виртуальные кнопки переключения передач. Можно выезжать на трассу!
• 🔴 Красный / Предупреждающий статус («Needs Configuration»): Если устройство #1 отсутствует или не содержит нужных осей, просто нажмите кнопку «Auto-Configure vJoy».

Что делает кнопка «Auto-Configure vJoy»?

vWheel Hub в фоновом режиме запускает встроенную утилиту конфигурирования vJoy, которая:

• Включает виртуальное устройство Device #1.
• Назначает оси: X (Руль), Y (Газ / Акселератор) и Z / Rz (Тормоз).
• Включает как минимум 8 виртуальных кнопок для переключения передач вверх/вниз и дополнительных действий.
• Синхронизирует системную библиотеку vJoyInterface.dll с приложением.

Tip

Вам не нужно вручную открывать стороннюю программу vJoyConf.exe — vWheel Hub автоматически настраивает всё в 1 клик!

---

🎮 Шаг 3: Настройка управления в автосимуляторе

После того как карточка vJoy активна и горит зеленым цветом, настройте ваш автосимулятор:

1. Запустите автосимулятор (Assetto Corsa Competizione, Assetto Corsa EVO, Le Mans Ultimate, BeamNG.drive, iRacing, Assetto Corsa и т.д.).
2. Перейдите в раздел Настройки ➔ Управление / Устройства ввода (Options ➔ Controls / Input Settings).
3. Выберите тип устройства: Руль / DirectInput контроллер (выберите vJoy Device #1 или vJoy Device).
4. Назначьте оси и кнопки:
   • Руль (Steering): Поверните виртуальный руль (подвигайте мышь влево-вправо или назначьте ось X).
   • Газ (Throttle / Gas): Нажмите назначенную клавишу газа (напр. W или LMB) или назначьте ось Y.
   • Тормоз (Brake): Нажмите назначенную клавишу тормоза (напр. S или RMB) или назначьте ось Z (или Rz).
   • Повышение / Понижение передачи (Shift Up / Shift Down): Назначьте виртуальные кнопки (Кнопка 1 и Кнопка 2).
5. В настройках игры обязательно выставьте:
   • Мертвая зона руля (Deadzone): 0%.
   • Линейность / Гамма руля (Linearity / Gamma): 1.0 (Линейно). Все нелинейные кривые, сглаживание и физика педалей настраиваются напрямую внутри vWheel Hub.

---

🏁 Шаг 4: Активация vWheel Hub и управление курсором мыши

1. В vWheel Hub включите верхний тумблер «Is Active», чтобы активировать движок обработки.
2. Захват мыши: Нажмите назначенную горячую клавишу Toggle Mouse Lock (по умолчанию End или Backspace), чтобы заблокировать курсор внутри окна игры для руления.
3. Удержание для разблокировки: Зажмите назначенную клавишу (например, боковую кнопку мыши или модификатор клавиатуры), чтобы временно освободить курсор мыши и приостановить руление. Отпускание клавиши мгновенно возвращает захват курсора и руление!
4. Авто-разблокировка курсора в меню: В поддерживаемых играх (ACC, AC EVO, LMU, rFactor 2, BeamNG) vWheel Hub отслеживает нахождение в меню гаража/паузы и автоматически освобождает курсор, снова захватывая его при выезде на трассу.
5. Game-Exit Auto-Unlock: При закрытии или завершении процесса игры vWheel Hub мгновенно фиксирует завершение процесса и автоматически освобождает курсор мыши.

---

🔧 Шаг 5: Диагностические карточки Dashboard

Вкладка Dashboard в vWheel Hub содержит интерактивные диагностические карточки:

1. vJoy Diagnostic Card: Проверяет установку системного драйвера, привязку DLL, захват устройства и конфигурацию осей с возможностью исправления в 1 клик.
2. LMU Input Compatibility Fix: Для пилотов Le Mans Ultimate позволяет применить фикс DirectInput Fallback ("DirectInput Fallback": true), устраняющий рывки ввода и разблокирующий полную частоту опроса 1000 Hz.
3. Telemetry Plugin Status: Автоматически находит установленные игры Steam (BeamNG, LMU, rFactor 2), устанавливает и проверяет DLL разделяемой памяти и Lua-моды телеметрии.

---

⏭️ Следующие шаги

• 🕹️ Совместимость с играми и плагины телеметрии
• 🎮 Настройка рулевого управления
• ⚡ Динамика педалей (Физика газа и тормоза)
• 📡 Телеметрические ассистенты (ABS, Smart TC и кэш зацепа)
• 🏎️ Trail Braking и звуковые подсказки скольжения
• 📁 Система профилей и обмен настройками