Code Monkey home page Code Monkey logo

trilogy-asi-script's Introduction

GTA Trilogy Chaos Mod

Welcome to the official GTA Trilogy Chaos Mod repository!

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

Project On Hiatus

Seeing as I'm pretty burnt out on this project I've decided to put it on hiatus for the time being.
What I mean by that is that it's on hiatus from my side, meaning that PRs will still be accepted.

Doing this all on my own is pretty taxing and I have other, more important (and interesting) things to do and worry about.

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

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 Tool doesn't support them yet.

How do I downgrade my game to the required version?

There's a handy thread over on the GTA Forums that has downgraders vor GTA III, Vice City and even San Andreas.
https://gtaforums.com/topic/936600-iii-iv-various-gta-downgraders/

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 chaos_mod 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. Now you have 2 options:
    1. Either press Auto-Start in the GUI, which will make it wait for you starting a new game and skipping the first cutscene (just like the autosplitter when doing a speedrun)
    2. Or you just press Start right away
  4. Suffer

Is there a list of all effects?

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

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 Channel, Username and OAuth Token fields.

Channel: The channel you want to have the voting in
Username: The username of the account to do the voting from (can be your own, can be a channel moderator)
OAuth Token: An OAuth Token for the specified username (Can be generated here)

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

How do I use the polls feature for Twitch voting?

Polls are still very experimental due to Twitch not offering a decent-- err, an API at all, to utilize them.

You have to be an Affiliate or Partner to be able to use this feature!

SirStendec was kind enough to provide a FrankerFaceZ Add-On that provides access to the polls functionality.

First make sure to enable Use Twitch Polls For Votes in the Settings tab.

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

To use it, first you need to install FrankerFaceZ in your browser.

Navigate to your dashboard and open the FrankerFaceZ control center (upside-down FrankerZ icon in the top right next to your user avatar).
Then head into Add-Ons, scroll down until you see Add Unlisted..., type in poll-shim and click Add.
Afterwards, make sure to install said Add-On.

https://i.imgur.com/56fm1ID.png

Now head into the Poll-Shim menu to the left (or click on Settings after installing it).

Make sure Enable Poll-Shim is checked and enter any passphrase into the Passphrase field.
The passphrase you have entered also needs to be put into the GTA Trilogy Chaos Mod program.

Also make sure to have your dashboard open (or, optionally, after doing this setup, a popout chat from your channel will work, too).

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

IMPORTANT INFORMATION:
You need to have a valid Twitch setup (Channel, Username, OAuth Token) and it needs to be connected for polls to work!

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.

It could be that it is pretty much impossible to implement, or that I just won't consider working on it because there are already effects that are similar to it though, so keep that in mind.

I hate you!

Right back at you ๐Ÿ˜‰

ATTENTION, ALL STREAMERS!

You don't have to, but it'd be amazing if you could tag your streams with #chaos or something similar, maybe even tweet it out with the #GTA_Chaos_Mod hashtag.

I wouldn't mind potentially dropping by and seeing you guys suffer with the mod ๐Ÿ˜

Discord server

There's a Discord server for asking smaller questions in case they weren't answered by this guide:

In case you need help or want to easily stay up to date on what's happening, make sure to join it.
(It's my personal Discord but it has a dedicated Chaos Mod channel)

Discord link has been disabled until further notice due to the ongoing hiatus of this project.

Credits

DK22Pac and everyone involved in the plugin-sdk

who has been helping me with a lot of function hooks and other things in the mod ๐Ÿ’–

Early beta testers

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

trilogy-asi-script's People

Contributors

lordmau5 avatar parik27 avatar cookieplmonster avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.