Skip to content

The ASI script for the GTA Trilogy (SA only for now, 3 and VC may follow later on)

Notifications You must be signed in to change notification settings

gta-chaos-mod/Trilogy-ASI-Script

Repository files navigation

GTA Trilogy Chaos Mod: Reborn

Welcome to the official GTA Trilogy Chaos Mod: Reborn repository!

This repository, together with this README, is still very much WIP.

Why "Reborn"?

The mod had some issues and was my first C++ project, thus I did not have a lot of experience on how to best do a lot of things right.

The "Reborn" project aims to fix this by pretty much rewriting the majority of the mod from scratch. (except code for drawing effects and a few other things)

It will also be easier for interested developers to contribute to the project be it with their own effects or with help on the general codebase.

How can I help / add new effects?

Check out the CONTRIBUTING file for more information.

What does this mod do?

Similar to the old Vice City Chaos% mod by Lightnat0r, it activates effects in the corresponding game every X seconds / minutes (cooldown can be defined in the GUI).

Which GTA games does it support?

It started off as a mod for San Andreas, which is the one that is mainly supported right now.
However, there is already basic support for Vice City and III implemented. It will take longer to bring all (if possible) custom effects over, and also implement their corresponding ingame cheats though.

Which versions of the games does it support?

GTA San Andreas: v1.0 US
GTA Vice City: v1.0 US
GTA III: v1.0 US

So far only San Andreas is officially supported.
Vice City and III have some sort of basic support in already, but the GUI doesn't support them yet.

How do I downgrade my game to the required version?

There's a San Andreas downgrader by gamerzworld in the GTAForums here:
https://gtaforums.com/topic/927016-san-andreas-downgrader/

What ASI Loader is recommended to play the mod with?

I highly recommend using the Ultimate ASI Loader by ThirteenAG purely due to the fact that it supports saving CrashDumps.

You can find the latest release here: https://github.com/ThirteenAG/Ultimate-ASI-Loader/releases/latest

Download the Ultimate-ASI-Loader.zip file (not the _x64.zip one)
It will contain a file called dinput8.dll - move the file to your GTA directory.
Now rename it to vorbisFile.dll and replace the original.
(Good for people that use the dinput8.dll mouse fix. Also the only way I personally got the ASI Loader to work)

Silent's ASI Loader works as well, but if you want to open an issue with some crashes I'll be closing any that do not have crash dumps.

Depending on which ASI Loader you picked, the files differ in size a bit:

  • vorbisFile.dll (Ultimate ASI Loader): 2,102KB / 2,152,448 bytes
  • vorbisFile.dll (Silent's ASI Loader): 53KB / 53,760 bytes

The reason why the Ultimate ASI Loader is WAY BIGGER in size is because it supports more than just the original vorbisFile.dll, comes with an additional windowed mode feature, a "d3d8 to d3d9" pseudo-driver and a crash handler.

If you don't need any of that, Silent's ASI Loader will be all you need.

How do I download the mod then?

Head on over to the the Releases tab or click here.

Installation is as simple as installing an ASI Loader (see previous section) and copying all the files into your game directory. (So the ChaosMod folder, the scripts folder and the .exe)

The .exe can be anywhere you want, as long as it has write permissions since it automatically saves the settings in a file called config.cfg in the same directory.

You also need to have .NET Framework 4.7.2 installed.

... and how do I use it?

Simple:

  1. Start the game
  2. Launch the corresponding Trilogy Chaos Mod.exe
  3. Simply press Start
    1. If you want to have the timer start automatically when you start a new game, make sure to tick the Auto-Start checkbox in the top right.
  4. Suffer

I'm getting an "Error: 126" when I try to start the game!

You are most likely missing the DirectX 9 runtime.
Please download it from here and then try starting the game again:

https://www.microsoft.com/en-us/download/details.aspx?id=8109

If that doesn't fix it then make sure you have the bass.dll in your game directory.
It comes bundled with the Chaos Mod archive you downloaded.

Is there a list of all effects?

Of course! Here's a spreadsheet that has all of them!

The effect SUPER. HOT. isn't working correctly!

It seems that mouse fixes such as dinput8.dll can cause issues with this (and maybe other) effects. If you're playing modded already I highly recommend using SilentPatch instead seeing as it also includes a mouse fix.

How do I load the last autosave when ingame?

Hold down Left CTRL when hovering over the Load Game option in the menu.

Where are the autosaves being saved to?

Inside a sub-directory called chaos_mod in your corresponding GTA User Files folder.

How do I setup the Twitch voting?

In the Twitch tab you have to fill out the Access Token and Client ID fields.

To get a ClientID and generate an Access Token, please head to this website and follow the instructions.

For Twitch you now have the option to have voting happen through chat messages (1, 2, 3) or their integrated Polls system.

https://i.imgur.com/UDmUKet.png

How do I setup the YouTube voting? (Experimental)

Head into the Settings tab and switch the Stream Mode to YouTube.

After that, switch back to the Stream tab (or enter it with the button in the top right) put in your YouTube live / watch ID for the livestream into the field.

For example, if your livestream URL is https://www.youtube.com/watch?v=19iuE4jIN5k you'd put in 19iuE4jIN5k as the Livestream ID.

Do note that in YouTube mode there will be no chat messages posted about voting happening.

My game's crashing!

Great! Create an issue with the .log and .dmp files from the CrashDumps folder. (Best to archive them into a .zip file or similar)

I have a suggestion for an effect!

Also great! Feel free to create an issue with that as well, best to explain what it should do in detail.

If you're lucky someone might be able to implement it and contribute it to the mod!

Or better yet: Create the effect yourself and do a pull request!

That way you are helping with making the mod even better (or worse, depending on how you look at it).

Check out the CONTRIBUTING file for more information.

Credits

DK22Pac and everyone involved in the plugin-sdk

who has been helping me with a LOT of things in both the original mod and this rewrite 💖

Early v3.0 beta testers

Everyone in the v3.0 release race that was held on the 9th of July, 2022

2D_SVD, Abbygail, BladeXRG, Crucial, DennisOnTheInternet, DoubleDubbel, English_Ben, Fearful_was_taken, Floh284, GamingMaster, gian_97, glomerius, Gukol, Husker, Jersukai, Jugachi, Kamikaza404, Kato0909, KinzyKenzie, Kristof, Kuba4ful, LotsOfS, LuckyLucketts, MoRTaL, mossfis, Mytherious, Nardiko, NateHotshot, NotCreativeBush, prosto_big, Riekelt, Rose, Saymite, Scemmer_Joke, Simbe, SimonDiamond, Stickheadz32, Tepiloxtl, TonyKaatib, Voskos, WaterArko, YPOC, zoton2


v1.0 Credits

Early v1.0 beta testers

Everyone in the v1.0 release race that was held on the 30th of August, 2019