==============================================================================
 Manhunt GInput — Поддержка геймпадов / Controller Support
==============================================================================

==============================================================================
ENGLISH GUIDE
==============================================================================

  Manhunt GInput adds analog movement, camera/aim, four layouts, remapping,
  button icons and rumble to the PC version. XInput, DualShock 4 and DualSense
  are supported. Keyboard/mouse remain available; hints follow the input device.

REQUIREMENTS

  Manhunt for Windows (Steam version), a 32-bit ASI loader and an XInput
  controller or DualShock 4 / DualSense. Other game builds may not be
  compatible. Rumble requires a controller with vibration motors.

INSTALLATION

  1. Install an ASI loader using its instructions. Use Win32/x86 even on
     64-bit Windows. An existing working ASI loader usually needs no replacement.
  2. Extract into the game folder containing manhunt.exe:

    Manhunt\ManhuntGInput.asi
    Manhunt\ManhuntGInput.ini
    Manhunt\data\txd\ManhuntGInput_Glyphs.txd
    Manhunt\data\ManhuntGInput\lang\template.txt.example

     ASI and INI may move together into Manhunt\scripts if supported by the
     loader. Leave data in the game root. Keep only one ASI copy and back up
     your INI before updating to preserve settings and bindings.
  3. Connect the controller and open gamepad setup in the controls menu.
     DirectPad=1 reads DualShock 4 / DualSense directly over USB/Bluetooth.
     Software hiding the HID device may prevent direct access.

  There is one configuration file: ManhuntGInput.ini. The old
  ManhuntGInput_RU.ini is no longer needed and is not read by the plugin.

CONTROLS

  Choose PS2 (default), Xbox one stick, Xbox two sticks, or Modern in-game.
  Modern uses L3/LS for sprint, RT/R2 for attack and A/Cross for interaction.
  D-pad/left stick select menu items; A/Cross confirms. Back follows the layout.
  Left/right adjust settings. Remap buttons on the gamepad page; hints follow
  the layout and bindings. GlyphSet selects pictures, not the control scheme.

SETTINGS

  ManhuntGInput.ini

  The INI lives beside the ASI. Main settings come first; advanced options
  are at the bottom. Restart after manual edits. In-game changes save automatically.

  UiLanguage          Auto follows the game / MHLL. Manual: English, French,
                      German, Italian, Spanish, Russian or EN/FR/DE/IT/ES/RU.
  Enabled             1 enables the mod, 0 disables it.
  ControlScheme       ClassicA, ClassicB or Modern; easiest to select in-game.
  ControlLayout       PlayStation2 / XboxOriginal for classic schemes.
  GlyphSet            Auto follows the controller; PS3 / Xbox360 select icons;
                      None uses text.
  DirectPad           Direct DualShock 4 / DualSense USB/Bluetooth input.
  ControllerIndex     XInput controller: 0 for the first, then 1, 2, 3.
  EnableVibration     Rumble master switch.
  VibrationStrength   Overall rumble strength, 0.0 to 1.0.
  Lightbar            Active follows game state; Health follows health; Off.

  Dead zones, sensitivity, inversion, rumble effects and extra features are
  explained further down in the same INI.

  All three switches are in gamepad setup and the INI [Gamepad] section.
  InvertRightX=1 reverses horizontal camera/aim input. This cancels the native
    reversed third-person camera X in PS2 / Xbox one-stick schemes.
  CameraAutoCenter=0 disables camera recentering in one-stick schemes.
    First-person, scope and lock-on retain native camera behavior.
  AnalogTriggerStrafe=1 makes trigger-bound strafe speed follow pressure.
    TriggerThreshold still applies; digital buttons remain full speed.
    Quick turn is preserved. Xbox defaults require remapping strafe to triggers.
  Defaults: 0 / 1 / 0, previous behavior. Restart after editing the INI.
  Automated tests pass; these additions still need live controller testing.

COMPATIBILITY

  Rumble covers native game events, executions, execution charge, damage,
  chainsaw, selected scenes and environmental interactions. Crane operation
  has no extra rumble. Automated checks do not replace testing every effect
  in the game with a controller that has motors.

  Bink skipping, console cheat codes, bonus-card button icons and Sony lightbar
  support are included. Manhunt Achievements and MHMic are optional separate
  mods. Achievements can read GInput's icons/input state; updated MHMic can
  read Cross/A and its held state for the headset notice. Bind_SkinFreeze
  selects Freeze/Rotate on PluginMH's skin page.

TROUBLESHOOTING

  Not loading: check the Win32 ASI loader and ASI/INI location.
  Missing icons: check data\txd\ManhuntGInput_Glyphs.txd; text is the fallback.
  No controller: check the connection, XInput mode, DirectPad and any software
  hiding HID devices or creating virtual controllers.

  Set EnableLogging=1 and restart. Reproduce the issue, exit and save
  ManhuntGInput.log beside the ASI before launching again. Include the log
  when reporting the problem. Restore EnableLogging=0 afterwards.

  Unofficial fan mod. Manhunt belongs to Rockstar Games.

