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.

Documentation

V Framework is documented across three pages:

• V Framework Lua API - the reference for the Lua functions, brand-new DoMessages, GameObject SendCommands and exported constants, with examples.
• Custom Weapons - how to assemble a custom weapon from parts such as a receiver, barrel, magazine, bullet, sight, stock, muzzle, laser/light and underbarrel.
• Custom Outfits - how to build a custom outfit from a body model and package, with optional camo, voice, face, head and variant assets.

Requirements

• Metal Gear Solid V: The Phantom Pain, EN or JP. 1.0.15.4 is the latest version and the one to use. 1.0.15.3 also works, but some features are 1.0.15.4 only - see Current limits.
• Infinite Heaven (V Framework registers as an IH module)

Installation

V Framework loads as an Infinite Heaven module. See the Nexus page for full installation instructions.

Automatic fixes

These work the moment V Framework is installed:

• 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
• VIP soldiers - VIPs in missions such as Red Brass or War Economy have their voices pitched down (GZ-style), and nearby comrades react to them differently than to regular soldiers.
• Custom call signs - soldiers who have the RADIO revenge ability use the “Patrol” call sign.

Lua API

V Framework’s features are exposed as Lua functions, brand-new DoMessages, GameObject SendCommands, and exported constants. All of it is documented, with examples, in the V Framework Lua API reference.

-- Flag Mission 10070, true as an Emergency mission with a custom popup and a HUD banner
V_TppUiCommand.SetEmergencyMissionPopupLangId("hud_emergency_mission", "another_langId")
V_TppUiCommand.SetMissionEmergency(10070, true)
V_TppUiCommand.ShowMissionIcon("another_langId", "another_langId", 6.0)

hud_emergency_mission is a langId in .lng2 files