🔧 Advanced Auto Repair & Wash System (ESX)

A professional, highly optimized, and immersive vehicle maintenance system for FiveM/VMP.
This script provides an automated solution for repairing and washing vehicles with realistic animations and effects.

---

📌 Table of Contents

• ✨ Features
• 📸 Preview
• 🚀 Performance
• 📥 Installation
• 📦 Requirements
• ⚙️ Configuration
• 🔧 Customization

---

✨ Features

• 🛠 Smart Repair Logic: Automatically detects engine damage and calculates repair costs dynamically based on the missing Health Points (HP).
• 🧼 Integrated Car Wash: Provides a high-quality vehicle cleaning service at any designated location to keep cars looking brand new.
• 👥 Mechanic Online Check: Smart system that detects online mechanics; if enough mechanics are on duty, the automated service can be disabled to prioritize player-to-player Roleplay.
• 🎭 Immersive Experience: Fully automated sequence where players exit the vehicle, walk to the engine bay, open the hood, and perform a realistic repair animation.
• ✨ Synchronized Particle Effects: High-fidelity visual effects including welding sparks or steam emitted from the engine during the repair process for maximum realism.
• 🔊 Dynamic & Looping Audio: Features 3D spatialized welding and washing sound effects that loop perfectly until the progress bar is complete.
• 💰 Flexible Payment System: Fully integrated with the ESX economy, allowing players to choose between Cash or Bank payments via a clean interaction menu.
• ⏳ Progress Bar Integration: Native support for ox_lib or standard progress bars to give players clear visual feedback on the remaining service time.
• 📍 Multi-Location System: Easily define unlimited service stations on the map, each with unique settings (Repair only, Wash only, or both).
• 🌍 Fully Translatable: 100% of the UI, notifications, and help messages are configurable via the Config.lua file.
• 📜 Discord Webhook Logging: Advanced logging system that sends detailed reports (Player Name, Vehicle Plate, Service Type, and Total Cost) to your Discord staff channel.
• ⚡ Ultra Optimized: Industry-leading optimization with a resource usage of 0.00ms while idle, ensuring zero impact on server FPS.

---

📸 Preview (Soon...)

🎬 Click here to watch the Video Demonstration (YouTube - Soon...)

Click the image above to watch the script in action on YouTube.

---

🚀 Performance

Status	Resmon Value
Idle (Far from location)	0.00 ms
Idle (Near marker)	0.01 ms
Active (Processing Action)	0.03 ms

---

🛠 Installation

1. Download the latest version.
2. Move the folder esx_auto_repair to your resources directory.
3. Configure your settings in config.lua.
4. Add the following to your server.cfg:

ensure esx_auto_repair

---

📦 Requirements

• es_extended
• ox_lib (Optional for Progress Bar)

---

⚙️ Configuration

Variable	Description	Default
Config.Economy.pricePerHP	Cost per 1.0 health damage	1.5
Config.Economy.washPrice	Fixed price for car wash	50
Config.Mechanic.checkOnline	Enable/Disable mechanic check	true
Config.Visuals.exitVehicle	Player must exit car to repair	true

---

🔧 Customization

Adding New Locations

Open config.lua and add your coordinates to the table:

Config.Locations = {
    {
        label = "Mechanic Shop",
        coords = vector3(-211.5, -1324.2, 30.8),
        canRepair = true,
        canWash = true,
        blip = { sprite = 446, color = 5, scale = 0.8 }
    },
}

---

Made with ❤️ for the FiveM/VMP Community by ali1248 (alibaba)