RU Keybindings and vJoy Mapping

⌨️ Горячие клавиши и калибровка осей vJoy

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

vWheel Hub предлагает гибкую систему двойных слотов назначения клавиш (Dual-Slot Keybindings), продвинутые режимы управления курсором мыши, автоматическую проверку конфликтов и точный контроль над калибровкой осей виртуального контроллера vJoy.

---

⌨️ Двойные слоты назначения клавиш (Dual-Slot Keybinding System)

Каждое действие в vWheel Hub поддерживает два одновременных слота назначения (Primary / Key 1 и Secondary / Key 2). Это позволяет гибко комбинировать клавиши клавиатуры и кнопки мыши.

Проверка конфликтов клавиш (Keybinding Conflict Detection)

Движок ввода непрерывно отслеживает назначенные горячие клавиши в реальном времени. Если вы попытаетесь назначить одну и ту же клавишу на несовместимые действия (например, клавишу 'D' одновременно на Shift Up и Steer Right), vWheel Hub выделит конфликтующий слот предупреждающей красной рамкой.

---

📋 Полная таблица назначения клавиш (Comprehensive Keybindings Table)

Действие	Слот Primary (По умолчанию)	Слот Secondary (По умолчанию)	Назначение и механика
Gas (Throttle)	'W'	Левая кнопка мыши	Прогрессивный ввод газа с двухфазным нарастанием Schema V2 Fast/Slow Attack и сбросом Decay.
Brake	'S'	Правая кнопка мыши	Прогрессивный ввод педали тормоза с двухфазной модуляцией порога.
Turbo Pedal Attack	Двойное нажатие (Key 1 + Key 2)	Двойное нажатие (Key 1 + Key 2)	Одновременное зажатие основной и дополнительной клавиш газа/тормоза активирует мгновенный Turbo Attack (обход фаз для лаунч-контроля / экстренного торможения).
Shift Up	'E'	Боковая кнопка мыши 2 (Вперед)	Нажимает виртуальную кнопку Button 1 vJoy для повышения передачи в игре.
Shift Down	'Q'	Боковая кнопка мыши 1 (Назад)	Нажимает виртуальную кнопку Button 2 vJoy для понижения передачи в игре.
Steer Left	'A'	Стрелка влево	Поворот руля влево в режиме Keyboard-Only Steering.
Steer Right	'D'	Стрелка вправо	Поворот руля вправо в режиме Keyboard-Only Steering.
Center Steering	Space	Delete	Мгновенно возвращает виртуальный руль в строго нулевое положение $0^\circ$.
Toggle Hub Active	Не назначено	Не назначено	Глобальная системная горячая клавиша для включения или паузы движка vWheel Hub.
Toggle Mouse Lock	End	Backspace	Переключение постоянной блокировки курсора мыши внутри активного окна игры.
Hold-to-Unlock Cursor	Не назначено	Не назначено	Временное освобождение курсора мыши с заморозкой руления при удержании. Мгновенный захват при отпускании!

---

🔒 Режимы управления курсором мыши

vWheel Hub предлагает четыре интеллектуальных режима работы с курсором для плавного перехода между пилотированием на трассе и меню игры:

stateDiagram-v2
    [*] --> Unlocked: Запуск приложения
    Unlocked --> Locked: Нажатие Toggle Mouse Lock
    Locked --> Unlocked: Нажатие Toggle Mouse Lock
    Locked --> TempUnlocked: Зажатие клавиши 'Hold-to-Unlock'
    TempUnlocked --> Locked: Отпускание клавиши 'Hold-to-Unlock'
    Locked --> MenuUnlocked: Вход в меню (!telemetry.IsDriving)
    MenuUnlocked --> Locked: Возврат на трассу (telemetry.IsDriving)
    Locked --> Unlocked: Завершение процесса игры

Loading

1. Постоянная блокировка: Фиксирует курсор мыши в системной Win32-рамке окна, чтобы резкие движения мыши не вылетали за пределы экрана игры.
2. Удержание для разблокировки: Идеально для быстрой проверки второго монитора, Discord или телеметрии. При зажатии клавиши курсор освобождается, а руление замораживается. Отпускание клавиши мгновенно возвращает захват курсора в текущей позиции.
3. Авто-разблокировка в меню: В поддерживаемых играх (ACC, AC EVO, LMU, rFactor 2, BeamNG) вход в меню боксов или паузу автоматически освобождает мышь для удобной навигации. Возврат на трассу автоматически повторно захватывает курсор без нажатия клавиш.
4. Освобождение при выходе из игры (Game-Exit Auto-Unlock): При закрытии симулятора или аварийном выходе (Alt+F4) vWheel Hub в течение 250 мс фиксирует завершение процесса и автоматически освобождает курсор мыши.

---

🕹️ Калибровка и привязка осей vJoy (vJoy Axis Mapping & Calibration)

На вкладке vJoy Axes можно настраивать диапазоны и полярность виртуальных осей джойстика.

Разные автосимуляторы и движки калибруют оси джойстика по-разному:

Автосимулятор	Ось руля (X)	Ось газа (Y)	Ось тормоза (Z / Rz)	Требуется инверсия
Standard / Universal	-32768 до +32768	-32768 до +32768	-32768 до +32768	Нет
Le Mans Ultimate (LMU)	0 до 32768 или -32768 до +32768	16384 до 32768	0 до 16384	Invert Brake: Включено
Assetto Corsa Competizione	-32768 до +32768	-16384 до +32768	-16384 до +16384	Нет

Поля конфигурации осей:

• Ось руля — Steering Axis (X): OutSteerMin, OutSteerMax и Invert Steering.
• Ось газа — Gas Axis (Y): OutGasMin, OutGasMax и Invert Gas.
• Ось тормоза — Brake Axis (Z / Rz): OutBrakeMin, OutBrakeMax и Invert Brake.

Tip

Решение проблемы зажатых педалей: Если автомобиль постоянно тормозит или газует на 100% при ненажатых клавишах, просто отметьте галочку Invert Brake или Invert Gas на вкладке vJoy Axes для соответствия калибровке вашей игры.

---

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

• 🎮 Настройка рулевого управления
• ⚡ Динамика педалей (Физика газа и тормоза — Schema V2)
• 📁 Система профилей и обмен настройками