==============================================================================
 Manhunt GInput — Геймпад для Manhunt (PC)
 Manhunt GInput — Controller Support for Manhunt (PC)
 r3 — релиз-кандидат / release candidate
==============================================================================

РУССКИЙ
=======

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

ТРЕБОВАНИЯ И УСТАНОВКА

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

  Проверена Steam-сборка, manhunt.exe с SHA-256:
  5001B64F77690316330575FCFE6ACD5C5115C5476C183FFEC0D86779B0686B52
  Другие исполняемые файлы не заявлены как совместимые.

  1. Установите ASI Loader, если его ещё нет. Он загружает ASI-плагины
     при запуске игры. Нужна версия Win32/x86, поскольку сама игра
     32-битная; версия x64 не подходит даже на 64-битной Windows.
     Например, можно использовать Ultimate ASI Loader. Файлы загрузчика
     разместите по его инструкции рядом с manhunt.exe. Если другие
     ASI-моды уже работают, второй загрузчик обычно не требуется.

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

    Manhunt\ManhuntGInput.asi
    Manhunt\ManhuntGInput.ini
    Manhunt\data\txd\ManhuntGInput_Glyphs.txd

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

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

  4. Запустите игру и откройте настройки геймпада. Выберите раскладку,
     значки и чувствительность. После ручного изменения INI требуется
     перезапуск игры.

  Manhunt Achievements и MHMic необязательны и устанавливаются отдельно.

РАСКЛАДКИ

  В настройках геймпада в игре доступны PS2, Xbox с одним стиком,
  Xbox с двумя стиками и Modern. PS2 включена по умолчанию.
  Ниже указаны исходные назначения; свои кнопки можно задать в меню.
  GlyphSet меняет только значки, а не раскладку.

  Обозначения Xbox / PlayStation:
    A = крестик; B = круг; X = квадрат; Y = треугольник.
    LB/RB = L1/R1; LT/RT = L2/R2.
    L3/R3 = нажатие левого/правого стика.
    Start = START/OPTIONS; Back = SELECT/SHARE/Create.

  PS2 — классическая раскладка
  ---------------------------
    Левый стик          движение и поворот
    Правый стик         камера, прицел и выбор цели
    A / крестик         атака, выстрел, казнь
    X / квадрат         сильная атака или перезарядка
    Y / треугольник     взаимодействие
    B / круг            смена предмета
    LB / L1             захват цели
    RB / R1             бег
    LT / L2             шаг влево
    RT / R2             шаг вправо
    LT+RT / L2+R2       быстрый разворот
    Крестовина влево    выглянуть влево
    Крестовина вправо   выглянуть вправо
    R3                  оглянуться
    Start               пауза

    Небольшой наклон левого стика даёт скрытное движение.
    В снайперском прицеле наведение выполняется левым стиком.
    INI: ControlScheme=ClassicA, ControlLayout=PlayStation2.

  Xbox — один стик
  ----------------
    Левый стик          движение и поворот
    Правый стик         камера, прицел и выбор цели
    A                   атака, выстрел, казнь
    X                   сильная атака или перезарядка
    Y                   взаимодействие
    B                   смена предмета
    LT                  захват цели
    RT                  бег
    LB                  шаг влево (White оригинального Xbox)
    RB                  шаг вправо (Black оригинального Xbox)
    LT+RT               быстрый разворот
    Крестовина влево    выглянуть влево
    Крестовина вправо   выглянуть вправо
    R3                  оглянуться
    Start               пауза

    Небольшой наклон левого стика даёт скрытное движение.
    В снайперском прицеле наведение выполняется левым стиком.
    INI: ControlScheme=ClassicA, ControlLayout=XboxOriginal.

  Xbox — два стика
  ----------------
    Левый стик          движение, включая шаги в стороны
    Правый стик         камера, поворот, прицел и выбор цели

    Кнопки совпадают с Xbox с одним стиком; дополнительно:
    Крестовина вверх    вид от первого лица

    В снайперском прицеле правый стик наводит, левый меняет приближение.
    INI: ControlScheme=ClassicB, ControlLayout=XboxOriginal.

  Modern — современная раскладка
  ------------------------------
    Левый стик          движение, включая шаги в стороны
    Правый стик         камера, поворот, прицел и выбор цели
    LT / L2             прицеливание / захват цели
    RT / R2             атака, выстрел, казнь
    A / крестик         взаимодействие
    X / квадрат         сильная атака или перезарядка
    Y / треугольник     смена предмета
    B / круг            быстрый разворот
    L3                  бег
    R3                  оглянуться
    LB / L1             выглянуть влево
    RB / R1             выглянуть вправо
    LT+LB / L2+L1       шаг влево при прицеливании
    LT+RB / L2+R1       шаг вправо при прицеливании
    Крестовина вверх    следующий предмет
    Крестовина вниз     предыдущий предмет
    Back                вид от первого лица
    Start               пауза

    В снайперском прицеле правый стик наводит, левый меняет приближение.
    INI: ControlScheme=Modern.

  L3, Back и крестовина вверх/вниз без назначения в выбранной раскладке
  не выполняют отдельного игрового действия. Действие «красться» можно
  назначить вручную; в классических раскладках отдельной кнопки нет.