UNINSTALLATION

  Close the game and remove this mod's ASI and INI files. Remove its log
  if one was created. Other installed mods do not need to be removed.

LANGUAGE AND TRANSLATIONS

  MOD LANGUAGE offers GAME / MHLL (UiLanguage=Auto) and six built-in languages.
  Changes apply immediately and save; restoring defaults selects Auto.
  This changes the mod's own strings. Stock labels stay in the game's language.
  The game's font must support the selected alphabet.

  1. Copy data\ManhuntGInput\lang\template.txt.example into the same directory
     with a .txt name, for example polski.txt. The .example file is not loaded.
  2. Set Match to the exact controls-type label in the game translation
     (GXT key CONTTYP, above the button list).
  3. Translate values after = and save as UTF-8. Follow the character codes
     and letter case used by the translation's GXT and font.
  4. Select GAME / MHLL and keep the default UiTextFile path. Restart after
     adding files. Changing language through MHLL selects the matching file.

  Missing strings keep built-in wording. ModLanguage and LanguageAuto name
  the new setting and its Auto value. Button.* names buttons without icons;
  Prompt.* teaches tutorial hint spellings. These keep following the game
  translation even with a manual mod language. Several translations may coexist.

CREDITS

  Thanks to ermaccer for PluginMH and making its source code available.
  https://github.com/ermaccer/Manhunt.PluginMH

==============================================================================
ИНСТРУКЦИЯ НА РУССКОМ
==============================================================================

  Manhunt GInput добавляет в PC-версию Manhunt аналоговое движение, камеру,
  прицеливание, четыре раскладки, переназначение кнопок, значки и вибрацию.
  Поддерживаются XInput, DualShock 4 и DualSense. Клавиатура и мышь продолжают
  работать; подсказки следуют активному устройству ввода.

ЧТО НУЖНО

  Manhunt для Windows (Steam-версия), 32-битный ASI Loader и геймпад
  XInput либо DualShock 4 / DualSense. Другие сборки игры могут быть
  несовместимы. Для вибрации нужен геймпад с вибромоторами.

УСТАНОВКА

  1. Установите ASI Loader по его инструкции. Нужна версия Win32/x86, даже
     если Windows 64-битная. Если ASI-моды уже работают, второй загрузчик
     обычно не требуется.

  2. Распакуйте файлы в папку игры, где лежит manhunt.exe:

    Manhunt\ManhuntGInput.asi
    Manhunt\ManhuntGInput.ini
    Manhunt\data\txd\ManhuntGInput_Glyphs.txd
    Manhunt\data\ManhuntGInput\lang\template.txt.example

     ASI и INI можно перенести вместе в Manhunt\scripts, если загрузчик
     поддерживает эту папку. Папку data оставьте в корне игры.
     Не оставляйте две копии ASI. Перед обновлением сохраните свой INI,
     чтобы не потерять настройки и переназначения.

  3. Подключите геймпад, запустите игру и откройте настройки геймпада
     в меню управления. Для DualShock 4 / DualSense без XInput-переводчика
     оставьте DirectPad=1. Программы, скрывающие HID, могут мешать
     прямому подключению.

  В комплекте один файл настроек — ManhuntGInput.ini. Старый
  ManhuntGInput_RU.ini больше не нужен: плагин его не читает.

УПРАВЛЕНИЕ

  Раскладка выбирается в меню игры:
    PS2              Классическая схема с одним стиком; включена по умолчанию.
    Xbox: один стик   Классическая схема Xbox.
    Xbox: два стика   Движение и камера разнесены по стикам.
    Modern           Бег на L3/LS, атака на RT/R2, действие на A/Cross.

  В меню: крестовина или левый стик — выбор, A/Cross — подтверждение,
  кнопка «назад» — по текущей раскладке. В настройках стрелки влево/вправо
  меняют значение. Кнопки можно переназначить на странице геймпада;
  подсказки следуют выбранной раскладке и привязкам.

  Названия Xbox / PlayStation: A/Cross, B/Circle, X/Square, Y/Triangle;
  LB/L1, RB/R1, LT/L2, RT/R2; LS/L3 и RS/R3 — нажатия стиков.
  GlyphSet меняет значки, а не управление.

