ASI Loader is the tool that loads custom libraries with the file extension .asi into any game process.
This is a DLL file which adds ASI plugin loading functionality to any game, which uses any of the following libraries:
With the last two, it is possible to load the original dll by renaming it to 'vorbisHooked.dll' or 'binkw32Hooked.dll'. Usually it is not required and you can simply replace the dll. Always make a backup before replacing any files.
In order to install it, you just need to place DLL into game directory. Usually it works as dinput8.dll, but if it's not, there is a possibility to rename it(see the list of supported names above).
Put ASI files in game root directory, 'scripts' or 'plugins' folder. If configuration is necessary, global.ini file can be placed to 'scripts' or 'plugins' folder. It can be used alongside the chosen dll and if so, it is also possible to use dll name for ini file, e.g. version.dll/version.ini. See example of global.ini here.
It is possible to install mods that replace files via the update
folder, allowing you to avoid actual file replacement.
For example, if a mod replaces the file located at:
Resident Evil 5\nativePC_MT\Image\Archive\ChapterEnd11.arc
With Ultimate ASI Loader installed, you can create an update
folder and place the file at:
Resident Evil 5\update\nativePC_MT\Image\Archive\ChapterEnd11.arc
To revert the game to its initial state, simply remove the update
folder.
Please note that the update
folder is relative to the location of the ASI loader, so you need to adjust paths accordingly. For example:
\Gameface\Content\Movies\1080\GTA_SA_CREDITS_FINAL_1920x1080.mp4
Should be adjusted to:
\Gameface\Binaries\Win64\update\Content\Movies\1080\GTA_SA_CREDITS_FINAL_1920x1080.mp4
ASI loader have built-in wndmode.dll, which can be loaded, if you create empty wndmode.ini in the folder with asi loader's dll. It will be automatically filled with example configuration at the first run of the game. Settings are not universal and should be changed in every specific case, but usually it works as is.
Some mods, like SkyGfx require d3d8to9. It is also a part of ASI loader, so in order to use it, create global.ini inside scripts folder with the following content:
[GlobalSets]
UseD3D8to9=1
See example of global.ini here.
ASI loader is now capable of generating crash minidumps and crash logs. To use this feature, create a folder named CrashDumps
in the folder with asi loader's dll. You can disable that via DisableCrashDumps=1
ini option.
C:\Users\[YOUR USERNAME]\AppData\Local\Packages\[YOUR UWP GAME NAME]\TempState\DUMP
Add-AppxPackage -Register AppxManifest.xml
[GlobalSets]
DontLoadFromDllMain=0
Sometimes it may not be necessary, but UWP GTA SA didn't work with current implementation of DontLoadFromDllMain=1
.
15. Create scripts or plugins folder within the root directory and place your plugins in it.
Rough code example of radio for all vehicles plugin here. Compiled binary here - GTASAUWP.RadioForAllVehicles.zip
16. Click on the start menu and launch the game!
17. See your mods in action.