In this folder you can find two subfolders, one called "replace" and one called "stream". Both can be used for the same thing but replace is ultimately more powerful, but also more advanced. The stream folder you might recognize from Map Editor or Rampage Trainer and just loads streaming files directly.


=== Stream ===

As mentioned, similar to other tools available this merely loads streaming files into the game when the game is loading. For instance, model or texture files would go in there and will replace the existing assets in the game. If you do not know the name of an asset, but only its hash, simply name it 0xhash.ext (e.g. 0x9E54B506.ytd for w_melee_machete01+hi.ytd) and it will still be recognized and replace the asset correctly.

This is the most convenient way to quickly replace streaming files as you do not have to worry about where in the game files they are located but only their name.


=== Replace ===

This folder creates a virtual mapping of the entire game file structure and hence allows you to replace any game file, granted you know its full location. This is similar to the paths you can see in OpenIV when navigating RPFs, but not exactly the same. If you want to change the dispatch.meta file for instance, you will need to modify it in update.rpf, as the one in common.rpf is superseded by that. To do that, you would create the following structure: "replace\update\common\data\dispatch.meta". This is exactly the path you would use in OpenIV (without the .rpf ending for update). Now, whenever the game wants to access this file, it will load yours instead. It is that simple!

If you want to replace the font file font_lib_efigs.gfx in scaleform_frontend.rpf for instance, you would create the following structure: "replace\update\x64\patch\data\cdimages\scaleform_frontend\font_lib_efigs.gfx".

Word of caution: File paths do not always match their RPF names unfortunately, hence this is a bit more advanced but also allows greater control. Say you want to replace player_zero_coat_001_open.ydd which is present in both packs_1.rpf (original) and dlc.rpf (from patchpack001, an update to the file). Files DLCs follow a slightly different pathing scheme. The full path to this file would be "replace\dlc_patchPack001\x64\packs\base\models\component_models\player_zero_coat_001_open.ydd". As you can see, it does not match the file path directly, which is also why for many files using the stream folder is just simpler. This is because the game maps some files differently and when you open the dlc.rpf (in patchpack001) and its setup2.xml you will see why: the device name is dlc_patchPack001 which is the "root" of all files inside this archive. Thus the path starts at "dlc_patchPack001" and then follows the RPF structure until you arrive at "replace\dlc_patchPack001\x64\packs\base\models\component_models\player_zero_coat_001_open.ydd". Not that complicated, but certainly not as easy as the streaming folder and something to look out for.


=== Differences to LML for GTA V ===

This is a very simplified version of Lenny's Mod Loader compared to the GTA 5 version and does not have any UI support, does not support install.xml files, data file loading and more. I might include those features in the future, but for now decided the tool is useful enough as-is.