# 🛢️ ACE OILFIELDS | The First Oil Pump Job for FiveM

### Multi-Framework | ESX · QBCore · QBox | ox_target · qb-target · DrawText

---

> **FiveM has trucking jobs, weed farms, car theft rings — but nobody has ever built a proper oil extraction operation. Until now.**

ACE Oilfields is the first fully-featured oil pump job ever released for FiveM. Purchase rigs, place them on the map, keep them running, haul the crude by trailer, and cash out at the refinery. Every single value in the script is yours to own.

---

## 🔩 HOW IT WORKS

1. **Buy** your oil pump from the shop ped — a fully configured NPC at a real location with blip support

2. **Place** it on the map using a live ghost-model preview — rotate it with scroll wheel or Q, confirm with G

3. **Manage** it — pumps drain fuel and degrade over time. Neglect them and production dies

4. **Collect** — press Collect Oil and a trailer auto-spawns at the pump. Load it up

5. **Haul & Sell** — drive to the refinery, back the trailer into the marker, and cash out

---

## ⚙️ FEATURES

🗺️ **Ghost-Model Placement System**

Place pumps with a live 3D preview. Scroll or hold Q to rotate. Green = valid zone, Red = invalid. Confirm with G, cancel with Backspace or ESC — ghost is always cleaned up cleanly.

📉 **Server-Side Tick Engine**

Every pump runs a dedicated server-side loop that handles fuel drain, health degradation, and oil extraction at fully configurable intervals. What happens on the server, stays on the server.

🚛 **Trailer Transport with Enforcement**

Oil gets loaded into a trailer that auto-spawns at collection. Drive it to the sell zone, align the trailer correctly — a heading tolerance check is enforced. You actually have to back in properly.

🔧 **Maintenance & Refuel System**

Configure exactly which items refuel and repair each pump. Set how much each item restores. Low health = reduced output. Dead pump = zero production.

🏪 **Shop Ped with Blip**

Fully configured NPC vendor at a custom location. Compatible with ox_target, qb-target, and drawtext. Configurable ped model, heading, and idle scenario.

🖥️ **Custom Red-on-Black NUI Panel**

Animated status bars for pump health, fuel, and oil level. Live colour-coded status pill (Operational / Needs Attention / Offline). Instant response — panel closes the moment you press an action.

👷 **Per-Player Pump Limit**

Set exactly how many pumps each player can own server-wide. Fully enforced server-side.

🗄️ **MySQL Persistence**

All pump data stored in database via oxmysql. Pumps survive server restarts, resource restarts, and player disconnects.

---

## 🔌 COMPATIBILITY

| | Supported |

|---|---|

| **Frameworks** | ESX · QBCore · QBox |

| **Inventories** | ox_inventory · qb-inventory · ESX |

| **Targeting** | ox_target · qb-target · DrawText |

| **Database** | oxmysql |

---

## ⚡ FULLY CONFIGURABLE

Everything in `config.lua` is open and documented:

- Max pumps per player

- Fuel drain rate & maintenance degradation speed

- Oil extraction rate & max oil capacity

- Fuel items & maintenance items (any item, any amount)

- Placement mode: specific oil zones OR anywhere on the map

- Sell location, price per litre, heading tolerance

- Trailer model, shop location, ped model & scenario

- Blip visibility toggles for all map markers

---

## 📦 WHAT YOU GET

✅ Full multi-framework source (ESX / QBCore / QBox)

✅ Automatic database table creation on first start

✅ Standalone SQL file for manual setup

✅ Fully documented `config.lua` — open and unencrypted

✅ English locale file — open and unencrypted

✅ NUI panel (HTML/CSS/JS) — open and unencrypted

✅ Lifetime updates

---

## 🔴 ACE Scripts

*Built for servers that want more than a reskin.*