Product Solutions Resources Open Source Enterprise Pricing Search or jump to...

Sign in Sign up

ThirteenAG / Ultimate-ASI-Loader Public Sponsor Notifications Fork 98 Star 1.1k

Code Issues 1 Pull requests 1 Actions Projects Wiki Security Insights

master 2 Branches 14 Tags Go to file Code About

ASI Loader is the tool that loads custom

ThirteenAG fix exported func 38c04fd · 2 weeks ago 192 Commits libraries with the file extension .asi into
any game process.
.github Merge pull request #93 from ThirteenAG/dependabot/githu… 2 months ago
asi asiloader asi-loader asi-plugins
data/scripts move overload functionality to safetyhook 2 months ago
Readme
external change sh to minhook for overload 3 weeks ago
MIT license

source fix exported func 2 weeks ago Activity

1.1k stars
.gitattributes Ultimate_ASI_Loader v1.0 11 years ago
34 watching
.gitignore v4.0 7 years ago 98 forks

Report repository
.gitmodules add injector submodule 2 months ago

7za.exe 7z added 7 years ago

Releases 14

appveyor.yml local proxy load support for all name variants 9 months ago Ultimate ASI Loader v7.7.0 Latest
2 weeks ago
license unified gh actions releases, added version to file info 9 months ago
+ 13 releases
premake5.bat vs2022 3 years ago

premake5.exe vs2022 3 years ago

Sponsor this project

premake5.lua change sh to minhook for overload 3 weeks ago ThirteenAG Sergey P.

ko-fi.com/thirteenag
readme.md added binkw64 exports 2 months ago

patreon.com/ThirteenAG
release-Win32.bat added binkw64 exports 2 months ago

https://paypal.me/SergeyP13
release-x64.bat added binkw64 exports 2 months ago

https://boosty.to/thirteenag/donate
release.bat remove overload demo 2 months ago

Learn more about GitHub Sponsors

release.md added binkw64 exports 2 months ago

release.ps1 added binkw64 exports 2 months ago Contributors 5

README MIT license

Languages
AppVeyor Build passing GitHub Actions Build passing

C++ 97.4% Lua 1.5%

Ultimate ASI Loader Other 1.1%

DESCRIPTION
This is a DLL file which adds ASI plugin loading functionality to any game, which uses any of the following libraries:

d3d8.dll (x86)
d3d9.dll (x86 and x64)
d3d10.dll (x86 and x64)
d3d11.dll (x86 and x64)
d3d12.dll (x86 and x64)
ddraw.dll (x86)
dinput.dll (x86)
dinput8.dll (x86 and x64)
dsound.dll (x86 and x64)
msacm32.dll (x86)
msvfw32.dll (x86)
version.dll (x86 and x64)
wininet.dll (x86 and x64)
winmm.dll (x86 and x64)
winhttp.dll (x86 and x64)
xlive.dll (x86)
binkw32.dll (x86)
bink2w32.dll (x86)
binkw64.dll (x64)
bink2w64.dll (x64)
vorbisFile.dll (x86)

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.

INSTALLATION
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).

USAGE
Put ASI files in game root directory, 'scripts', 'plugins' or 'update' 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.

UPDATE FOLDER (Overload From Folder)

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

ADDITIONAL WINDOWED MODE FEATURE

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.

D3D8TO9
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.

CrashDumps
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.

Using with UWP games

1. Enable Developer Mode (Windows Settings -> Update and Security -> For Developers -> Developer Mode)

2. Install an UWP game, for example GTA San Andreas.

3. Launch an UWP game through the start menu.

4. Open UWPInjector.exe from the UWPDumper download.

5. Enter the Process ID that is displayed from the injector and then hit enter.
6. Wait until the game is dumped.

7. Go to the directory : C:\Users\[YOUR USERNAME]\AppData\Local\Packages\[YOUR UWP GAME NAME]\TempState\DUMP

8. Copy these files into a new folder somewhere else of your choosing.
9. Uninstall an UWP game by clicking on start menu and right clicking on its icon and uninstall.

10. 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".
11. In that folder, rename AppxBlockMap.xml and AppxSignature.xml to anything else.
12. Run the following command: Add-AppxPackage -Register AppxManifest.xml
13. Place Ultimate ASI Loader DLL into game directory. You need to find out which name works for a specific game,
in case of GTA SA I've used d3d11.dll, so I put dinput8.dll from x86 archive and renamed it to d3d11.dll.
14. Create an ini file with the same name, in this case: d3d11.ini, with the following content:

[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.

© 2024 GitHub, Inc. Terms Privacy Security Status Docs Contact Manage cookies Do not share my personal information