НАСТРОЙКИ

  ManhuntGInput.ini

  INI лежит рядом с ASI. Основные параметры находятся в начале файла,
  служебные — внизу. После ручной правки перезапустите игру.
  Изменения на странице настроек геймпада сохраняются автоматически.

  UiLanguage          Auto — язык игры / MHLL; вручную: English, French,
                      German, Italian, Spanish, Russian или EN/FR/DE/IT/ES/RU.
  Enabled             1 — мод включён, 0 — выключен.
  ControlScheme       ClassicA, ClassicB или Modern; проще выбрать в меню.
  ControlLayout       PlayStation2 или XboxOriginal для классических схем.
  GlyphSet            Auto — по геймпаду; PS3 / Xbox360 — вручную; None — текст.
  DirectPad           1 — прямой ввод DualShock 4 / DualSense по USB/Bluetooth.
  ControllerIndex     0 — первый XInput-геймпад, далее 1, 2, 3.
  EnableVibration     1 — вибрация включена, 0 — выключена.
  VibrationStrength   Общая сила вибрации от 0.0 до 1.0.
  Lightbar            Active — состояние игры; Health — здоровье; Off — выкл.

  Мёртвые зоны, чувствительность, инверсия, эффекты вибрации и дополнительные
  возможности описаны ниже в том же INI. Подписи в INI — на английском
  и русском; подробные пояснения к основным настройкам приведены здесь.

  Все три переключателя есть в меню геймпада и секции [Gamepad] в INI.
  InvertRightX=1 — перевернуть горизонталь камеры и прицеливания.
    В PS2/Xbox с одним стиком это отменяет обратный X камеры от третьего лица.
  CameraAutoCenter=0 — отключить возврат камеры в схемах с одним стиком.
    Прицел, вид от первого лица и захват цели сохраняют штатную камеру.
  AnalogTriggerStrafe=1 — скорость стрейфа от силы нажатия назначенного курка.
    Порог TriggerThreshold сохраняется. Обычные кнопки работают с полной скоростью.
    Быстрый разворот сохраняется. Xbox требует переназначить стрейф на курки.
  По умолчанию: 0 / 1 / 0, прежнее управление. После правки INI перезапустите игру.
  Новые функции проверены автотестами; игровая проверка с геймпадом ещё нужна.

СОВМЕСТИМОСТЬ

  Вибрация работает для игровых событий, казней, заряда казни, урона,
  бензопилы, отдельных сцен и взаимодействий с окружением. Для управления
  краном дополнительного эффекта нет. Сила эффектов зависит от контроллера;
  автоматические проверки не заменяют проверку всех эффектов в игре.

  Поддерживаются пропуск Bink-роликов, консольные чит-коды, значки кнопок
  на бонусных карточках и подсветка DualShock/DualSense.

  Manhunt Achievements и MHMic необязательны и устанавливаются отдельно.
  Достижения могут использовать значки и состояние геймпада GInput.
  Обновлённый MHMic получает Cross/A и удержание для уведомления о гарнитуре.
  На странице скинов PluginMH кнопка Freeze/Rotate задаётся Bind_SkinFreeze.

ЕСЛИ ЧТО-ТО НЕ РАБОТАЕТ

  Мод не загружается: проверьте Win32 ASI Loader и расположение ASI/INI.
  Нет значков: проверьте data\txd\ManhuntGInput_Glyphs.txd. Без текстуры
  управление работает, но кнопки могут отображаться текстом.
  Нет геймпада: проверьте подключение, режим XInput, DirectPad и программу,
  которая скрывает HID-устройство или создаёт виртуальный контроллер.

  Для диагностики установите EnableLogging=1 в INI и перезапустите игру.
  Повторите проблему, выйдите и сохраните ManhuntGInput.log рядом с ASI
  перед следующим запуском. Приложите журнал при сообщении об ошибке.
  После проверки верните EnableLogging=0.

  Неофициальный фанатский мод. Manhunt принадлежит Rockstar Games.

УДАЛЕНИЕ

  Закройте игру и удалите ASI и INI этого мода, а также его журнал,
  если он был создан. Остальные установленные моды удалять не нужно.

ЯЗЫК И ПЕРЕВОДЫ

  В меню есть пункт «Язык мода»: «Игра / MHLL» (UiLanguage=Auto) и шесть
  встроенных языков. Выбор применяется сразу и сохраняется. Сброс настроек
  возвращает Auto. Меняются собственные строки мода; штатные названия
  остаются на языке игры. Для букв выбранного языка нужен игровой шрифт,
  который их поддерживает.

  Для внешнего перевода:
  1. Скопируйте data\ManhuntGInput\lang\template.txt.example в ту же папку
     под именем с окончанием .txt, например polski.txt.
  2. Добавьте Match = точная подпись «тип управления» из перевода игры
     (ключ CONTTYP, над списком кнопок).
  3. Переведите значения справа от = и сохраните файл как UTF-8. Используйте
     регистр и коды символов, принятые в GXT и шрифте вашего перевода.
  4. Выберите «Игра / MHLL» и оставьте стандартный UiTextFile в INI.
     После добавления файлов перезапустите игру. При смене языка через MHLL
     мод подбирает файл с подходящим Match. Файлы .example не загружаются.

  Пропущенные строки используют встроенный текст. ModLanguage и LanguageAuto
  переводят новый пункт и автоматический режим. Button.* задаёт названия
  кнопок без значков; Prompt.* — написания действий в обучающих подсказках.
  Button.* и Prompt.* следуют переводу игры даже при ручном выборе языка мода.
  В папке может лежать несколько переводов; образец объясняет все ключи.

БЛАГОДАРНОСТИ

  Спасибо ermaccer за PluginMH и опубликованные исходники.
  https://github.com/ermaccer/Manhunt.PluginMH

