RU Home

🏎️ Добро пожаловать в вики vWheel Hub

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

Добро пожаловать в официальную документацию проекта vWheel Hub — высокопроизводительной утилиты для Windows, которая превращает обычную мышь и клавиатуру в точный, плавный и конкурентоспособный виртуальный руль для автосимуляторов на ПК.

Независимо от того, участвуете ли вы в гонках в Assetto Corsa, Assetto Corsa Competizione, Assetto Corsa EVO, Le Mans Ultimate, rFactor 2, iRacing, BeamNG.drive или раллийных симуляторах, vWheel Hub обеспечивает сверхнизкую задержку управления мышью через Windows RawInput (с гибко настраиваемой частотой опроса Polling Rate до 1000 Гц), настраиваемую физику педалей по времени ($\Delta t$), режим руления только с клавиатуры, 3-ступенчатую иерархию профилей (Игра ➔ Класс ➔ Машина) и передовые телеметрические ассистенты с самообучающимся кэшем зацепа.

🎯 Что такое vWheel Hub и как это работает?

В большинстве автосимуляторов управление рассчитано на физические рули и педали (Logitech, Thrustmaster, Fanatec, Simucube, Direct Drive), подключаемые по USB.

vWheel Hub соединяет мышь и клавиатуру с виртуальным рулем с помощью драйвера vJoy:

1. Руление мышью (Mouse Steering): При перемещении мыши по горизонтали vWheel Hub считывает координаты через системный API Windows RawInput без системной акселерации и преобразует их в высокоточный угол поворота виртуального руля.
2. Педали с клавиатуры (Pedal Dynamics Schema V2): Нажатия клавиш газа и тормоза симулируют работу реальных механических педалей с помощью физики, основанной на времени ($\Delta t$), двухфазных кривых нарастания (Fast Attack / Slow Attack), турбо-атаки и гамма-коррекции, независимо от частоты опроса хаба.
3. Режим руления с клавиатуры (Keyboard Steering): Возможность полноценного управления автомобилем исключительно клавишами с настраиваемым временем нарастания выворота (Ramp-Up), возврата в центр (Ramp-Down) и мгновенным центрированием.
4. Телеметрическая обработка: В поддерживаемых симуляторах vWheel Hub считывает живые данные автомобиля (скорость вращения колес, проскальзывание шин, ускорения) и активирует умные ассистенты: ABS Helper, Smart Traction Control (TC) с адаптивным 2D-кэшем сцепления шин, Synthetic Trail Braking, звуковой фидбек скольжения (Slip Audio), а также автоматическое освобождение курсора и заморозку управления в меню.

flowchart LR
    A[Мышь и Клавиатура] -->|RawInput / Win32| B(Движок vWheel Hub)
    T[Телеметрия игры] -.->|Shared Memory / UDP| B
    B -->|Физика и Ассистенты| C[Виртуальное устройство vJoy #1]
    C -->|DirectInput / XInput| D[Автосимулятор]

Loading

---

📚 Содержание документации

Ознакомьтесь с подробными руководствами по разделам:

Раздел	Описание
🚀 Быстрый старт и установка vJoy	Пошаговое руководство по установке, системные требования (.NET 10 x64), настройка vJoy в 1 клик и первый запуск.
🎮 Настройка рулевого управления	Чувствительность мыши, настройка частоты опроса Polling Rate (до 1000 Гц), гамма, ограничение угла руля (Lock Clamp) и режим клавиатуры.
⚡ Динамика педалей	Физика Schema V2: независимость от Hub Rate, двухфазное нарастание в секундах, Turbo-атака, сброс Decay и Gamma.
📡 Телеметрические ассистенты	Ассистенты ABS и Smart TC, параметры сброса/восстановления, адаптивное обучение зацепу шин, управление в меню и зависимость чувствительности от скорости.
🏎️ Trail Braking и звуковой фидбек	Синтетический Trail Braking при входе в поворот и звуковые подсказки сноса (Understeer), заноса (Oversteer) и букса (TC).
📁 Иерархия профилей и обмен	3-ступенчатое наследование настроек (Игра ➔ Класс ➔ Машина), отдельный профиль Universal, история Undo/Redo и экспорт Share-кодов (VWH1-).
🕹️ Поддерживаемые игры и плагины	Матрица совместимости (ACC, AC EVO, LMU 1000 Гц, BeamNG Lua, rFactor 2, iRacing и др.), автоопределение и установка плагинов.
⌨️ Горячие клавиши и оси vJoy	Двойные назначения клавиш, удержание для разблокировки курсора, центрирование руля, кнопки КПП и калибровка осей vJoy.
⭐ Сравнение Free и Pro версий	Подробное сравнение возможностей бесплатной Open Source версии и Pro-версии с Boosty.
🔧 Решение проблем и FAQ	Устранение рывков в LMU (DirectInput Fallback + 1000 Гц), калибровка педалей, разблокировка курсора, диагностика vJoy и частые вопросы.

---

💡 Полезно знать новичку

• Универсальная совместимость: Вы можете играть в ЛЮБОЙ автосимулятор без дополнительной настройки телеметрии — базовое руление мышью и клавиатурные педали работают везде через стандартный DirectInput.
• Диагностика в 1 клик: Обратите внимание на карточку диагностики vJoy на главном экране (Dashboard). Если vJoy еще не настроен, просто нажмите кнопку «Auto-Configure vJoy».
• Иерархия профилей: Организуйте настройки через 3 уровня (Игра ➔ Класс ➔ Машина) либо используйте отдельный универсальный профиль Universal для любых других игр.
• Совместимость с Le Mans Ultimate: При возникновении рывков ввода в LMU включите исправление DirectInput Fallback на Dashboard — это устранит статтеры и позволит играть на частоте опроса 1000 Гц!

---

🤝 Сообщество и поддержка

• 🧡 Boosty (Pro-версия и поддержка разработчика): https://boosty.to/barden_dev
• 💬 Discord-сообщество: https://discord.gg/YQn5eh2vfc
• 💻 GitHub репозиторий: https://github.com/Barden-dev/vWheel-Hub