> ## Documentation Index
> Fetch the complete documentation index at: https://axeldevelopment.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# About the Script

> Everything you need for a premium refueling experience, optimized for high-performance servers:

<img className="w-full rounded-xl shadow-lg border border-white/10" src="https://r2.fivemanage.com/pKlTXBH8m7kKAHXFsMDpA/Gemini_Generated_Image_uzwjlxuzwjlxuzwj.png" alt="Gas Station Banner" title="" />

# Advanced Refueling & EV Charging

Advanced, optimized, and realistic fuel system for FiveM. Specifically designed to handle both internal combustion engines and electric vehicles with unique consumption logic and professional UI.

## 🎥 Video Preview

<Card title="VIDEO PREVIEW" icon="youtube" href="https://www.youtube.com/watch?v=9ovy82zHeb0">
  Watch script preview here.
</Card>

***

## ✨ Key Features

Everything you need for a premium refueling experience, optimized for high-performance servers:

### 💼 Advanced Business Integration (Axel Gas Station)

* **Seamless Ecosystem**: Fully integrated with `axel_gasstation` for a complete economy loop.
* **Real-Time Stock**: Refueling directly subtracts from the station's actual liters/kilowatts inventory.
* **Dynamic Economy**: Respects owner-set prices per station. Money paid by players is processed directly via the business transaction logic.
* **Transaction Security**: Server-side validation ensures players have funds (Cash or Bank) before dispensing fuel.

### ⚡ Hybrid Vehicle Support

* **Smart Detection**: Automatically identifies if a vehicle is Gasoline or Electric (EV).
* **Electric Charging**: Unique charging logic for EVs at dedicated charging stations with specialized UI.
* **Separate Pricing**: Supports distinct price multipliers for electricity versus standard fuel.

### 📉 Realistic Consumption & Physics

* **Rope/Hose Physics**: If a player walks too far from the pump while holding the nozzle, the hose snaps and resets automatically.
* **Smart Consumption**: Fuel/Battery drain is calculated based on RPM (Gas) or Speed (EV) + Vehicle Class.
* **Engine Cutoff**: If fuel hits 0%, the engine shuts off and cannot be restarted until refueled.

### 🖥️ Professional NUI & Interaction

* **Modern Interface**: Clean and intuitive UI providing real-time cost calculation.
* **Infinity Mode**: Displays an infinity symbol (∞) for admin or unowned stations, allowing unlimited fuel.
* **Smart Animations**: The player character automatically turns to face the vehicle when refueling starts for maximum immersion.

### 🛠️ Technical Excellence & Fixes

* **Universal Compatibility (Dual Sync)**: Uses both **State Bags** AND **Decorators**. This ensures the fuel level is visible on 99% of HUDs, garages, and garages without extra code.
* **EV Garage Fix**: Solves the common GTA V bug where electric vehicles spawn with 0% fuel.
* **0.00ms Optimization**: Highly optimized code that "sleeps" when the player is not in a vehicle.
* **Restart Safe**: Nozzle targets and pump interactions are automatically restored if the script is restarted.

***

### 📂 Integration Exports

<CardGroup cols={1}>
  <Card title="Installation Guide" icon="download" href="/axel-fuel-system/export">
    Visit Export Section
  </Card>
</CardGroup>

## 🚀 Ready to start?

<CardGroup cols={1}>
  <Card title="Installation Guide" icon="download" href="/axel-fuel-system/installation">
    Follow our step-by-step guide to get the script running in minutes.
  </Card>
</CardGroup>