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…

168 ·GitHub
MGSPatriotFix
What is this?It's a bugfix and quality-of-life mod for the 'Metal Gear Solid Master Collection: Volume 2' releases of MGS4 and MGS Peace Walker on PC.
Is this a separate program or a mod I inject into the existing game?It is a DLL mod loaded through the Ultimate ASI Loader via winmm.dll, not a standalone program; it also ships a small Config Tool to generate and edit its settings file.
Do I need anything extra for Steam Deck/Linux or DualShock 3 support?On Steam Deck/Linux you need ProtonTricks (installed via the Discover store) plus a WINEDLLOVERRIDES launch option; for full DualShock 3 motion and rumble on Windows you need DsHidMini set to SXS mode.
Will this conflict with other mods I'm using?It's built to be compatible with other ASI mods that also hook winmm.dll, so it can generally be used alongside them.
Does it work only on Windows, or on Steam Deck too?It supports both: Windows works out of the box, while Steam Deck/Linux needs an extra WINEDLLOVERRIDES launch option and ProtonTricks for the config tool.
What does the DualShock 3 support add in MGS4?Pressure-sensitive face buttons and triggers, rumble, and motion support for actions like shaking the controller to reset OctoCamo.
What bugs does it fix besides GPU selection issues?It fixes monitors going to sleep during long cutscenes on Windows and resolves a Windows fullscreen-optimization issue that hurt performance in the MGS1 flashback sequence.
Are the nightly builds safe to use?No, they are experimental alpha builds with the newest features and fixes but may be unstable or crash; the official release is recommended for a stable experience.
What are similar projects?D2R-3D, dlssg_for_sm86, pt-pc, Yakumo, ReSkate, dlss-unlocked, Fable-2-Recomp, RingOut
Which topics is it in?patch, dll-injection, sdl3, pc-gaming, steam-deck, visual-studio, game-modding, logging, modding, cmake, game, gaming
Creator
ShizCalev
Size
2.7 MB
Stars
168
Updated
CommitSep 11Release0.2.2Sep 11
Age
1mo
Commits · 90 Days