MGSPatriotFix README

The project's README from github.com/ShizCalev/MGSPatriotFix. As one markdown file: README.md.

Metal Gear Solid Patriot Fix

Releases Downloads Commits License

Discord

Peace Walker Nexus Page | MGS4 Nexus Page | GitHub Repo (You're already here!)


This is bugfix mod for the Metal Gear Solid Master Collection: Volume 2 versions of MGS4 & MGS Peace Walker.


[!NOTE] This mod should be compatible with other ASI mods that use winmm.dll.

Games Supported


Other Metal Gear Fix Projects


Features

[!NOTE] (More features and fixes are added frequently and may be missing from this list.)

Shared Features

MGS4 Specific Features:

Peace Walker Specific Features


Bug Fixes

Shared Bugfixes:

MGS4 Specific Bugfixes:

Peace Walker Specific Bugfixes:


Installation

Steps:

  1. Grab the latest release of MGSPatriotFix from here.
    • There are two separate zips per release, one per game:
      • MGS4_MGSPatriotFix_<version>.zip for Metal Gear Solid 4
      • PW_MGSPatriotFix_<version>.zip for Metal Gear Solid: Peace Walker
  2. Extract the contents of the zip into the matching game's root folder.
    • (e.g., extract the MGS4 zip's contents into steamapps\common\METAL GEAR SOLID 4, the PW zip's contents into steamapps\common\MGS_PW.)
  3. Launch the MGSPatriotFix Config Tool (in the game's root folder) to generate a settings file.

Steam Deck/Linux Additional Instructions

[!NOTE] 🚩 These steps are only needed if you’re on Steam Deck/Linux. Skip if you’re using Windows.


Configuration


DualShock 3 Setup

Windows:

(This matches the configuration required for PCSX2. If your DS3 controller is already set up properly with PCSX2, then you're already good to go!)

Steam Deck / Linux:

[!NOTE] 🚩 These steps are only needed if you’re on Steam Deck/Linux. Skip if you’re using Windows.

The pad works out of the box without any additional software or drivers, but Steam needs to be told to prefer it.

Step 1)

Step 2)

mgs2 - d00t - rain 1

Step 3)

mgs2 - d00t - rain 1

Support

Please report any issues you notice on our Github here.

For more immediate problems, you can contact us in the #PatriotFix channel of the Metal Gear Network Discord.


MGS Master Collection - Community Bug Tracker


Nightly Builds

[!NOTE] Experimental alpha builds containing the latest features and fixes are available on the nightly release page.

These builds may be unstable or crash unexpectedly. They are intended for users who want to test upcoming changes before an official release.

For the most stable experience, download the latest official release instead.


Building

git clone https://github.com/ShizCalev/MGSPatriotFix.git
cd MGSPatriotFix
git submodule update --init --recursive
git config submodule.recurse true

wxWidgets has nested Git submodules; git config submodule.recurse true ensures they are automatically updated to the correct commits when pulling.

wxWidgets, SDL3, and Zydis are built automatically as part of the Visual Studio build process. They can also be manually rebuilt from a Visual Studio Developer Command Prompt using build_wx.cmd, build_sdl3.cmd, or build_zydis.cmd respectively.

Build Requirements

Windows

Open MGSPatriotFix.sln in Visual Studio (2026) and build.


Credits

Created and maintained by @ShizCalev/Afevis.
With more amazing feature & fix contributions by @cipherxof (Disable Motion Blur), Emoose (Raw Mouse Input, Increased Shadow Resolution), and @gibletto (DualShock 3 support).

Used Libraries & Software:

Ultimate ASI Loader for ASI loading.
inipp for ini reading.
spdlog for logging.
safetyhook for hooking.
Universal Config Tool (made by @ShizCalev/Afevis. Powered by SDL3.)

MGSPatriotFix (ShizCalev/MGSPatriotFix)

Searching Database…

Что это?Это мод с исправлениями багов и улучшениями удобства для PC-версий MGS4 и MGS Peace Walker из сборки «Metal Gear Solid Master Collection: Volume 2».
Это отдельная программа или мод, встраиваемый в существующую игру?Это DLL-мод, загружаемый через Ultimate ASI Loader посредством winmm.dll, а не отдельная программа; в комплект также входит небольшой Config Tool для создания и редактирования файла настроек.
Нужно ли что-то дополнительное для Steam Deck/Linux или поддержки DualShock 3?На Steam Deck/Linux понадобится ProtonTricks (устанавливается через магазин Discover) плюс параметр запуска WINEDLLOVERRIDES; для полной поддержки гироскопа и вибрации DualShock 3 на Windows нужен DsHidMini в режиме SXS.
Будет ли он конфликтовать с другими моими модами?Он сделан совместимым с другими ASI-модами, которые тоже цепляются к winmm.dll, так что обычно их можно использовать вместе.
Работает он только на Windows или и на Steam Deck?Поддерживаются и то и другое: на Windows всё работает сразу, а на Steam Deck/Linux нужны дополнительный параметр запуска WINEDLLOVERRIDES и ProtonTricks для утилиты настройки.
Что даёт поддержка DualShock 3 в MGS4?Кнопки и триггеры с чувствительностью к нажатию, вибрация и управление движением для действий вроде встряхивания геймпада, чтобы сбросить OctoCamo.
Какие баги он исправляет помимо проблем с выбором GPU?Исправляет уход мониторов в спящий режим во время длинных катсцен на Windows и устраняет проблему Windows с оптимизацией полноэкранного режима, снижавшую производительность во флешбэк-сцене из MGS1.
Безопасно ли использовать ночные сборки?Нет, это экспериментальные альфа-сборки с самыми свежими функциями и исправлениями, но они могут быть нестабильными или падать; для стабильной работы рекомендуется официальный релиз.
Creator
ShizCalev
Size
2.7 MB
Stars
168
Age
1mo
Commits · 90 Days