МЕНЮ И ВИДЕО

  Левый стик или крестовина — выбор пункта.
  A / крестик — подтверждение, в том числе на экране смерти.
  В PS2: Y / треугольник — назад.
  В Xbox и Modern: B / круг — назад.
  Back или Start также возвращают назад; в игре Start открывает паузу.
  A / крестик или Start пропускают вступительные Bink-видео после
  штатной задержки игры.

ВИБРАЦИЯ

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

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

НАСТРОЙКИ (файл ManhuntGInput.ini)

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

  ManhuntGInput.ini содержит английские пояснения. Для русских пояснений
  используйте ManhuntGInput_RU.ini: переименуйте его в ManhuntGInput.ini
  и замените основной файл, предварительно сохранив свои настройки.
  Значения в обеих поставляемых версиях одинаковые; плагин читает только
  файл с именем ManhuntGInput.ini.

  GlyphSet                 Auto — значки по геймпаду; PS3 или Xbox360 —
                           выбранный набор; None — названия кнопок.
  DirectPad                true — прямой ввод DualShock 4 / DualSense.
  Lightbar                 Active — состояние игры; Health — здоровье;
                           Off — подсветка выключена.
  LeftDeadzone             Мёртвая зона левого стика; по умолчанию 0.35.
  RightDeadzone            Мёртвая зона правого стика; по умолчанию 0.35.
  MovementSensitivity      Чувствительность движения.
  RightSensitivityX/Y      Чувствительность камеры по горизонтали/вертикали.
  InvertRightY             1 — стик вверх направляет взгляд вниз;
                           0 — вверх. По умолчанию 1.
  AutoAim                  1 — захват цели на геймпаде; 0 — ручной прицел.
  MeleeLockOn              Захват цели ближнего боя; требует AutoAim=1.
  EnableVibration          1 — вибрация включена, 0 — выключена.
  VibrationStrength        Общая сила от 0.0 до 1.0.
  EnableExecutionVibration Казни.
  EnableInteractionVibration Действия с окружением.
  ChargeVibration           Заряд казни.
  DamageVibration           Получение урона.
  EnableLogging            0 — без журнала, 1 — диагностический журнал.

  Другие параметры и переназначения описаны в комментариях INI.

ПЕРЕВОД ДЛЯ MHLL

  Штатные надписи берутся из текущего языка игры. Для добавленных модом
  строк есть отдельные файлы перевода; исходный образец включён в архив:
  data\ManhuntGInput\lang\template.txt.example.

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

  Отсутствующие строки сохраняют встроенный текст. Button.* задаёт
  текстовые названия кнопок при отключённых значках. Если название
  действия в обучении отличается от меню, добавьте Prompt.<действие>;
  например Prompt.LookBehind = текст действия в подсказке.
  Допустимые имена действий и примеры находятся в образце.

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

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

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

==============================================================================
 ENGLISH
==============================================================================

  Manhunt GInput adds analog movement, camera/aim, four layouts, remappable
  buttons, controller prompts and rumble to the PC version of Manhunt.
  Keyboard and mouse remain available; prompts follow the active device.

