Lyre Fuel - Complete Fuel Station System with Ownership, Stock Management, Multiple Fuel Types & In-Game Configuration


Lyre Fuel is a complete fuel station management system for FiveM servers. It transforms the way players interact with vehicles and fuel by offering a realistic fuel consumption system, purchasable fuel stations with full ownership management, multiple fuel types (gasoline, diesel, electric, boats, aviation), stock management, tank upgrades, and much more! Whether you want simple public stations or a full player-driven economy, this script adapts to your needs with powerful configuration options and a beautiful modern interface.


  • Multiple Fuel Types – Support for 5 default fuel types: Gasoline, Diesel, Electric, Boats, and Aviation fuel. Each type has unique consumption rates, refueling speeds, units (liters/kWh), and vehicle lists. You can also create custom fuel types in the configuration!
  • Realistic Fuel Consumption – RPM-based fuel consumption system. The faster you drive, the more fuel you consume. Each fuel type has its own consumption curve for maximum realism.
  • Dynamic Station Creation – Admins can create, edit, and delete fuel stations entirely in-game using the /fuelstationsmanagement command. No manual config editing or server restarts required! Includes a visual setup wizard with raycasting for precise positioning of peds, pump locations, and refill vehicle spawn points.
  • Station Ownership – Any player can purchase a fuel station and become its owner. Owners manage prices, stock levels, tank upgrades, and can open/close their station or put it up for sale.
  • Full Financial Management – Station owners can deposit and withdraw money from their station account, track revenue from fuel sales and item purchases, and monitor their business finances.
  • Stock Management System – Track fuel stock levels for each fuel type independently. When customers refuel, stock decreases. Station owners must refill their tanks to keep the business running.
  • Two Refill Methods
    • Express Refil (optionnal)l: Instant restocking at a premium price (configurable fee percentage)
    • Mission Refill (optionnal): Drive a tanker truck to the supply depot, attach a trailer, and deliver fuel back to your station for lower costs
  • Tank Upgrade System – 6 upgrade levels available for each fuel type. Upgrade your tanks to increase storage capacity from 1,000L up to 50,000L. Each upgrade requires investment but allows for more efficient operations.
  • Nozzle System (optionnal) – Optional visual enhancement with realistic fuel nozzle mechanics. Players grab the nozzle from the pump, a rope/hose connects dynamically, insert the nozzle into the vehicle, and refuel with immersive animations.
  • Portable Fuel Items – Configure portable fuel items (gas cans, diesel cans, portable chargers) that players can purchase at stations and use anywhere. Each item has configurable animations and props.
  • Custom Electric Charger Props – The script comes with a custom Electric Charger prop which is used on electric stations.
  • Open/Closed System – Station owners can open or close their station to the public. Closed stations show a different blip color on the map.
  • Station Sale System – Owners can put their station up for sale at a custom price. Other players can then purchase the station and become the new owner.
  • Admin Tools – Powerful admin commands including /fuelstationsmanagement for full station control and /setfuel to set any player’s vehicle fuel level. Admins can also remove station owners to convert stations back to public.
  • Real-time Map Blips – Blips show station status (open/closed/owned) with different colors.
  • Vehicle Blacklist – Configure vehicles that should not use fuel (bicycles by default). Temporary blacklist system available for special scenarios.
  • Beautiful Web UI – Clean, modern React interface with tabbed management menus, progress bars, and intuitive controls. Includes refuel menu, management dashboard (5 tabs), station wizard, and more.
  • Two Interaction Modes – Support for both 3D markers and target systems (ox_target, qb-target, lyre_context).
  • Multi-language Support – The script is available in 9 languages by default (EN, FR, ES, DE, IT, NL, RU, JA, ZH-CN), with easy customization options.
  • Developer Friendly – Includes 35+ server exports for advanced integrations: get/set fuel levels, manage station data, control stock, handle accounts, and more.
  • Discord Webhook Logging – Optional Discord webhooks for logging station creation, purchases, refueling, stock refills, upgrades, and financial transactions.
  • Public Station Mode – Configurable option to disable stock and management systems when stations have no owner, allowing free public refueling.
  • Ultra-Optimized – Runs at an ultra-low performance impact, lazy loading for peds and blips, batched data sync for large databases.
  • Framework Bridge System – Fully compatible with ESX, QBCore and QBOX, and other frameworks through a bridge pattern.

All features can be configured as desired, if you have any doubts, do not hesitate to go to our documentation to see how the default configuration works.

Refuel Menu

Station Management - Overview Tab

Station Management - Economy Tab

Station Management - Stock Tab

Station Management - Upgrades Tab

Station Management - Settings Tab

Admin Panel - Station List

In-Game Station Creation Wizard


Pump Placement Tools

Refill Mission - Tanker Truck

Nozzle System in Action

Dependencies

The script has been planned for the use of the latest versions of the dependencies mentioned.

Framework compatibility
  • ESX (latest version): Drag and drop compatible (bridge auto-detection enabled by default)
  • QBCORE (latest version): Drag and drop compatible (bridge auto-detection enabled by default)
  • QBOX (latest version): Drag and drop compatible (bridge auto-detection enabled by default)
  • Any other framework: You can create a custom bridge (see our documentation for how to do that)

