VCParticles - Particles from GTA Vice City

VCParticles is a mod that transfers the particle system from GTA Vice City to GTA San Andreas, replacing nearly all possible particles in the game.

Attention: The modification has been confirmed to be stable, but if you have mods that change the standard particles, it is recommended to remove them.
This mod is perfect for people whose GTA isn\'t overloaded with 1000 mods (basically, the mod will work until another mod affecting effects appears, as conflicts will arise).

All (almost) particles in the game have been replaced, namely:
exhaust smoke, engine smoke, tire smoke, wheel particles (dust, sand, water, etc.),
gunfire flashes, gunfire smoke,
footstep smoke and water, birds, bullet hit particles (sparks, dust, etc.),
blood particles, weapon casings, rain, water particles, water particles on car roofs, sparks,
vehicle damage particles, helicopter dust, splashes,
flamethrower particles, fire extinguisher and paint canister particles,
sparks and smoke from punctured tires, explosion particles (with shockwave!),
combine harvester particles (when running over people),
engine fire, rocket smoke, Cropduster and Stuntplane smoke,
aircraft damage smoke, fire extinguishing smoke and water splashes from fire trucks,
fist impact particles on objects, and many, MANY others!
Not all particles could be replaces, due to complications!!! As a apology, i gave y\'all these CLEO opcodes :)

There are also bonuses! The mod also adds ships on the horizon, particles on the water, bugs that you saw in the distance, and the most interesting thing is snow!

I came across the idea with snow on the Discord server plugin-sdk (thanks to SpitFire), decided to recreate it in SA, and it turned out to be very beautiful!

The mod provides a total of twelve CLEO opcodes, which allow you to use the mod in all its glory in your CLEO scripts. Detailed description of their usage is described in the file \"VCParticles CLEO Opcodes documentation.txt\".

For .ASI plugin developers, I exported 12 functions that work on the same principle as CLEO opcodes (you essentially use them in CLEO opcodes).

The mod provides the original particle.cfg file from GTA Vice City, allowing you to make various edits to the .cfg file from the Internet, change various particle parameters such as color, duration, size, distance, and much more.

If you have The Hero\'s debug menu (aka aap), you can easily reload .ini and .cfg files right in the game without re-entering! (Note: not all settings in the .ini file may reload, you may have to re-enter).

In the same menu, there are other options, for example: enable particles behind the player (mainly used for testing), particle size, enable logs, etc.

Each particle replacement can be toggled in the .ini file.

