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.