Subscribe to download
GAuto

GAuto is a lightweight vehicle system for Garry's Mod that extends the default functionality of vehicles based on the built-in jeep and airboat entities. All vehicles made by popular creators TDM, SGM, and LW before September 2023 are supported out of the box. A few select vehicles outside of these creators are also supported. I will not be adding support to any more vehicles myself, but contributions that add support are welcome, and vehicle creators are encouraged to add support to their own addons. A full list of supported addons can be found here.

• Vehicles will smoke when their health drops below 25%, and explode when their health reaches 0.
  
• If VFire is installed, vehicles that remain on fire for too long will become charred and permanently unfixable.
  
• Vehicles can be damaged through bullets, explosives, collisions, etc.
  
• The repair tool weapon and repair kit entity can be used to restore vehicle health.

• Tires will deflate after receiving enough damage from either bullets or spike strips.
  
• Tires can be repaired with the secondary fire of the repair tool.
  
• Deflated tires will cause the vehicle to slow down and become harder to control.

• HUD appears on the right when player enters the driver's seat.
  
• Displays vehicle's health, fuel level, door lock status, and cruise control status.

• Brakes will only lock on a vehicle if the driver holds their jump key as they exit the vehicle.
  
• Brakes can be released with the vehicle management tool for towing purposes if the vehicle is locked and cannot be driven away.

• The front wheels will lock into a turned position if the driver keeps them turned as they exit the vehicle.
  
• Not supported on airboats since it causes them to spin indefinitely.

• Supported vehicles will spawn with multiple passenger seats.
  
• Players can switch between seats using the number keys.
  
• The driver can kick passengers out by holding alt and pressing the number keys.
  
• Unsupported vehicles will have a single passenger seat automatically placed next to the driver's seat if there's enough room.

• All vehicles, both supported and unsupported, have a horn that can be used by pressing J.
  
• GAuto comes with 3 horn sounds, but when adding support to a vehicle, any sound can be used.

• Drivers can lock their doors to prevent any other players from getting in, even when the driver leaves, by pressing N.
  
• Locking the doors does not prevent passengers from getting out.

• Fuel is consumed when the throttle is pressed.
  
• Fuel can be replenished through the fuel can entity or weapon.

• Toggled by pressing V as the driver.
  
• Throttle will always start out slow. Drivers can increase/decrease cruise speed by pressing forward/backward.

• Data tables for each vehicle that contain info about health, seat positions, horn sound, etc. are stored in formatted JSON files for easy editing.
  
• A vehicle creation tool is also included to easily add GAuto support to your own vehicles.

• Pressing P will turn off the engine without requiring the driver to leave the vehicle.

• All controls besides the seat number keys can be reassigned.

• Dust will emit from the wheels when driving on certain surfaces including dirt, grass, and sand.
  
• Engine emits a large cloud of smoke when vehicle is heavily damaged.
  
• Can be disabled server-side if it causes performance issues.
  
• Not supported on airboats due to the lack of an engine attachment (and wheels).

No. Not only is that outside of my scope, it would also ruin the 'lightweight' aspect of the addon. If you want a lighting system to use with GAuto, I recommend Photon Legacy or Photon 2.

Probably not. Any vehicle I add support to going forward is only because I personally want to use it with GAuto. If you would like to add support yourself, I will accept a PR on GitHub, but otherwise it's up to vehicle creators to add support to their own vehicles, because I simply cannot fulfil every request.

At this point, new features are a low priority. GAuto has been in development since 2019 and I've added everything that I originally wanted to add, and more. I'll gladly take suggestions but there's no guarantee that they will be added.

The smoke effect is placed at the position of the engine attachment that is built into the model. If the attachment isn't aligned properly, the smoke won't be aligned properly either. Some vehicle creators do this intentionally to make the vehicle drivable in deep water. Supported vehicles can have an engine offset parameter applied so the smoke appears in the right place.

If your car isn't smoking, its model likely does not have an engine attachment, or the attachment is located at the vehicle's origin and has been disabled to prevent it from looking weird. If your car isn't catching fire when its health reaches 0, you likely don't have VFire installed.

Vehicle creators can add GAuto support to their own addons using a tool, and developers can interface with the addon through a variety of methods. You can learn more about that here.[github.com]

• Photon Legacy - Fully compatible. The HUD and default controls were designed to avoid conflicts with it.
  
• Photon 2 - Mostly compatible. Seat switching and ejection are disabled on Photon 2 vehicles due to how the controls are setup.
  
• Simfphys and LVS vehicles - Fully compatible. GAuto will not interfere with these systems, and the spikestrip will pop tires from both.
  
• VFire - Fully compatible. For the best destruction effects, it's recommended you have it installed.
  
• DarkRP - Fully compatible. The door lock status of vehicles is properly synced when using keys, an alarm will sound when lock picking a vehicle, and passengers will be ejected when using a battering ram on a vehicle.
  
• Sligwolf's Vehicles - Mostly compatible. Some vehicles are unsupported due to not using prop_vehicle_jeep as a base, but there shouldn't be any issues with the ones that are supported.
  
• VCMod, SVMod, Vehicle Damage 2, Etc - NOT compatible. They will likely interfere with GAuto and cause various systems to break.

• Simfphys Base[github.com] - Reference for how to implement the passenger seat and particle effect systems.
  
• Valve - Particle effects
  
• SGM - Feature suggestions
  
• rp_truenorth_v1a - Map used in screenshots and thumbnail

[github.com]