REQUIREMENTS AND INSTALLATION

  You need the Windows PC version of Manhunt, a Win32/x86 ASI Loader,
  and an XInput controller or a DualShock 4 / DualSense. Rumble requires
  a controller with motors; controls work without them.

  Tested with the Steam executable whose SHA-256 is listed above.
  Other executables are not claimed to be compatible.

  1. Install an ASI Loader if you do not already have one. It loads ASI
     plugins when the game starts. Use Win32/x86: Manhunt is a 32-bit game,
     so an x64 loader will not work even on 64-bit Windows. Ultimate ASI
     Loader is one option. Place its files beside manhunt.exe following
     its instructions. If other ASI mods already work, a second loader
     is usually unnecessary.

  2. Find the game directory containing manhunt.exe. Extract the mod there,
     preserving the directory structure:

    Manhunt\ManhuntGInput.asi
    Manhunt\ManhuntGInput.ini
    Manhunt\data\txd\ManhuntGInput_Glyphs.txd

     ASI and INI may go together in Manhunt\scripts if the loader supports
     it. Keep the TXD under Manhunt\data\txd. Keep only one ASI copy and
     back up your INI before updating to preserve settings and bindings.

  3. Connect the controller before launching the game. Leave DirectPad=true
     in the INI for direct USB/Bluetooth DualShock 4 / DualSense input.
     No XInput translator is required for direct input. Software hiding
     the HID device may prevent direct access.

  4. Launch the game and open the gamepad settings to select the layout,
     icons and sensitivity. Restart after editing the INI by hand.

  Manhunt Achievements and MHMic are optional and installed separately.

LAYOUTS

  Choose PS2, Xbox one stick, Xbox two sticks or Modern in the gamepad
  settings. PS2 is the default. Bindings below are the default assignments;
  remap them in the game. GlyphSet changes icons, not the control layout.

  Xbox / PlayStation names:
    A = Cross; B = Circle; X = Square; Y = Triangle.
    LB/RB = L1/R1; LT/RT = L2/R2; L3/R3 = stick clicks.
    Start = START/OPTIONS; Back = SELECT/SHARE/Create.

  PS2 — classic
  -------------
    Left stick          move and turn
    Right stick         camera, aim and target selection
    A / Cross           attack, fire, execute
    X / Square          strong attack or reload
    Y / Triangle        interact
    B / Circle          change item
    LB / L1             lock on
    RB / R1             sprint
    LT / L2             strafe left
    RT / R2             strafe right
    LT+RT / L2+R2       quick turn
    D-pad left/right    peek left/right
    R3                  look behind
    Start               pause

    A slight left-stick push gives stealth movement.
    In the sniper scope, aim with the left stick.
    INI: ControlScheme=ClassicA, ControlLayout=PlayStation2.

  Xbox — one stick
  ----------------
    Left stick          move and turn
    Right stick         camera, aim and target selection
    A                   attack, fire, execute
    X                   strong attack or reload
    Y                   interact
    B                   change item
    LT                  lock on
    RT                  sprint
    LB                  strafe left (original Xbox White)
    RB                  strafe right (original Xbox Black)
    LT+RT               quick turn
    D-pad left/right    peek left/right
    R3                  look behind
    Start               pause

    A slight left-stick push gives stealth movement.
    In the sniper scope, aim with the left stick.
    INI: ControlScheme=ClassicA, ControlLayout=XboxOriginal.

  Xbox — two sticks
  -----------------
    Left stick          move, including sideways
    Right stick         camera, turn, aim and target selection

    Buttons match Xbox one stick, with one additional assignment:
    D-pad up            first-person view

    In the sniper scope, the right stick aims and the left stick zooms.
    INI: ControlScheme=ClassicB, ControlLayout=XboxOriginal.

  Modern
  ------
    Left stick          move, including sideways
    Right stick         camera, turn, aim and target selection
    LT / L2             aim / lock on
    RT / R2             attack, fire, execute
    A / Cross           interact
    X / Square          strong attack or reload
    Y / Triangle        change item
    B / Circle          quick turn
    L3                  sprint
    R3                  look behind
    LB / L1             peek left
    RB / R1             peek right
    LT+LB / L2+L1       strafe left while aiming
    LT+RB / L2+R1       strafe right while aiming
    D-pad up/down       next/previous item
    Back                first-person view
    Start               pause

    In the sniper scope, the right stick aims and the left stick zooms.
    INI: ControlScheme=Modern.

  L3, Back and D-pad up/down have no separate gameplay action unless
  assigned in the chosen layout. Sneak can be bound manually; the classic
  layouts use a slight stick push instead of a dedicated sneak button.

