Gas Can - Fuel Spill Weapon

A functional Gas Can gameplay mod powered by a modular Oil System framework.

Bring fuel spill gameplay to GTA San Andreas with a usable Gas Can weapon capable of creating oil puddles, igniting them with fire or supported bullet impacts, triggering chain fire propagation, and causing explosive environmental reactions.

This package includes both the Gas Can gameplay weapon and a reusable Oil System backend designed as a modular framework for compatible future scripts.

The Oil System was developed as a more structured reusable framework, with technical inspiration from Oil Leaking by Junior_Djjr.


Requirements:
* GTA San Andreas v1.0
* CLEO 4
* CLEO+
* ModLoader
* fastman92 Limit Adjuster
* Open Limit Adjuster (recommended)


Installation:
1. Copy `Gas Can + Oil System` into your `modloader` folder.
2. Configure:
* `Gas Can\cleo\petrolcan.ini`
* `Oil System\cleo\OilProperties.ini`
3. Set up the included Weapon Config files and fastman92 weapon configuration.
4. Set `WeaponTypeID` in `Gas Can\cleo\petrolcan.ini` to match your chosen weapon ID.


Usage:
* Obtain the Gas Can from included pickup locations (`PetrolCanPickups.cs`) or your own weapon source
* Equip the Gas Can and hold fire to pour fuel
* Ignite fuel using nearby fire, supported bullet impacts, or chain propagation
* Use it against vehicles, enemies, gang fights, or environmental hazards


Features:
[Gas Can]
* Functional usable Gas Can weapon
* Dedicated carry / pouring visuals
* Custom weapon asset (model, texture, HUD icon)
* Fuel droplet particle effects
* Optional pouring sound support
* Ammo consumption while pouring
* Infinite ammo compatibility (cheat / 100% unlock)
* Safe savegame handling while carrying
* Safe GTA SA local 2-player support
* Optional distributed pickup module across San Andreas gas stations + Doherty garage

[Oil System]
* Stable modular oil puddle runtime framework
* Oil puddle spawning and growth
* Puddle merge behavior
* Nearby fire ignition detection
* Supported bullet ignition
* Chain fire propagation
* Gas pump object explosion reactions
* Configurable oil/fire behavior
* Automatic lifecycle cleanup
* Distance-based cleanup optimization
* Reusable public runtime framework for other compatible scripts


Notes:
* Oil puddles are simple rendered individual spill instances
* Puddles are static once created and exist only on mapped world surfaces
* Oil does not conform to moving collision surfaces such as vehicles
* Only standalone gas pump objects are detected
* Some Las Venturas gas stations use static IPL/map-integrated models instead of destroyable standalone objects
* Sniper bullet impacts are not currently detected
* GTA SA native fire pool limitations still apply

If you have compatibility feedback, suggestions, or ideas for future improvements, feel free to leave a comment.