bbtracker: Metal Gear rank tracker

Live rank and codename tracker overlay for Metal Gear Solid: Master Collection. Tracks Metal Gear, Metal Gear 2, MGS1, MGS2, MGS3, MGS4, and Peace Walker runs in real time, including projected rank, requirements, and run stats.

Peace Walker has no rank. Its codename comes from the weapons a career is built on, so the panel projects the title, the takedown spread behind it, the grade ladder, and insignia progress.

Download latest release

Features

• Live projected rank and codename
• Rank requirements and remaining allowances
• Run stats, special-rank counters, MGS3 checklists, and MGS4 feat progress
• Peace Walker codename projection, insignia progress, and career counters
• Windows, Linux, and Steam Deck support through ASI Loader and Proton

Press F3 to toggle overlay. In MGS3, MGS4, and Peace Walker, press F4 to cycle tabs. Use Up/Down to scroll checklists, MGS4 feats, and Peace Walker career stats.

Install

Requires Ultimate ASI Loader. Recommended setup:

• MGS1: install MGSM2Fix.
• MGS2/MGS3: install MGSHDFix.
• MGS4/Peace Walker: install MGSPatriotFix - one zip per game.

Those fixes provide ASI-loading setup. Then download matching bbtracker release and copy ASI into game directory:

• bbtracker_mgs1.asi into MGS1
• bbtracker_mg12.asi into MG and MG2
• bbtracker_mgs2.asi into MGS2
• bbtracker_mgs3.asi into MGS3
• bbtracker_mgs4.asi into METAL GEAR SOLID 4/MGS4
• bbtracker_mgspw.asi into MGS_PW/mgspw

Follow fix project's Proton/Steam Deck DLL-override instructions when applicable.

Build

Requires Git, CMake, Ninja, and Visual Studio with Desktop development with C++ workload. Run from Developer PowerShell; CMake downloads pinned ImGui and MinHook sources automatically:

cmake -S . -B build -G Ninja -DCMAKE_BUILD_TYPE=Release
cmake --build build

Artifacts land in build/.

Linux rule tests:

cmake -S . -B build
cmake --build build
ctest --test-dir build --output-on-failure

Rank sources and known gaps: docs/rank_rules.md.

MIT licensed. See LICENSE.