tomezpl / gtav-clothing-dumper

An ASI script to generate a GXT label lookup for every drawable texture for every MP Ped Component in GTA V.

GTAV Clothing Dumper

An ASI script to generate a GXT label lookup for every drawable texture for every MP Ped Component in GTA V.

Brief

This script generates a JSON file containing GXT labels for all drawables of every ped component of an online character.

For lack of better ideas, the button to trigger the dump is F (or whatever the "Enter Vehicle" control is). This creates a clothingdump.json file in your game's directory.

The schema is as follows:

/* This is the JSON root */
interface IClothingDump {
	"mp_f_freemode_01": PedClothing;
	"mp_m_freemode_01": PedClothing;
}

type PedClothing = Record<PedComponent, ComponentDrawables>;
type ComponentDrawables = Record<number, DrawableTextures>;
type DrawableTextures = Record<number, GxtLabel>;
type GxtLabel = string;

type PedComponent = |
	"head" |
	"beard" |
	"hair" |
	"upper" |
	"lower" |
	"hands" |
	"feet" |
	"teeth" |
	"accessories" |
	"armour" |
	"badge" |
	"torso";

Installation & usage

The latest dump should be available in the dist/ directory of this repo.

Dumping

1. Download ScriptHookV and place dinput8.dll and ScriptHookV.dll in your GTAV directory.
2. Download the latest compiled dumper script from the Releases page and place GTAVClothingDumper.asi in your GTAV directory.
3. Launch GTAV
4. Load into story mode
5. Once spawned in, press F.
6. Your character will change to the online character. There should now be a clothingdump.json file in your GTAV directory.

Building

1. Download the ScriptHookV SDK.
2. Extract the SDK to a folder and set an environment variable named SCRIPTHOOKV_SDK pointing to the extracted folder.
3. Clone this repo.
4. Open the solution in Visual Studio 2022
5. Build
6. Copy the ASI from bin/Release and place it in your GTAV directory.

Thanks

Big thanks to Alexander Blade for ScriptHookV and root-cause (GitHub) for the PedComponent struct layout.