MENUS AND VIDEOS

  Left stick or D-pad navigates; A / Cross confirms, including on death.
  PS2 uses Y / Triangle to go back; Xbox and Modern use B / Circle.
  Back or Start also goes back. During gameplay, Start pauses.
  A / Cross or Start skips intro Bink videos after the game's delay.

RUMBLE

  Preserved console game events, weapon executions, execution charge,
  damage and the chainsaw engine. Added scenes include the Piggsy finale,
  Starkweather's door and execution, and the View of Innocence TV smash.
  Environmental effects cover switches, buttons, levers, the sewer wheel,
  chain, rope, petrol can, refuelling, van door and lock. No added crane rumble.
  Effects follow game events and animations; some accents are timed to audio.
  Automated tests pass; live checking of every new effect is still pending.
  A controller with motors is needed to feel the effects.

LOCALIZATION FOR MHLL

  Standard labels use the current game language. Added mod strings support
  separate translation files. The archive includes this template:
  data\ManhuntGInput\lang\template.txt.example.

  1. Copy it into the same directory with a name ending in .txt, such as
     polski.txt. The .example file itself is not loaded.
  2. Add Match = the exact controls-type label from your game translation
     (the CONTTYP key, above the button list).
  3. Translate text to the right of = and keep the key names unchanged.
     Save as UTF-8. Follow the letter case and character codes used by
     your translation's GXT files and font.
  4. Keep UiLanguage=Auto and the default UiTextFile path in the INI,
     then restart. When you change the language through MHLL, the mod
     selects the file with the matching Match. Multiple translations
     can share this directory.

  Missing entries retain built-in text. Button.* sets text button names
  when icons are disabled. If a tutorial names an action differently from
  the menu, add Prompt.<action>, for example Prompt.LookBehind = the name
  used in the hint. The template lists supported actions and examples.

SETTINGS AND HELP

  Keep the INI beside the ASI. Main settings are available in the game;
  restart after editing the INI by hand. Other keys are explained in the INI.

  ManhuntGInput.ini has English comments. ManhuntGInput_RU.ini has Russian
  comments and the same shipped values. To use it, back up your settings,
  rename it to ManhuntGInput.ini and replace the main file. The plugin reads
  only ManhuntGInput.ini.

  GlyphSet                 Auto, PS3, Xbox360 or None (text labels).
  DirectPad                true enables direct Sony controller input.
  Lightbar                 Active, Health or Off.
  LeftDeadzone/RightDeadzone Stick dead zones; both default to 0.35.
  MovementSensitivity      Movement sensitivity.
  RightSensitivityX/Y      Horizontal/vertical camera sensitivity.
  InvertRightY             1 = up looks down (default); 0 = up looks up.
  AutoAim                  1 = pad lock-on; 0 = manual aim.
  MeleeLockOn              Melee lock-on; requires AutoAim=1.
  EnableVibration          1 = on; 0 = off.
  VibrationStrength        Overall strength, 0.0 to 1.0.
  EnableExecutionVibration Execution effects.
  EnableInteractionVibration Environmental effects.
  ChargeVibration          Execution charge.
  DamageVibration          Taking damage.
  EnableLogging            0 = off; 1 = diagnostic log.

  If the plugin does not load, check the x86 loader and ASI location.
  Missing icons: check data\txd\ManhuntGInput_Glyphs.txd; without the TXD,
  controls still work and buttons may appear as text. An undetected pad:
  check its connection, XInput mode and any translator software.

  For diagnostics, set EnableLogging=1 under [Gamepad] and restart.
  Reproduce the issue, exit, and save ManhuntGInput.log beside the ASI.
  Include the log when asking for help. Set EnableLogging=0 afterwards
  and restart the game.
