FiveM Open Source Vanaheim Fuel Script

DOCUMENTATION

DESCRIPTION

STG Fuel is the most detailed and feature-rich gas station script for FiveM, designed for servers that value depth and realism. It offers full station ownership with business management, hireable NPC workers, real nozzle & hose physics, pump maintenance with auto-repair mechanics, fuel delivery runs, an integrated car wash system, fuel siphoning with police alerts, electric vehicle charging, helicopter & boat fueling, multi-type fuel support, dynamic pricing, staff roles & ranks, financial tracking, stock control, station transfers, and a sleek, modern UI — everything a gas station needs, and more.

KEY FEATURES

Station Ownership: Purchase, manage, and sell gas stations as a fully functional business with naming customization.
Multi-Type Fuel System: Diesel, Gasoline, Premium, and Electric fuel types with unique depletion rates and vehicle class detection.
Nozzle & Hose Physics: Real rope physics, fuel cap detection, and refueling animations with a visible filling meter.
NPC Workers: Hire pump attendants, car wash crew, delivery drivers, and mechanics — all fully automated with intelligent pathfinding and animations.
Automatic Refueling: Attendants detect customers, grab the nozzle, walk to the fuel cap, and refuel vehicles without any player input.
Pump Maintenance: Pumps degrade with use, slow down when damaged, and eventually break. Repair manually or hire a mechanic for auto-repair.
Fuel Delivery System: Order fuel deliveries with multiple vehicle options, GPS routes, and damage-based fuel leaks. Or send a hired driver for automatic delivery.
Integrated Car Wash: Unlockable car wash with animated NPC workers, door animations, and multi-zone cleaning.
Dynamic Pricing: Set custom fuel prices per type with min/max constraints to control your station's economy.
Staff Roles & Ranks: Create custom ranks with individual permissions, daily salaries, and automatic payroll.
Financial Dashboard: Full transaction history, tax tracking, monthly expense reports, deposit/withdraw, and profit statistics.
Stock Management: Wholesale restocking system with per-type inventory levels and visual barrel fill indicators.
Pump Unlock System: Start with one pump and progressively unlock more as your business grows.
Station Transfers: Transfer full ownership to another player with balance, staff, and rank data included.
Wrong Fuel Mechanics: Realistic engine damage and stall when using the wrong fuel type in a vehicle.
Jerry Can: Portable fuel container for roadside emergencies with refill and refund support.
Electric Vehicle Charging: Dedicated charging stations with custom props for electric vehicles.
Helicopter & Boat Fueling: Dedicated helipad and dock refueling points with pump props and separate pricing.
Fuel Siphoning: Steal fuel from parked vehicles — triggers police alerts with location, partial plate, and mugshot.
NPC Speech Bubbles: All station NPCs have contextual dialogue with floating speech bubbles.
Realistic Fuel Consumption: RPM-based consumption with class multipliers, tank size scaling, and persistent fuel per vehicle.
Modern UI: Sleek NUI interface for fuel purchasing, business management, member tables, and financial operations.
Member Management: Add online players as staff, assign ranks, and track individual sales stats and work time.
Anti-Cheat: Server-side validation on all transactions with rate limiting and suspicious activity logging.
Multi-Language Support: Locale file system for easy language customization.
ESX, QBCore & QBX Support: Framework-agnostic via stg_lib bridge with seamless integration.

https://www.youtube.com/embed/BxYWZXRjlxw

https://stg-store.gitbook.io/documentation/scripts/vanaheim-fuel