This is a DLL file that adds ASI plugin loading functionality to any game that uses any of the following libraries:
It is possible (and sometimes necessary) to load the original DLL by renaming it to <dllname>Hooked.dll, e.g. d3d12Hooked.dll.
With binkw32.dll and vorbisFile.dll, it is optional, and you can simply replace the DLL. Always make a backup before replacing any files.
To install it, you just need to place the DLL into the game directory. Usually, it works as dinput8.dll, but if that doesn't work, you can rename it (see the list of supported names above).
Put ASI files in the game's root directory or in the scripts, plugins, or update folder.
If configuration is necessary, the global.ini file can be placed in the 'scripts' or 'plugins' folder. It can be used alongside the chosen DLL, and if so, it is also possible to use the DLL name for the ini file (e.g., version.dll/version.ini).
See an example of global.ini here.
It is possible to install mods that replace files via the update folder, allowing you to avoid replacing original game files.
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
Starting with version 7.9.0, you can use this functionality for total conversions:
Two or more folders must be specified, and exist, for the selector dialog to appear. Define them inside global.ini under [FileLoader] section using the OverloadFromFolder key. Use the | symbol as a separator. If only one folder is specified and exists, it will be used to overload files, but the selector will not appear. Without an ini file, the update folder is always used if it exists. Example:
[FileLoader]
OverloadFromFolder=update | nightmareTo create a custom header, create update.txt inside update or total conversion folder and insert the custom name there.
Resident Evil 5\nightmare\update.txt:
Resident Evil 5 - Nightmare (Story mode mod)
To get the current update path, use the ASI Loader's GetOverloadPathA or GetOverloadPathW exports from the ASI plugin.
bool (WINAPI* GetOverloadPathW)(wchar_t* out, size_t out_size) = nullptr;
ModuleList dlls;
dlls.Enumerate(ModuleList::SearchLocation::LocalOnly);
for (auto& e : dlls.m_moduleList)
{
auto m = std::get<HMODULE>(e);
if (IsModuleUAL(m)) {
GetOverloadPathW = (decltype(GetOverloadPathW))GetProcAddress(m, "GetOverloadPathW");
break;
}
}
std::wstring s;
s.resize(MAX_PATH, L'\0');
if (!GetOverloadPathW || !GetOverloadPathW(s.data(), s.size()))
s = GetExeModulePath() / L"update";
auto updatePath = std::filesystem::path(s.data());The 32-bit version of the ASI loader has a built-in wndmode.dll, which can be loaded if you create an empty wndmode.ini in the folder with the 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 for each specific game, but usually, it works as is.
Some mods, like SkyGfx, require d3d8to9. It is also a part of the ASI loader, so to use it, create global.ini with the following content:
[GlobalSets]
UseD3D8to9=1The ASI Loader must be named d3d8.dll in order for this feature to take effect.
See an example of global.ini here.
The 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 the ASI loader's DLL. You can disable it via the DisableCrashDumps=1 ini option.
- Enable Developer Mode (Windows Settings -> Update and Security -> For Developers -> Developer Mode)
- Install a UWP game, for example, GTA San Andreas.
- Launch a UWP game through the start menu.
- Open UWPInjector.exe from the UWPDumper download.
- Enter the Process ID that is displayed from the injector and then hit enter.
- Wait until the game is dumped.
- Go to the directory :
C:\Users\[YOUR USERNAME]\AppData\Local\Packages\[YOUR UWP GAME NAME]\TempState\DUMP - Copy these files into a new folder somewhere else of your choosing.
- Uninstall a UWP game by clicking on the start menu, right-clicking on its icon, and uninstall.
- Go to your directory with your new dumped files (the ones you copied over) and shift + right-click in the directory and "Open Powershell window here".
- In that folder, rename AppxBlockMap.xml and AppxSignature.xml to anything else (to bypass UWP restrictions).
- Run the following command:
Add-AppxPackage -Register AppxManifest.xml - Place the Ultimate ASI Loader DLL into the game directory. You need to find out which name works for a specific game, in the case of GTA SA I've used d3d11.dll, so I put dinput8.dll from the x86 archive and renamed it to d3d11.dll.
- Create a 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
- Click on the start menu and launch the game!
- See your mods in action.
![@dependabot[bot]](https://avatars.githubusercontent.com/in/29110?s=64&v=4){kind=small}
