ds-engineswapdeluxe

# DS Engine Swap Deluxe

**Persistent engine sound swaps for FiveM** — players change how their car sounds at mechanic bays or self-service lifts. Installs save by **plate** and come back when the vehicle is pulled from the garage.

## Why your server needs this

- **Immersive mechanic RP** — job-locked bays, bill customers, optional order queue (customer orders → mechanic installs)

- **Self-service bays** — public installs without staff online

- **Modern built-in UI** — categories, search, **live engine preview** before buying

- **Fully configurable** — prices, locations, performance multipliers, damage chance, Discord logs

- **Admin-friendly** — in-game zone creator, add/remove sounds, edit listings without touching code

## Frameworks

✅ QBCore · Qbox · ESX · ND_Core  

✅ ox_lib · oxmysql (auto-detects many notify/bank/menu resources)

## Highlights

| 🔧 | Mechanic & self-service locations |

| 💳 | Bank / cash payments + customer billing (accept/decline) |

| 📋 | Engine orders (optional drop-off workflow) |

| ⚡ | Per-engine power / torque / top-speed tuning |

| 🌍 | 10 languages built in |

| 🛠️ | Zone creator + engine sound tools for admins |

## Quick setup

1. Drop resource in resources, ensure after framework + oxmysql  

2. Set framework & locale in mainconfig.lua  

3. Adjust bays in locationsconfig.lua / selfservicelocationsconfig.lua  

4. Restart — **database tables auto-create**

Full install guide included in the download (`README.md`).

## What you get

• Escrow-ready resource (per your Tebex package)  

• Pre-configured example bays & engine catalog  

• Customer documentation 

**Deluxe Shop** — Engine Swap Deluxe