V_Framework

V_Framework is a modding framework that “breaks the wall” between Lua and the game’s executable. It loads as an Infinite Heaven module and exposes native Fox Engine features — UI, sound, soldiers, bosses and vehicles — to Lua scripts that the game never opened up to modding.

It ships with a handful of automatic fixes and a library of ready-made Lua APIs you can call from your own missions and mods, without touching a single memory address.

Requirements

• Metal Gear Solid V: The Phantom Pain (1.0.15.4 or 1.0.15.3, EN or JP)
• Infinite Heaven (V_Framework registers as an IH module)

See the Nexus page for full installation instructions.

Automatic fixes

These work the moment V_Framework is installed — no scripting required:

• Female Hair Fix — in vanilla, female soldiers keep a separate persistent hair layer that clips through helmets and headgear. V_Framework corrects this so female hair behaves properly under headgear, the same way male soldiers do.
• Ocelot Dual Tornado — the dual-tornado attack is enabled by default.
• Enemies, Soldiers & VIPs VIPs in missions — VIPs in mission such as Red Brass or War Economy will have their voice pitch down and comrades react to them differently than to a regular soldier Custom callsigns — Makes soldiers who have the RADIO revenge power use the call sign “Patrol”.

Features

Everything below is exposed through global Lua libraries (see the V_Framework Lua API reference):

• Enemies & VIPs — designate VIPs, hand out radio callsigns, force optical camo, rename units and their info text, and manage soldier chatter.
• Sound — per-soldier voice pitch, cassette-tape playback, custom Game Over music, helicopter pilot voice/radio lines.
• UI — custom equip-screen backgrounds & icons, loading and Game Over splash screens, mission popups, emergency missions, mission icons, announce-log sound effects, and the time-cigarette UI.
• Bosses & set-pieces — recolor Sahelanthropus’ eye lamp and heart light, swap its fova, and read/set its battle phase.
• Hostages, player & vehicles — track “lost” hostages with custom labels, override player voice FPKs, and a free-roam helicopter taxi.

Lua API

V_Framework’s features are exposed as global Lua libraries (V_TppUi, V_TppEnemy, V_TppSahelan, and more), available once the framework is loaded. Each library and every function — with examples — is documented in the V_Framework Lua API reference.

-- Flag Mission 10070, true as an Emergency mission with a custom popup and a HUD banner
V_TppUi.SetEmergencyMissionPopupLangId("hud_emergency_mission", "another_langId") -- hud_emergency_mission is a langId in .lng2 files
V_TppUi.SetMissionEmergency(10070, true)
V_TppUi.ShowMissionIcon("another_langId", "another_langId", 6.0)