MGSHDFix

Metal Gear Solid Master Collection Fix

MG1 / MG2 Nexus Page | MGS2 Nexus Page | MGS3 Nexus Page | GitHub Repo (You’re already here!) | GitLab Repo Mirror

This is a fix that adds custom resolutions, ultrawide support and much more to the Metal Gear Solid Master Collection.

Featured by:
IGN (Video Guide) • IGN (Best Mods List) • Digital Foundry / Eurogamer • PC Gamer • Rock Paper Shotgun • Ocelot (YouTube) • GamingOnLinux • Dextero

Games Supported

• Metal Gear 1/2 (MSX)
• Metal Gear Solid 2
• Metal Gear Solid 3

Other Metal Gear Fix Projects

• MGS Master Collection - Metal Gear Solid 1 and Bonus Content (MG1/2 NES) | MGSM2Fix - Repo / Nexus Page
• Metal Gear Solid V: The Phantom Pain | MGSVFix - Repo
• Metal Gear Solid Delta: Snake Eater | MGSDeltaFix - Repo / Nexus Page

Features

Shared Engine Features:

• Custom resolution/ultrawide support.
• Experimental 16:9 HUD option that resizes HUD/movies (MGS2/MGS3).
• Borderless/windowed mode.
• Mouse cursor toggle.
• Launcher skips (see Config Tool to configure).
• Option to disable pausing on alt-tab.
• Option to disable bilinear texture filtering, giving the games a pixel art/retro appearance. PR #138
• Increased texture size limits (MG1/MG2/MGS3).
• Adds support for custom PS2 controller glyphs without overwriting existing textures.
• Option to continue aiming your gun after firing it while in first-person/while holding lock-on.
• Toggleable wireframe modes.
• Option to force highest level polygon models during gameplay & cutscenes (improving visual quality.)
• Adjustable anisotropic filtering (MGS2/MGS3).
• Skip intro logos (MGS2/MGS3).
• Option to disable 2011 HD Collection gameplay camera angle/positioning changes.
• Option to adjust scale and opacity of cutscene captions.
• Option to disable Steam Achievement unlocking. (For speedrunners.)

MG / MG2 Specific Features

• Option to crop overscan borders on the top/bottom of the screen.

MGS2 Specific Features:

• Option to enable Bluepoint’s cancelled Subsistence style Third Person view camera.
• Option to enable Bluepoint’s cancelled First Person Shooter camera.
• Option to restore 2001 Japanese Sons of Liberty phone ringtone.
• Option to restore PlayStation 2 Solidus choking durations & health reduction (rebalanced in the HDC.)
• Option to force Snake / Raiden to wear their sunglasses (and outright disable their sunglasses.)
• Option to force Real Time Clock based hostage Easter Egg.
• Option to restore grenade cooking (having detonation timer start while the grenade is still held.)
• Option to swap X/O (OK / CANCEL inputs) in Menus.
• Option to swap thermal goggle color palettes in realtime (Substance/vanilla, red hot / Sons of Liberty, Splinter Cell Blacklist, black hot, white hot.) Examples
• Option to enable cut Metal Gear 2: Solid Snake Colonel sprites during some late-game Codec calls. PR #234
• Option to restore original 2001 Sons of Liberty radar rotation. Example
• BP_Asset / Manifest file modloader support. PR #251

MGS3 Specific Features:

• Option to force grass to render at all distances.
• Mouse sensitivity adjustment.

Bug Fixes

Shared Engine Bugs:

