bbtracker: Metal Gear rank tracker

Live rank and codename tracker overlay for Metal Gear Solid: Master Collection. Tracks Metal Gear, Metal Gear 2, Ghost Babel, 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, MGS2 dog tags, MGS3 checklists, and MGS4 feats and flashbacks
• Peace Walker codename projection, insignia progress, and career counters
• Windows, Linux, and Steam Deck support through ASI Loader and Proton

By default, press F3 to toggle overlay. In MGS2, MGS3, MGS4, and Peace Walker, press F4 to cycle tabs. Up/Down scroll checklists, MGS4 feats and flashbacks, and Peace Walker career stats. Overlay scales automatically for high-DPI displays and 4K rendering.

Edit bbtracker.ini next to the ASI to control position, size, UI scale, opacity, initial visibility, hotkeys, checklist height, mouse interaction, and logging. Enable mouse=1 for clickable tabs, title-bar close/move, and the resize grip. Leaving values commented keeps the defaults.

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
• bbtracker_babel.asi into MGS_BC2

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, MinHook, and Inter font 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.

Bundles a subset of the Inter typeface, renamed "BB Tracker Sans" as the SIL Open Font License requires of modified versions (Inter-OFL-1.1.txt next to the built ASIs).

MIT licensed. See LICENSE.