This is a lightweight vehicle system for Garry's Mod. 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. GAuto is now also available on the Steam workshop.
- Vehicle health system
- Vehicles will smoke when their health drops below 25%, and explode when their health reaches 0.
- Vehicles can be damaged through bullets, explosives, collisions, etc.
- The repair tool weapon and repair kit entity can be used to restore vehicle health.
- Tire damage
- 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.
- Vehicle HUD
- 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.
- Brake locking
- 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.
- Steering wheel locking
- The front wheels will lock into a turned position if the driver keeps them turned as they exit the vehicle.
- Passenger seats
- Supported vehicles will spawn with 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 room.
- Horns
- All vehicles, both supported and unsupported, have a horn that can be used by pressing J.
- GAuto comes with 2 horn sounds, but when adding support to a vehicle, any sound can be used.
- Door locking
- Drivers can lock their vehicle's doors to prevent any other players from getting in by pressing N.
- Locking the doors does not prevent players who are already in the vehicle from getting out.
- An alarm will sound if a player starts lockpicking a vehicle on DarkRP.
- Fuel system
- Fuel will be consumed when the throttle is down.
- Fuel can be replenished through the fuel can entity or SWEP.
- Cruise control
- Throttle will always start out slow. Drivers can increase/decrease cruise speed by pressing forward/backward.
- Pressing jump or V will disable cruise control.
- Vehicle data
- Data tables for each vehicle that contain info about health, seat positions, horn sound, etc. are stored as linted JSON files to allow for easy editing.
- A vehicle creation tool is also included to easily add GAuto support to your own vehicles.
- Engine toggle
- Pressing P will turn off the engine without requiring the driver to leave the vehicle.
- Customizable controls
- All controls besides the seat number keys can be reassigned.
- Particles
- 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
No. For both regular and emergency lighting, I recommend Photon Legacy or Photon 2. They're both available on the workshop and compatible with GAuto.
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.
Maybe. If it'll make a significant improvement to the addon there's a good chance it 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. There is nothing I can do to fix this. Some vehicle creators do this intentionally to make the vehicle drivable in deep water.
If your car isn't smoking, its model likely does not have an engine attachment, or the attachment is located at 0,0,0 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.
If you are a vehicle creator and would like to add GAuto support to your addons, you can use the GAuto Vehicle Creator tool to easily create a table to place in your vehicle's Lua file. When using this tool, left click will spawn passenger seats that you can physgun into place, right click will open a menu to edit values such as the vehicle's health and horn sound, and reload will remove the seats and generate vehicle data as either a Lua script or JSON table. Lua scripts need placed in a Lua file with a shared scope, and JSON files are automatically generated in the game's data folder. If you do add GAuto support to your vehicles, send me a link and I will add them to the collection linked at the top!
If you want to interface with this addon through Lua, see the documentation for hooks, functions, and other things you can use.
- Photon Legacy is fully compatible. Both the HUD and default controls were designed to avoid conflicts with it.
- Photon 2 is mostly compatible. The HUD will not overlap, but seat switching and ejection are disabled on Photon 2 vehicles due to how the controls are setup. All other controls should not conflict.
- Simfphys and LVS vehicles are fully compatible. Nothing should conflict, and the spikestrip will pop tires from both systems.
- VFire is supported. For the best destruction effects, it's recommended you have it installed.
- GChroma is supported. All available keybinds will be highlighted when you enter the drivers seat of a vehicle.
- Other vehicle systems such as VCMod and Vehicle Damage 2 are NOT compatible. They will likely interfere with GAuto and cause various systems to break.
If you would like to contribute to this repository by creating an issue or pull request, please refer to the contributing guidelines.
- Simfphys Base - Reference for coding various systems including passenger seats and particle effects.
- SCS Software - Horn sounds
- SGM - Feature suggestions