Skip to main content

Documentation Index

Fetch the complete documentation index at: https://axeldevelopment.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

Gas Station Banner

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

VIDEO PREVIEW

Watch script preview here.

✨ 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

Installation Guide

Visit Export Section

πŸš€ Ready to start?

Installation Guide

Follow our step-by-step guide to get the script running in minutes.