Skip to content

README.md

Latest commit

 

History

History
234 lines (178 loc) · 18.4 KB

README.md

File metadata and controls

234 lines (178 loc) · 18.4 KB

Metal Gear Solid Master Collection Fix

Releases Downloads Commits License

Discord

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

Note

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

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.)

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.

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 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.
  • 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]
  • Restores dogtag viewer information.

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.

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

Note

🚩 If updating from a previous version of MGSHDFix:

  • 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

Note

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

  • 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

MGS2 widescreen cutscene preview
Unmodded Metal Gear Solid 2 MGSHDFix
mgs2 - d00t - rain 1 mgs2 - d00t - rain 1
mgs2 - d00t - rain 1 mgs2 - d00t - rain 1
mgs2 - d00t - rain 1 mgs2 - d00t - rain 1
mgs2 - d00t - rain 1 mgs2 - d00t - rain 1
mgs2 - d00t - rain 1 mgs2 - d00t - rain 1
mgs2 - d00t - rain 1 mgs2 - d00t - rain 1
Unmodded Metal Gear Solid 2 MGSHDFix
MGS3 widescreen gameplay preview
Unmodded Metal Gear Solid 3 MGSHDFix
mgs2 - d00t - rain 1 mgs2 - d00t - rain 1
mgs2 - d00t - rain 1 mgs2 - d00t - rain 1
mgs2 - d00t - rain 1 mgs2 - d00t - rain 1
mgs2 - d00t - rain 1 mgs2 - d00t - rain 1
Unmodded Metal Gear Solid 3 MGSHDFix

MGS3 - Corrected cutscene framing

MGS3 - Corrected cutscene framing

MGS3 - Correctly scaled rain on bridge scene

MGS3 - Correctly scaled rain in The Sorrow's river

MGS3 - Wireframe mode visual

Upcoming Fix/Feature Roadmap - (Version Problem Originated)

  • MG1 / MG2 - Add Custom Loading Screen Support (2023 MC)
  • MG1 / MG2 - Crop Screen Borders (2011 HDC)
  • MGS2 - Fix Broken Cutscene Color Filters (2002 Xbox)
  • 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 - Add Custom Anti-Aliasing Solution (2023 MC)
  • MGS2 / MGS3 - Correct Display Gamma & RGB Levels (2011 HDC)
  • MGS2 / MGS3 - Correct More Sped Up Effects (2002 Xbox / 2011 HDC)
  • MGS2 / MGS3 - Fix Depth of Field Scaling Strength (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 & Zydis are both built automatically as part of the build change. They can also be manually rebuilt using build_wx.cmd or build_zydis.cmd respectively.

  • Zydis does not yet support the v145 toolset, the project currently requires the Visual Studio v143 build tools. 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. Universal Config Tool (made by ShizCalev/Afevis. Powered by SDL3.)