You can improve the texture quality by installing any mod for particle.txd or particle.cfg (it is important that it is for GTA VC! But if it\'s for GTA III, don\'t forget to add textures and lines in the .cfg file that are in Vice City. Also, don\'t forget the snow texture \"snowflake\").
Small update from 04/30/2024:
Added checks for the existence of a texture in a .txd file. so that you don’t forget to install them when modding a particle.txd.
Added a new particle from GTA III (BOAT_WAKE).
Fixed glitches during rain.
New CLEO opcode & exported function to add "yardie" door smoke.

Small update from 04/05/2024:
Three new particles from GTA LCS
Fix crash when the mod was installed via modloader
Fixed other bugs

Tiny update from 04/05/2024:
Added ejaculations at "Cock Rock" and "Los Santos City Hall" between 23:00, 23:15, 23:30, and 23:45 (From GTA VC)

Small update from 04/05/2024:
Added two new particle objects "CATALINAS_GUNFLASH" and "CATALINAS_SHOTGUNFLASH" from GTA III
Improved debug menu
Bug fixes and stuff

Tiny update from 05/05/2024:
Added settings to toggle steam during & after rain

Small update from 16/05/2024:
Fixed SCREEN_TRAIL & SPEED_TRAIL particle.cfg flags, whenever they made particles vertical sometimes.
Fixed damaged engine smoke not turning off.
Code clean up.

Small update from 29/05/2024:
1. ApplyFriction function is no longer replaced, to produce friction sparks.
2. Added another bonus: Diesel vehicles smoke.
3. PARTICLE_RAINDROP_2D is fixed, so no longer artifacts.
4. Code cleanup

Small update from 30/05/2024:
1. Fixed exhaust fire particles being small
2. Fixed rain artefacts
3. Changed ini settings placements
4. Added "Exhaust fire model index" setting in ini, to set on which vehicles will the fire exhaust appear (Only one)

Tiny update from 31/05/2024:
1. The frequency of a fountain of blood from a headshot has been reduced, like in Vice City.
2. Hotfix: if the weapon is a knife or any other cold weapon like katana, and is not recognized, it just detects it by an animation, to spawn blood particles/fountains.
3. Fixed Stuntplane/Cropduster smoke not despawning.

Small update from 06/07/2024:
1. The plugin and CLEO plugin have been updated to the latest version of plugin-sdk
2. Fixed a crash on the mission “Reuniting the families” when SWAT fired from the ventilation.

Small update from 11/06/2024:
1. More custom weapons support.
2. Added support for custom vehicles to use fire on exhaust.
3. Fixed foot splash particles
3. Another code cleanup

Hotfix from 13/06/2024: Heli dust now only appears at high blade speeds.
Another hotfix: Fixed fireballs and diesel smoke appearing while being submerged in the water.

BIG update from 28/06/2024 (V1.0.1)
1. Fixes to cleo opcodes.
2. Fixed helidust not appearing for Hydra.
3. Added ParticleEx XBOX particles.
4. New exported function "LogExport" that you can use to log something to a CParticleVC.log file.
5. Removed the particles camera draw distance limit. You can still toggle it.
6. New ini setting "Use headlights pos for damaged engine smoke", which determines, is headlight dummy used for engine smoke pos, or engine dummy?
7. Fixed too wide muzzleflash for assault rifles.
8. Replaced shattered glass particles.
9. Added sounds for gunshells (i'm sorry).
10. More custom weapons support.

HOTFIX from 29/06/2024: Fixed drive-by not shooting.

HOTFIX from 30/06/2024: Fixed sniper rifle not having any bullet impact particles in the aim mode.

HOTFIX from 02/07/2024: Fixed stowaway being impossible to finish, due to code mistakes.

Lil update from 03/07/2024:
Added second gunflash pos adjusting, since it's misplaced.

Update from 07/07/2024:
1. Added motion blur for sniper rifles while aiming (If u have a custom sniper rifles, you can add them in .ini), and during drunkness.
2. Fixed sometimes gunflash were not appearing.
3. Fixed crashes on Zombie Andreas.
4. New opcode "1350" which adds the ability to set the motion blur overlay. More info on "VCParticles CLEO Opcodes documentation.txt" file.
5. During "Assertion failed!" errors, there may be a description of the expression failure, to help fix this error.
6. Some new logging stuff

Fix from 07/19/2024:
Fixed sparks not appearing when tires are burst for motorcycles.

Lil update from 31/07/2024:
Replaced shattered object impact particles (Smoke)

Lil update from 11/08/2024:
Fixed heli dust effect.
Added VC Ciggy effect (Toggles through a cheat code CERTAINDEATH).
RC Bandit received a antenna, that has wobble physics.

Fix from 13/08/2024:
Fixed heli dust effect on water.

Lil update from 26/08/2024:

1. Replaced fire particles
2. Fixed sometimes SA blood particles were appearing, when using melee weapons.
3. Fixed some crashes
4. Refactored the exhaust fire adding system

Lil update from from 29/08/2024:
1. Fixed second gunflash not appearing.
2. Fixed water sparks not following the water waves.
3. Refactored the Blur & second gunflash define systems.

Video:

Source code: https://github.com/TheArtemMaps/VCParticles
-- Credits
KaiQ for screenshots, modification testing, and video
scroogebomber for his help during the creation of the mod
Artem 1.9.9.6 and Kaoru for testing the modification