==============================================================================
 MHMic — Микрофон и устройства звука / Microphone and Audio Devices
==============================================================================

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

  MHMic restores the headset behavior from the PS2 version of Manhunt. When
  you speak loudly enough into your microphone, hunters hear a noise and may
  investigate it. Microphone noise does not reach hunters in menus or while
  paused. Main game audio and the Director's voice can use separate devices.

REQUIREMENTS

  Manhunt for Windows, a 32-bit ASI loader and a microphone.
  ManhuntGInput is optional: it adds gamepad input and button icons.

INSTALLATION

  1. Install an ASI Loader following its instructions. Use Win32/x86, even on
    64-bit Windows.

  2. Put the files in the game folder containing manhunt.exe:

    Manhunt\MHMic.asi
    Manhunt\MHMic.ini
    Manhunt\data\MHMic\lang\template.txt.example
    Manhunt\data\MHMic\lang\russian.txt.example
    Manhunt\data\MHMic\lang\english.txt.example

  You can move ASI and INI together to Manhunt\scripts if your loader supports
  it. Do not keep two ASI copies. Back up your INI before updating to keep
  your settings.

  3. Start the game and open Settings > HEADSET.

CONTROLS

  Headset notice: Cross on PlayStation / A on Xbox with the updated
  ManhuntGInput, Enter on a keyboard. The prompt follows
  the active input device and GInput glyph settings. Mouse clicks cannot dismiss it.

  MICROPHONE   Voice sensitivity: OFF, -4...+4 dB.
  EARPIECE     Director voice volume: OFF, -4...+4 dB.
  MIC INPUT    Microphone selection.
  GAME AUDIO   Main game output device.
  DIRECTOR     A specific connected Windows playback device.

  Both sliders default to the middle (0 dB). To hear game audio through
  speakers and the Director through headphones, choose those devices in their
  respective rows.

  Clicking or pressing confirm on a device row cycles to the next choice and
  keeps the page open. Left and right cycle in either direction. The bottom
  Confirm button saves changes; Cancel restores the previous choices.

  Clicking a dB value only selects it and keeps the page open. Press Confirm
  to save; Cancel restores the previous values. DIRECTOR lists real playback
  devices only; for gamepad voice output, choose its Windows audio endpoint.

  Microphone and Director output changes apply immediately. Main game audio
  also switches immediately in the main menu, with no extra INI setting.
  Confirm saves the choice; Cancel restores it. Level pause menus require a restart.

  Gamepad voice output requires a DualSense or DualShock 4 connected by USB.
  Bluetooth audio is not supported. A DualSense sends the voice to connected
  headphones, or to its speaker when no headphones are connected.

SETTINGS

  MHMic.ini

  Common settings are available in the game menu. INI is located next to ASI;
  restart the game after editing it manually.

  Language         [General]: auto follows the game / MHLL; ru / en force
                   a built-in language; a file name selects a UTF-8 translation.
  Enabled          1 enables the mod; 0 disables it.
  PushToTalk       1 activates the microphone only while holding a key.
  PushToTalkKey    Push-to-talk key; T by default.
  Sensitivity      Additional microphone sensitivity.
  NoiseGate        Background noise cutoff threshold.
  RadarNoise       1 shows microphone noise on the radar during gameplay.
  PadSpeaker       1 activates the USB gamepad speaker automatically.
  AnnounceHeadset  1 shows a notice for a newly detected headset.

  There is one MHMic.ini with English/Russian comments. [General] comes first, then
  audio in [Headset] and behavior in [Behaviour]. [Microphone] / [Levels]
  contain tuning; [Debug] at the bottom is for diagnostics.
  Diagnostic options do not need changing for normal use.

SOUND TEST

  Select a row and press V. With an updated ManhuntGInput, press the right
  stick: R3 on PlayStation or RS on Xbox. The hint shows the button for the
  current input device.

  Microphone: speak and watch the radar wave. The test lasts 3 seconds. Press
  again or select another row to end it early. The menu wave appears only
  during this test.

  Game audio: two wooden bat impacts on the left, a bottle breaking on the
  right, then a weapon swing, knife impact, and short cry in both channels.
  About 3.1 seconds.

  Director: three different execution reactions, short on the left, medium on
  the right, and longer in both channels. About 5.3 seconds. The EARPIECE
  volume applies.

  Press again to stop playback. Clips play in full; the entire sequence lasts
  no longer than 10 seconds. Testing does not save your device choice or
  switch the main game audio. V is available without ManhuntGInput.