• Fix idle wait issue, dramatically reducing CPU usage - increasing game performance. [PR#225]
• Fixes the collection’s games sometimes defaulting to integrated graphics processors on systems with multiple GPUs (due to Nvidia/AMD driver misconfiguration.)
• Fixes gameplay/cutscene aspect ratio for ultrawide resolutions (MGS2/MGS3).
• Fixes window size on displays with High DPI scaling enabled. PR #127
• Fixes the monitor going to sleep during long cutscenes (for Windows only, Linux needs to be fixed by Valve.
• Fixes the bug where your character would start aiming right away after re-equipping a gun that was drawn when you put it away.
• Fixes vector effects / line based rendering scaling (ie rain, lasers, bullet trails.) PR #140
• Fixes UI scaling. PR #181
• Option to force the game to output stereo audio, which corrects the infamous “rain is louder than codec conversations” issue. PR #162

MGS2 Specific Bug Fixes:

• Restores contrast / color filter post processing effects in numerous cutscenes, which have been broken/missing since the 2011 HD Collection. Examples (SPOILER WARNING)
• Restore broken heat haze post processing effect on roof of Strut A.
• Restore underwater UI swimming post processing effect. PR #245
• Restores numerous particle and visual effects to proper PS2 timing, fixing effects that ran at double speed and ended too early in the HD Collection and Master Collection versions.
• Restores dogtag viewer information.
• Restores color swapping Red / Blue “2” on the title screen after game completions. (Requires MGS2 Community Bugfix Compilation)
• Fixes in-game timer not pausing during loading times. (This was a HD Collection regression. IGT behavior now matches with Substance.)
• Fixes Depth of Field / blur post processing effects not scaling with resolution. PR #248
• Fixes shadow resolution not scaling with game resolution. (It was hard-coded to 256x256 / PS2 resolution.)
• Fixes incorrectly positioning “Metal Gear Solid 2” title card during the start of Tanker when playing in Letterbox mode. Example
• Fixes crashes, audio desync, timer delays, and broken loading zones bugs caused by alt-tabbing the game. (For speedrunners who utilize this bug to skip forced codec calls, this bugfix can be forced off in the ini.)
• Fixes the Steam Cloud related “DAMAGED SAVE” / “CORRUPT SAVE” issue.
• Fixes bug where your character would stop aiming their gun while holding L1 when you fully tilt your joystick.
• Fixes typos in several Snake Tales missions, and in the in-game novel “In The Darkness of Shadow Moses”. PR#201
• Fixes optical camouflage refraction effects. [PR#228]
• Fixes unique Metal Gear Ray unit numbers not properly updating. [PR#229]
• Fixes Harrier not properly updating damaged state textures. [PR#229]
• Fixes coolant not fogging up breakable mirrors / glass. [PR#231]
• Fixes coolant glass fog appearing as hot in thermal goggles. [PR#232]
• Fixes sensor-A Bomb radar overlay moving as the player moves.
• Fixes broken sun reflections / sparkles during a lategame cutscene. Spoilers
• Fixes broken Colonel MGS1/Ghost Babel sprites. Example
• Fixes incorrect audio location when Solidus strikes Raiden with his tentacle arms. [PR#227]
• Fixes Shell 1 B2 Computer Room parrot’s radar cone not turning to face the player.
• Fixes invisible shell casing in cutscenes.
• Fixes hostages having incorrectly colored hands in Shell 1 Core. (Requires MGS2 Community Bugfix Compilation) PR #247
• Fixes incorrect screen texture during a Shell 1 core cutscene. (Requires MGS2 Community Bugfix Compilation) PR #247

MGS3 Specific Bug Fixes:

• Restores the PlayStation 2’s original cutscene camera/viewport height, fixing the 2011 HD Collection bug that cropped roughly the bottom 10% of the image in all cutscenes. (Notably, this issue was officially fixed in both the 3DS remake and Delta.)
• Fixes water reflections (MGS3). See PR #71 for a breakdown of the issue.
• Fixes Depth of Field / blur post processing effects not scaling with resolution.

Logging / Warnings for Common Configuration Issues

• Warnings for common mod compatibility & installation issues - which often result in crashes.
• Warnings if your game’s audio is muted via the game’s main launcher.
• Logging for Steam Input’s controller status (ie detected controllers, keybinds, ect.)

Installation

• Delete d3d11.dll from your game folder.
• Delete old MGSHDFix files (e.g., MGSHDFix Config Tool.exe and MGSHDFix.asi) before installing the update.

Steps:

1. Grab the latest release of MGSHDFix from here.
2. Extract the contents of the release zip into your game folder.
   • (e.g., steamapps\common\MGS2 or steamapps\common\MGS3 for Steam.)
3. Set both “Internal Resolution” & “Internal Upscaling” to Default / Original in the game’s launcher. (Resolution is entirely handled by MGSHDFix.)
4. Launch the MGSHDFix Config Tool (in the game’s /plugins folder) to generate a settings file if you’re installing the mod for the first time.

Steam Deck/Linux Additional Instructions

• Open up the game properties of either MGS2/MGS3 in Steam and add the following line to the launch options:

  WINEDLLOVERRIDES="wininet,winhttp=n,b" %command%
  

• MGSHDFix’s Config Tool requires ProtonTricks to be installed via Linux’s Discover software store.

• When opening the MGSHDFix Config Tool on Steam Deck/Linux, a Proton Tricks Wine Prefix window will pop up. Select any game and hit “OK” to open the MGSHDFix Config Tool.

  • If you do not have any games in the list, or the MGSHDFix Config Tool fails to launch, add it as a non-steam game and launch it once through Steam to generate a new Proton Tricks Wine Prefix entry.
  • You can remove the Config Tool from your Steam game list and launch it directly after generating this prefix.

Configuration

• See MGSHDFix Config Tool.exe in the /plugins folder to adjust settings for the fix.

Support

Please report any issues you notice on our Github here.

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

Known Issues

This list will contain bugs which may or may not be fixed.

MGS 2

• Strength of post-processing may be reduced at higher resolutions. (#35)
• Various visual issues when using the experimental HUD fix. (#41)

MGS 3

• Strength of post-processing may be reduced at higher resolutions. (#35)
• Various visual issues when using the experimental HUD fix. (#41)

MGS Master Collection - Community Bug Tracker

• A detailed tracker which catalogs all of the known Master Collection bugs (including issues fixed by MGSHDFix) can be located here.
• To submit new entries to the tracker, either report a new issue on the MGSHDFix Github, or use this form.

Examples

Unmodded Metal Gear Solid 2	MGSHDFix
Unmodded Metal Gear Solid 2	MGSHDFix

Unmodded Metal Gear Solid 3	MGSHDFix
Unmodded Metal Gear Solid 3	MGSHDFix

Upcoming Fix/Feature Roadmap - (Version Problem Originated)

• MG1 / MG2 - Add Custom Loading Screen Support (2023 MC)
• MGS2 - Make the in-game Radar, Cutscene Letterboxing, and Previous Missions reading progress persistent across game sessions. (2001 SoL)
• MGS3 - Fix Angle of Attack Indicator in FPV with NVG & Thermals (2011 HDC)
• MGS3 - Fix Weapons Not Appearing in Holster After Torture (2004 Snake Eater)
• MGS2 / MGS3 - Correct More Sped Up Effects (2002 Xbox / 2011 HDC)
• MGS3 - Swap X/O Buttons on Controller in Menus (2011 HDC)

Building

git clone https://github.com/ShizCalev/MGSHDFix.git
cd MGSHDFix
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.

Requirements

• Visual Studio 2022 or Visual Studio 2026
• Desktop development with C++
• MSVC v143 - VS 2022 C++ x64/x86 build tools
• Windows 10/11 SDK
• A recent CMake version that supports your installed Visual Studio version

• Zydis does not yet support the v145 toolset, so the project currently requires the Visual Studio v143 build tools. Visual Studio 2026 can still be used as long as the v143 toolset is installed. This will be changed once v145 support is added.

Windows

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

Credits

@Lyall for their amazing work making widescreen fix mods, and most importantly, the original creation of this mod!
@ShizCalev/Afevis for long-term maintenance (taking over the project in early 2025), and contributing fixes.
@emoose, @cipherxof, @Bud11, @SpaceCore, @gibletto and Zenf0 for contributing fixes/features.
Ultimate ASI Loader for ASI loading.
inipp for ini reading.
spdlog for logging.
safetyhook for hooking.
stb for png decoding. Gamma correction based off [SweetFX Shader Suite by CeeJay.dk]. SMAA made by Jorge Jimenez, Jose I. Echevarria, Belen Masia, Fernando Navarro, Diego Gutierrez. Universal Config Tool (made by ShizCalev/Afevis. Powered by SDL3.)