The script uses a framework bridge pattern - all framework-specific code is isolated in the bridge folder for easy multi-framework support.

SQL resource compatibility
Onesync compatibility
  • Onesync Infinity: Compatible
  • Onesync Legacy: Compatible
  • Without Onesync: Compatible
Target system compatibility
  • ox_target: Compatible
  • qb-target: Compatible
  • lyre_context: Compatible
  • 3D Markers: Compatible

:point_right: Buy it on Tebex :point_left:
Script is actually 30% OFF

Check our gitbook page for documentation

Code is accessible No
Subscription-based No
Lines (approximately) ~12000
Requirements oxmysql, ox_lib
Support Yes
3 Likes

I have purchased it. The power station does not have a module, does the electric pile module not have one

Hi, the Tesla supercharger MLO is only to illustrate the script. It is not included and is available for free.

Summary of recent updates

v1.1.1

  • Add GetFuel and SetFuel exports for more compatibility

v1.1.2

  • Add an “item refuel” system, so you can refuel vehicle with items like petrol can, you can configure specific items for specific vehicles

New update !

v1.1.3

  • Add full support for my Lyre TextUI Library (if you have lyre_textui on your server, it will be detected and it will use it)
  • Enhance item fuel system

What does the script look like when using lyre_textui?
Watch the video

New update !

v1.1.4

  • Add a system to automatically detect the framework of your server
  • Script is now compatible for qs-inventory by Quasar and ox_inventory by Overextended, the script will automatically detect the inventory you use
The following things will be added in the future :
  • Support of qb-inventory (can be actually manually added, but need some Lua skills)
  • Any other suggestion you want

Amazing script ! Maybe the best one :smiley:

1 Like

Thanks !

Great script! Super communication and top support.

1 Like

Thanks for your review !

It’s a really great script. Problems I reported were solved within a few hours, it works great if some functions are added that are planned it will be spectacular (like buying canisters or an extra configuration for electric vehicles)

Thanks you for your feedbacks ! :wink:

1 Like

v1.2.0 is avalaible for lyre_fuel

  • Fix a little problem with the exports. Thanks to Karle for the report
  • Enhance de.lua language. Thanks to Karle for the enhancement
  • We’ve just rewrote the logic of the vehicle fuel system

How to update since v2.1.6 ?

Simply replace all script files with the new ones. You can keep your old configuration, however be careful, you need to replace 2nd line of the config file. The line Config.Locale should be replaced with Config.locale, simply put in lower case.

And after that ?

The next updates will aim to make the script compatible with ox_target and qb-target. Furthermore, we will focus on the possibility of being able to better configure fuel usage according to vehicle categories. We would also like to develop a system to be able to fill gasoline cans from gas stations.

Feel free to download the new version on your keymaster: Cfx.re server key management

There is free two gas stations scripts like this if someone dont have money for buy dom fuel and cdn fuel

1 Like

I appreciate your feedback! I just wanted to take this opportunity to share that I’m currently doing a full rework of both the Fuel and Carwash scripts. The updated versions will be available soon, and all current buyers will receive them for free. These new versions will include redesigned React-based interfaces and more realistic mechanics tailored for an immersive roleplay experience.

1 Like

That’s sounds awesome!!

1 Like

I’ve been using the Lyre Advanced Fuel System, and it adds a lot of depth to the server. The ability to manage fuel stations, support for electric vehicles, and the integration with boats and planes make it feel much more immersive. It runs smoothly, is easy to configure, and adds another layer of realism to the economy. Definitely a great addition for any server looking to improve its fuel system.

1 Like

Thank you for this feedback ! :slight_smile:

Rework 2.0.0 is here!

After months of work, we are proud to announce the complete rework of Lyre Fuel!

If you already own the script, you have automatically received the new version on your CFX Portal.

This is not just an update - this is a brand new script, entirely redesigned from the ground up.

What’s new in 2.0.0?

  • In-game station configuration - No more config files! Create, edit and delete stations directly in-game with a visual setup wizard using /fuelstationsmanagement
  • Nozzle system - Realistic fuel nozzle mechanics with dynamic rope/hose, animations and immersive refueling experience
  • Custom electric charger prop - A unique prop designed specifically for electric charging stations
  • Complete management system - Station ownership, stock management, tank upgrades, financial tracking, and more
  • Two refill methods - Express refill or mission-based refill with tanker truck delivery
  • Beautiful new UI - Modern React interface with tabbed menus and intuitive controls
  • Multiple fuel types - Gasoline, Diesel, Electric, Boats, Aviation - fully configurable with custom types support
  • All community suggestions implemented - We listened to your feedback and integrated everything you asked for

Every feature has been rethought, every line of code has been rewritten. This 2.0.0 version represents what Lyre Fuel should have been from the start.

Thank you all for your continued support. Your feedback and suggestions made this rework possible. We hope you enjoy this new version as much as we enjoyed creating it!

As always, check our documentation for installation and configuration guides.