TROUBLESHOOTING

  Mod not loading: check the Win32 ASI Loader and ASI/INI location. Microphone
  not responding: check the selected device, Windows microphone permission,
  and MICROPHONE slider. No Director voice: check the output and EARPIECE
  slider; gamepad audio needs a USB connection.

  For diagnostics, set Log=1 in the INI's [Debug] section and restart the
  game. Reproduce the problem, exit, and save MHMic.log next to ASI before
  launching again. Include the log when requesting help. Restore Log=0
  afterwards.

  In CrossOver, add dinput8 for manhunt.exe with the load order native,
  builtin, and allow microphone access if macOS prompts for it.

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

  Select the mod language with the first [General] setting in MHMic.ini:
    Language=auto       Follow the game / MHLL language (default).
    Language=ru         Force Russian independently of the game language.
    Language=en         Force English independently of the game language.
    Language=spanish    Read data\MHMic\lang\spanish.txt as UTF-8.
  The .txt extension is optional. Manual file selection does not require Match.
  Restart the game after changing this setting. It does not change other game
  menus or GInput's language. Missing files/keys use built-in Russian or English
  according to the game language. Characters must be supported by the game font;
  Russian uses Latin transliteration on an English font. {button} in ContinueKeyboard
  and ContinuePad is replaced with the current confirmation button automatically.

  With Language=auto, standard labels follow the game's language. Use the samples
  in data\MHMic\lang: template.txt.example, russian.txt.example, and
  english.txt.example. Russian and English are also built into the mod.

  1. Copy a sample into the same folder with a name ending in .txt. The
    .example files are not loaded automatically.
  2. For automatic selection, set Match to the exact "control type" label in your game translation (GXT
    key CONTTYP).
  3. Translate the text after = and save as UTF-8. Use the letter case and
    character codes used by the translation's GXT and font.
  4. Restart the game. With Language=auto, switching language through MHLL selects the matching
    translation automatically; missing strings keep their built-in text.

  The samples include the new sound-test strings. Button labels are added
  automatically.

CHANGE HISTORY

  - Separate device choices for microphone, game audio, and Director voice.
  - Sound testing with V or R3/RS and a hint for the current input device.
  - Test sounds on the left, right, and both channels.
  - Menu radar wave only during microphone testing.
  - Clicking a device cycles choices without closing the page.
  - Long device names fit in full.
  - Updated MHLL strings and Russian/English translation samples.

CREDITS

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

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

  MHMic возвращает поведение гарнитуры из версии Manhunt для PS2. Когда вы
  достаточно громко говорите в микрофон, охотники слышат шум и могут пойти
  проверить его источник. В меню и на паузе шум охотникам не передаётся.
  Основной звук игры и голос Режиссёра можно направить на разные устройства.

ЧТО НУЖНО

  Manhunt для Windows, 32-битный ASI Loader и микрофон.
  ManhuntGInput необязателен: он добавляет управление геймпадом и значки.

УСТАНОВКА

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

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

    Manhunt\MHMic.asi
    Manhunt\MHMic.ini
    Manhunt\data\MHMic\lang\template.txt.example
    Manhunt\data\MHMic\lang\russian.txt.example
    Manhunt\data\MHMic\lang\english.txt.example

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

  3. Запустите игру и откройте Настройки > ГАРНИТУРА.

УПРАВЛЕНИЕ

  Уведомление о гарнитуре: Cross на PlayStation / A на Xbox с обновлённым
  ManhuntGInput, Enter на клавиатуре. Подсказка следует
  активному устройству ввода и настройкам иконок GInput. Клик мышью не закрывает окно.

  МИКРОФОН     Чувствительность голоса: ВЫКЛ, -4...+4 дБ.
  НАУШНИК      Громкость голоса Режиссёра: ВЫКЛ, -4...+4 дБ.
  ИСТОЧНИК     Выбор микрофона.
  ЗВУК ИГРЫ    Выбор устройства основного звука игры.
  РЕЖИССЕР     Конкретное подключённое устройство звука Windows.

  Обе шкалы по умолчанию стоят посередине (0 дБ). Для звука игры из колонок и
  голоса Режиссёра в наушниках выберите эти устройства в соответствующих
  строках.

  Клик или кнопка подтверждения на строке устройства выбирает следующий
  вариант и оставляет страницу открытой. Стрелки влево и вправо листают
  варианты в обе стороны. Нижняя кнопка «Подтвердить» сохраняет изменения,
  «Отмена» возвращает прежний выбор.

  Клик по значению dB только выбирает его и не закрывает страницу.
  Для сохранения нажмите «Подтвердить». «Отмена» возвращает прежние значения.
  В строке РЕЖИССЕР перечислены только реальные устройства; для голоса через
  геймпад выберите его устройство звука Windows.

  Микрофон и выход Режиссёра меняются сразу. Общий звук игры переключается
  сразу в главном меню, без отдельной настройки INI. «Подтвердить» сохраняет
  выбор, «Отмена» возвращает прежний. В паузе внутри уровня нужен перезапуск.

  Для голоса через геймпад нужен DualSense или DualShock 4 по USB. Звук через
  Bluetooth не поддерживается. В DualSense с подключёнными наушниками голос
  идёт в наушники, без них — в динамик.

