> For the complete documentation index, see [llms.txt](https://docs.menanak47.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.menanak47.com/multi-framework/ak47_fuelstations.md).

# ak47\_fuelstations

The ultimate fuel station business and immersive refueling experience for FiveM servers.

{% embed url="<https://youtu.be/jNI4WD2zVTw>" %}

ak47\_fuelstations turns ordinary gas stops across San Andreas into dynamic, player-managed commercial operations with interactive refueling, custom per-liter pricing, and realistic physical hose ropes. Backed by `ak47_lib`, it offers full multi-framework compatibility with ESX, QB-Core, and QBX out of the box.

***

### 🔥 Key Features

Designed to improve roleplay immersion and economy balancing:

#### 🏪 Station Ownership & Business Management

* **26 Pre-Configured Locations:** Players can buy, operate, or sell 26 gas stations strategically mapped throughout Los Santos and Blaine County. Selling returns 50% of the initial investment and upgrade costs.
* **Modern NUI Dashboard:** Responsive UI featuring 7-day visual revenue graphs, real-time business bank account balance, and an animated liquid-wave fuel storage gauge.
* **Custom Fuel Pricing:** Station owners set their own fuel prices per liter within server-configured minimum and maximum thresholds to compete with rival stations.

#### ⛽ Immersive Refueling & Hose Physics

* **Physical Ropes & Synced Nozzles:** Refueling spawns authentic rope physics connected from the fuel pump directly to the nozzle in the character or attendant's hand.
* **Self-Service & Attendant Modes:** Configure stations for automated NPC self-service attendants or full-service employee operation where workers manually refuel vehicles.
* **Interactive Customer Billing:** Attendants send custom digital invoices to customer screens displaying liters and total cost, allowing clients to accept or decline before fuel is pumped.

#### 🚚 Logistics & Fleet Upgrades

* **8 Progressive Upgrade Tiers:** Expand underground fuel storage from 1,000L up to 8,000L, each tier unlocking larger capacity commercial transport vehicles.
* **Fleet Vehicles & Trailers:** Drive tier-matched vehicles including Youga 2, Bison, Boxville, Benson, Stockade, and heavy-duty Hauler/Phantom semi-trucks with fuel tankers.
* **Refinery Depot Resupply:** Collect bulk wholesale fuel from the central Oil Depot at discounted rates to replenish station reserves.

#### 👥 Staff Management & Pump Maintenance

* **Complete Employee System:** Hire players on the fly using their Server ID, define custom salaries, and let the script handle automated periodic payroll.
* **Pump Wear & Repair:** Fuel pumps have a configurable chance to break down over time. Station owners can inspect and repair pumps on-site using station business funds.
* **Class-Based Tank Capacities:** Realistic fuel tank volumes customized across all GTA vehicle classes—from compacts (45L) and sedans (60L) to supercars (80L), industrial trucks (400L), boats (250L), and aircraft (1200L).

#### 🛠️ Technical Excellence

* **Multi-Framework & Target Support:** Seamlessly works with ESX, QB, QBX, and various target systems (ox\_target, qb-target, qtarget).
* **Highly Secure:** Built-in server-side exploit checks, including distance validation and trigger authentication, to prevent cheating.
* **Automatic Database Migrations:** Tables and schemas are automatically verified, created, and migrated on resource startup with zero manual SQL hassle.

***

### 💻 Framework:

* ESX, QB, QBX

***

### ⚙️ Dependencies:

* ak47\_lib: <https://github.com/MenanAk47/ak47_lib/releases/latest>

***

### ⚙️ How To Install:

* Download ak47\_fuelstations from your cfx portal.
* Add the script in your resources folder.
* Add items based on your framework instruction.
* Add item images into inventory.
* Start the script in your server.cfg below framework files.
* Make sure you have all dependencies.
* Restart the server.

***

### 🔗 Links & Support:

* **📖 Documentation:** <https://docs.menanak47.com/multi-framework/ak47_fuelstations>
* **🛒 Buy Now (Tebex):** <https://menanak47.tebex.io/package/7070603>
* **💬 Discord Support:** <https://discord.gg/menanak47>

***

### 📝 Note:

* We don't support custom framework. Make sure you are using official framework update.
* Renaming the script is not allowed. It may break the functionalities.
* Don't upload the script with FileZilla, Use Winscp if you are using FTP for file uploading