Skip to content

Latest commit

 

History

History

.data

Readme.md

Mod Loader

What is it?

Mod Loader is an ASI Plugin for Rockstar's Grand Theft Auto San Andreas that adds an extremely user-friendly and easy way to install and uninstall your modifications, without even messing around anything in your game installation.

The usage is simple, you just have to create one or more folders inside modloader directory and then drop the mod contents there. It's done. It is recommended to have one folder for each modification you have.

Installing Mod Loader

Installing on GTA San Andreas

Mod Loader depends on an ASI Loader, make sure you have it!

Then just extract modloader.asi and modloader folder into your game directory.

Installing on GTA Vice City or GTA III:

Mod Loader depends on Ultimate ASI Loader, make sure you have it!

Then just extract modloader.asi into the scripts/ directory and modloader folder into your game directory.

Installing Mods in Mod Loader

To install a mod in Mod Loader, it's extremely simple, just extract the contents of the mod into a folder inside modloader directory.

That means the following are valid installation methods:

  • modloader/nsx/infernus.dff
  • modloader/nsx/another folder/infernus.dff

But the following is NOT valid:

  • modloader/infernus.dff
  • modloader/.data/infernus.dff

Uninstalling Mods from Mod Loader

Even simpler, just delete the mod content from modloader directory. If you just want to disable the mod for a while, go to the in-game menu and disable it or edit modloader.ini manually.

Highlights and Features

  • Do not replace ANY original file, never, really.
  • Let Mod Loader take care of everything
    • Data files merging.
      • Therefore you can for example have 70 handling.cfg files at modloader and they'll all work perfectly fine.
    • Readme files reading
      • No need to care about taking the data line from the readme file and placing in the data file, Mod Loader does that for you too!
  • Refreshable mods
    • Change or add the files while the game is running and see the results immediatelly!!!!
  • Command line support
    • See modloader/.data/Command Line Arguments.md
  • In-Game menu for configurations
    • Go to Options > Mod Loader Setup
    • When the menu is not available, do it manually by editing modloader/modloader.ini and modloader/.data/config.ini
  • Profiles, so you can have many games in one.
    • Read modloader/.data/Profiles.md for details

Have you found a bug?

It's essential to report bugs, so the loader gets improved, to report a bug go to any of the following channels:

When reporting a bug PLEASE provide the modloader/modloader.log file created just after the crash and give some detailed information on how to reproduce the bug.

Supported Executables

Not all executables are supported at the moment, the supported ones are:

  • GTA III 1.0
  • GTA VC 1.0
  • GTA SA 1.0 US
  • GTA SA 1.0 EU

Download

You can download the lastest version of Mod Loader from:

  • GTA Garage, for the lastest stable build
  • GitHub, for the lastest (including unstable) builds

Source Code

Mod Loader is a open source project, feel free to learn and contribute. The source code is licensed under the MIT License, check it out on GitHub.

Credits

Finally, let's go to the credits.

Developer

Special Thanks To

  • ArtututuVidor$, Andryo, Junior_Djjr, JNRois12 for alpha-testing
  • Gramps and TJGM for emotional support.
  • SilentPL for A LOT of fixes and help with the development of Mod Loader.
  • ThirteenAG for giving me lots of pointers (literally) for the GTA III / Vice City version.