НАСТРОЙКИ

  MHMic.ini

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

  Language         [General]: auto — игра / MHLL; ru / en — встроенный язык;
                   имя файла, например spanish — свой UTF-8 перевод.
  Enabled          1 — мод включён, 0 — выключен.
  PushToTalk       1 — микрофон работает только при удержании клавиши.
  PushToTalkKey    Клавиша для PushToTalk; по умолчанию T.
  Sensitivity      Дополнительная чувствительность микрофона.
  NoiseGate        Порог отсечения фонового шума.
  RadarNoise       1 — показывать шум микрофона на радаре во время игры.
  PadSpeaker       1 — автоматически включать динамик USB-геймпада.
  AnnounceHeadset  1 — показывать уведомление о новой гарнитуре.

  Используется один MHMic.ini с английскими комментариями. Язык и общие
  настройки — в [General] в начале, звук — в [Headset], поведение —
  в [Behaviour]. Тонкая настройка микрофона — в [Microphone] и [Levels],
  диагностика — в [Debug] в конце. Остальные параметры описаны в самом INI.
  Диагностические параметры при обычном использовании менять не требуется.

ПРОВЕРКА ЗВУКА

  Выберите строку и нажмите V. С обновлённым ManhuntGInput можно нажать правый
  стик: R3 на PlayStation или RS на Xbox. Подсказка показывает кнопку текущего
  устройства ввода.

  Микрофон: говорите и смотрите на волну радара. Проверка длится 3 секунды.
  Повторное нажатие или переход на другую строку выключает её раньше. В меню
  волна появляется только во время этой проверки.

  Звук игры: два удара деревянной битой слева, разбитая бутылка справа, затем
  взмах оружия, удар ножом и короткий крик в обоих каналах. Около 3,1 секунды.

  Режиссёр: три разные реакции на казнь — короткая слева, средняя справа,
  длинная в обоих каналах. Около 5,3 секунды. Учитывается громкость строки
  НАУШНИК.

  Повторное нажатие останавливает звуковой тест. Записи звучат целиком; вся
  последовательность не превышает 10 секунд. Проверка не сохраняет выбор
  устройства и не переключает основной звук игры. Без ManhuntGInput доступна
  клавиша V.

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

  Мод не загружается: проверьте Win32 ASI Loader и расположение ASI/INI.
  Микрофон не реагирует: проверьте выбранное устройство, разрешение Windows на
  доступ к микрофону и шкалу МИКРОФОН. Нет голоса Режиссёра: проверьте выход и
  шкалу НАУШНИК; для геймпада нужно USB-подключение.

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

  В CrossOver добавьте для manhunt.exe библиотеку dinput8 с порядком native,
  builtin и разрешите доступ к микрофону, если macOS его запросит.

УДАЛЕНИЕ

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

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

  Язык MHMic выбирается первым параметром секции [General] в MHMic.ini:
    Language=auto       Следовать языку игры / MHLL (по умолчанию).
    Language=ru         Русский язык независимо от языка игры.
    Language=en         Английский язык независимо от языка игры.
    Language=spanish    Читать data\MHMic\lang\spanish.txt в UTF-8.
  Можно указать имя с .txt. Для ручного выбора файла Match не нужен.
  Изменив параметр, перезапустите игру. Другие меню игры и язык GInput
  этот параметр не меняет. Если файл отсутствует, используется встроенный
  русский или английский по языку игры. Недостающие ключи также имеют этот fallback.
  Символы должны поддерживаться шрифтом игры. Русский на английском шрифте
  отображается латинской транслитерацией. {button} в строках ContinueKeyboard
  и ContinuePad подставляет текущую кнопку автоматически.

  При Language=auto штатные надписи следуют языку игры. Для переводов используйте образцы в
  data\MHMic\lang: template.txt.example, russian.txt.example и
  english.txt.example. Русский и английский также встроены в мод.

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

  Новые строки проверки включены в образцы. Обозначения кнопок добавляются
  автоматически.

ИСТОРИЯ ИЗМЕНЕНИЙ

  - Отдельный выбор устройств для микрофона, звука игры и Режиссёра.
  - Проверка звука по V или R3/RS с подсказкой по текущему устройству ввода.
  - Тестовые звуки слева, справа и в обоих каналах.
  - Волна радара меню только во время проверки микрофона.
  - Клик по устройству листает варианты, не закрывая страницу.
  - Длинные названия устройств помещаются целиком.
  - Дополнены строки локализации MHLL и русские/английские образцы.

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

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

