Animations
📄 Config file: shared/animations.lua
This file defines the animations played during each maintenance and installation action. Every action has its own animation dictionary, animation name, duration, and options for freezing the player/vehicle.
Animation Settings
Each animation block has the following properties:
| Property | What it does |
|---|---|
Animation | The animation clip name to play. |
AnimationDict | The animation dictionary the clip belongs to (must be loaded first). |
Duration | How long the action takes in milliseconds. |
FreezeCar | When true, the vehicle is frozen in place during the action (can't roll away). |
FreezePlayer | When true, the player can't move during the action. |
Cancelable | When true, the player can cancel the action by moving/pressing a key. |
Default Animations
| Action | Animation | Duration | Notes |
|---|---|---|---|
| Change Spark Plugs | mini@repair → fixing_a_ped | 5 seconds | Quick replacement |
| Change Oil | mini@repair → fixing_a_ped | 10 seconds | Longer due to draining/filling |
| Change Oil Filter | mini@repair → fixing_a_player | 5 seconds | |
| Change Air Filter | missmechanic → work2_base | 3 seconds | Quick swap |
| Change Tires | mp_car_bomb → car_bomb_mechanic | 7 seconds | Full set replacement |
| Change Brakes | anim@amb@clubhouse@tutorial@bkr_tut_ig3@ → machinic_loop_mechandplayer | 5 seconds | |
| Change Suspension | mp_car_bomb → car_bomb_mechanic | 7 seconds | |
| Change Clutch | mini@repair → fixing_a_ped | 15 seconds | Longest standard repair |
| Balance Wheels | mp_car_bomb → car_bomb_mechanic | 8 seconds | |
| Install Turbo | amb@world_human_vehicle_mechanic@male@idle_a → mechanic_idle_a | 10 seconds | |
| Repair Turbo | mini@repair → fixing_a_ped | 8 seconds | |
| Install Tuning Chip | mini@repair → fixing_a_ped | 10 seconds |
All animations have FreezeCar and FreezePlayer set to true and are Cancelable by default. You can change any of these per-action if needed.
Changing animations: You can replace any animation dictionary and clip with another GTA V animation. Make sure the animation exists in the game files. Popular mechanic-related dictionaries include mini@repair, mp_car_bomb, amb@world_human_vehicle_mechanic@male@idle_a, and missmechanic.