Skymods

Project Zomboid Mods Catalogue

Tread’s Fuel Types Framework [41.65+]

Uploaded ·

If you liked this item, please rate it up on Steam Workshop page.

Author: Trealak

Last revision: 6 Mar, 2022 at 12:00 UTC

File size: 4.02 MB

On Steam Workshop

Description:
Tread’s Fuel Types Framework [41.65+]

This mod adds additional fuel types (Diesel and LPG) to the game. Based on new Sandbox Options it can also assign them to vehicles. Not only it can change fuel type used by vehicle. It can cause specific car to exist in multiple versions (for example car instance can have 60% chance to use Gasoline and 40% chance to use Diesel). There are multiple options for assignment method (by vehicle Type, based on list or mix). List of default assignments is available in Discussion (suggestions welcome, own additions in vehicle mods encouraged).
Furthermore, this mod is a framework that allows adding even more fuel types to the game or assigining custom fuels to any car.

Mod works both in SP and MP. It also should be safe to add and remove mid-game. Obviously new items can disappear or get broken (on mod removal) but cars, barrels, gas stations etc. should work properly. Changing fuel type assignments mid-game also should be safe.

If you encounter bugs, crashes etc. PLEASE report them – it is the only way I can fix them. Downvoting or not giving details does not help. I did my best to test the mod in SP and MP but it is a lot of complicated code that will be run on different setups (modlists etc.). Bugs might happen and I will gladly fix all I can. I just have to know about problem at all.

Features of this mod:
  • Framework for custom fuel types,
  • Addition of Diesel and LPG (Propane / Autogas) as valid fuel types in-game,
  • Multiple options of assigning new fuel types to vehicles (Sandbox Option),
  • Ability to spawn same vehicle type in multiple fuel versions (% roll based),
  • Easy, list-based system for specyfing fuel type(s) used by vehicle,
  • Gas Station pumps can fuel cars (and fuel storage tanks) with any fuel type (LPG can be turned off via Sandbox Option),
  • Fuel Trucks and Trailers(vehicles with Fuel Storage Tanks) can store (and spawn with) both Diesel and Gasoline (one at a time),
  • Empty Fuel Trucks or Trailers can be filled with any type of liquid fuel,
  • Cars can be fuelled from the Fuel Trucks (with matching Fuel Type),
  • Fuel can be transferred between Fuel Trucks,
  • Fuel Storage Tanks can be emptied,
  • New vehicle overlay added to Fuel Trucks,
  • Changes to Car Mechanics UI (show Fuel Type),
  • Addition of new items (Diesel Cans etc.),
  • Both Petrol and Diesel Cans can store ANY liquid fuel (thus no LPG),
  • Ability to use Propane Tank (item) as "Gas Can" for fuelling/siphoning LPG cars (Sandbox Option),
  • Ability to fill Propane Storage Tanks (for example from Filibuster Rhymes mod) from Propane Tanks (Sandbox Option),
  • Gas Station pumps can dispense any fuel type to suitable items (LPG can be turned off via Sandbox Option),
  • Diesel cannot be used to burn bodies or start fires (in normal conditions it is hardly flammable),
  • Diesel cars use less fuel then Gasoline ones, Gasoline cars use less fuel then LPG ones,
  • LPG Gas Tanks have lower capacity,
  • Some actions emit sound,
  • Full compatibility with FuelAPI and WaterDispenser mods (while using "patch" sub-mod),
  • – All FuelAPI items can work with new fuel types,
  • – New Diesel items in-line with FuelAPI (Large Diesel Can),
  • – Water Jug (WaterDispenser mod) can store Diesel,
  • – Barrels can store both Diesel and Gasoline (one at a time),
  • – Barrels can be filled (or pumped from) directly by Fuel Trucks,
  • – Pumping to/from Barrels is blocked by walls, closed doors and windows in the path.

Sandbox options:

Mod can be configured via (new) Sandbox Options:

  • Fuel Types used by vehicles – Choose how Fuel Type is assigned to vehicle types,
  • Is propane available on gas station pumps ? – Is filling LPG cars and items possible from Fuel Pump?
  • Propane Tank as Gas Can ? – Can propane tank be used to fuel/siphon cars? Allows filling Propane Truck.

Fuel Type assignments (per car type):

List can be found in proper Discussion.

"Patch" sub-mod – Compatibility with FuelAPI:

This mod is fully compatible with FuelAPI mod, but it required some changes to FuelAPI code. For now compatibility is provided by "patch" sub-mod. Please turn it on if you use FuelAPI otherwise you might experience strange behaviour or errors.
Hopefully in near future the "patch" sub-mod can be removed and both mods will be compatible straight away. While writing this mod I was in contact with Konijima (FuelAPI author) and he received my adjustments to his code. Nonetheless, code review is still pending. When it is done, FuelAPI might get updated for full compatibility. Until then "patch" provides it.

How to add your own Fuel Types or assign fuel-type to your Car?

Please look into the discussion topic – Steam limits description length so I had to move it.
Specyfing fuel type for your Vehicle is very easy and causes no errors if someone does not use this mod (vehicle will simply be Vanilla Gasoline).

Future:

I am not a professional programmer, experienced modder nor hardcore Zomboid gamer. I made the mod for myself based on a suggestion I liked. Since nothing like it existed I place it on Steam Workshop. I will try to update the mod from time to time and fix any bugs found. Nonetheless I do not promise I will have time and skill to do it on any regular basis. Please do report any bugs found!
If you wish to fuel my modding activities please consider supporting me:
[ko-fi.com]

Languages:
  • English (EN)
  • Polish (PL)
  • Russian (RU) – thanks to HellRider42Rus
  • German (DE) – thanks to 0xM4RC3L
  • Please post your Translations in proper Discussion

Credits:

I wish to thank a few people:

  • Papa_Chad – for mod suggestion and brainstorming it with me,
  • KONIJIMA – for cooperation during this mods development (allowing me to: use some of his code, make compatibility patch and propose changes to his mods),
  • PlanetAlgol – for creating original fuel trucks code and allowing me to use and redesign it for this mod,
  • Pawel-Commandos – for making custom icons and help with testing,
  • Zersetzung – for further suggestions regarding "Diesel mod"

Known Issues:
  • Fuel cannot be transferred directly between different item types (Regular and Big Gas Cans etc.) – I will try to work some solution out.
  • Fuel cannot be poured out of item (to make it empty) – I plan to add such function
  • Fuelling vehicles from Fuel Trucks (or transferring fuel between them) does not check for walls etc. between them – it was like it in original Fuel Trucks code. Maybe I will find some solution in the future.
  • Repairing empty storage tank via debug/cheat will fill it up, even though fuel type remains "Empty". Adding any fuel via normal means will set the type properly.

Usage of my code in other mods:

I do allow usage of my code in other Zomboid mods. If you decide to do so please credit me in description.
I cannot promise regular updates and long-term support therefore I do allow fixing, upgrading, updating etc. my code and uploading its adjusted versions. Nonetheless, please try contacting me first.
Once more I only request crediting me for the work done.

Workshop ID: 2765042813
Mod ID: TreadsFuelTypesFramework
Mod ID: FuelAPI_FuelTypes_CompatPatch

Download

Tags: