Skip to content

A (probably fun) Grand Theft Auto San Andreas Mod that randomizes stuff

License

Notifications You must be signed in to change notification settings

opain-replika/SA.Rainbomizer

 
 

Repository files navigation

Build Discord

Rainbomizer 🌈

Rainbomizer is a randomizer for Grand Theft Auto: San Andreas.

Features 🌈

  • Traffic Randomizer: Randomizes cars that spawn in traffic including law enforcement vehicles.
  • Parked Car Randomizer: Randomizes cars which are found parked around the map including airplanes at airports with entirely random spawns.
  • Script Vehicle Randomizer: Randomizes the vehicles you are given in missions. The randomizer makes sure that you get vehicles that are usable for the mission.
  • (NEW) Colour Randomizer: Randomizes the colours of various in-game elements, including cars, the HUD, and fades. Includes 128 colours hue cycle. The intensity of this randomizer can be modified extensively in the configuration file.
  • (NEW) Mission Randomizer: Randomizes which mission is started by each mission marker. When the randomized mission is complete, the game progresses as if you completed the original. Additional features include missions that take place in locked-out areas unlocking during the mission, the ability for the same mission marker to always give the same randomized mission, and the ability for the player to be teleported back to the original mission's end point upon mission completion.
  • Weapons Randomizer: Randomizes the weapons that are dropped/wielded by the player/enemies.
  • Pickup Randomizer: Randomizes weapon pickups scattered around the map, as well as the appearance of certain other types of pickups.
  • Voice Line Randomizer: Randomizes dialogues spoken by characters in missions. (Requires original AudioEvents.txt)
  • (NEW) Cutscene Randomizer: Randomizes the models used in motion-captured cutscenes, as well as the location in which they take place.
  • (NEW) Blip Randomizer: Randomizes every radar blip on the map with a different icon.
  • (NEW) Dyom Randomizer: Adds an option to download and play a random mission from the dyom website.
  • (NEW) Clothes Randomizer: Randomizes clothes every fade.
  • Police Helicopters Randomizer: Randomizes the helicopters that the police spawn in with working spotlight and gun.
  • Cheat Randomizer: Randomizes which cheat activates when you enter a cheat.
  • License Plate Randomizer: Randomizes the license plates of vehicles to a random word.
  • (Experimental) Handling Randomizer: Shuffles the handlings of vehicles.
  • (Experimental) (NEW) Particle Randomizer: Randomizes all of the game's particle effects.
  • (Experimental) (NEW) Weapon Stats Randomizer: Randomizes properties of all weapons, including their damage, fire rate, and clip size.
  • (Experimental) (NEW) Object Randomizer: Randomizes objects spawned by mission scripts into other objects.
  • (Experimental) (NEW) Wanted Level Randomizer: Randomizes how you get wanted level during and outside missions.
  • (Experimental) (NEW) Respawn Point Randomizer: Randomizes where you respawn after getting busted or wasted.

Supported Versions 🌈

  • GTA San Andreas - v1.00

Other versions of the game will not work and will most likely cause a crash.

Check this link if you wish to downgrade a later version to a compatible version - https://dl1.rockstarnexus.com/gta/sa/GTASA_12-9-14_Steam_to_V1_DG.exe

Installation 🌈

Tutorial by SpeedyFolf

Installation requires an ASI Loader to be installed.

Ultimate ASI Loader by ThirteenAG is a popular option since it supports CrashDumps, which will be necessary if you want to report a crash.

If you already have mods like CLEO, you probably already have an ASI Loader installed.

  1. To install the Ultimate ASI Loader, simply extract the Ultimate ASI Loader's dinput8.dll file to the game's root directory (Folder where the game is installed)
  2. To install Rainbomizer, download the release archive from Releases and extract the archive to the root directory.

Configuration 🌈

If you wish to change any of the mod's functionalities, for example to disable a specific randomizer, a configuration file (config.toml) has been provided with the mod. The config file is located in the rainbomizer folder in the game's root directory.

The default configuration file is in the main repository, config.toml, and is automatically created by the mod if it doesn't exist in the rainbomizer folder.

The configuration file is in the TOML format. It is similar in structure to INI's, but with a defined and better structure.

To configure a specific randomizer, search for its name in the configuration file. You can set the "Enabled" key to 'true' or 'false' to enable or disable it respectively.

More information about how to configure specific randomizers is provided in the default config file.

Credits 🌈

Lead Developers

  • Parik - Creation and implementation of the ASI.
  • GTA Madman - Contributed fixes and extensive testing.

Original Concept

  • NABN00B - Gave the original idea for a car randomizer for San Andreas.
  • MrMateczko - Special mention for sharing a modded cargrp file that led to the original idea.
  • Veigar - Idea for the Parked Car/Texture Randomizer and support during early development.

Additional Contributors

  • 123robot - Creating external files, gathering data, providing ideas, lots of testing, and general support throughout development.
  • iguana - Assisted with looking through code and helped inspire the mission randomizer.
  • SpeedyFolf - Creating the tutorial video, beta testing, and feedback during development.
  • SRewo - Creating the Weapon Stats Randomizer.

Beta Testers

Used Libraries 🌈

  • injector (thelink2012) - zlib License
  • cpptoml - (skystrife) - MIT License

Contribution 🌈

You can contribute to the project by reporting any crashes/issues you encounter in the Issues section of the repository.

Pull requests are welcome, but are required to follow the current style used in the project.

You can also keep up with or contribute to development as it happens by joining the official Rainbomizer Discord! You can give #suggestions, ask for #support, or view current development in #sa.

About

A (probably fun) Grand Theft Auto San Andreas Mod that randomizes stuff

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • C++ 99.7%
  • CMake 0.3%