Advanced and optimized fuel system for ESX roleplay servers.

zcf_fuel - Advanced Fuel System is a complete FiveM resource designed to provide a clean, configurable and performance-friendly fuel system for ESX roleplay servers.

Many servers use very basic fuel systems that only handle vehicle consumption and simple refueling. This resource expands that concept with a modern fuel station UI, configurable fuel prices, multiple fuel types, jerry cans, optional station management, fuel stock and persistent fuel saving for owned vehicles.

How this script can be used in a server

This resource is useful for roleplay servers that want fuel to become a real part of the gameplay and economy, instead of being just a simple vehicle value.

Players can refuel vehicles at gas stations, buy or refill jerry cans and manage fuel usage while driving. Server owners can configure public stations, custom stations, fuel prices, fuel stock, job-based station management, vehicle consumption and electric vehicle exclusions.

The resource is especially useful for economy-based servers, serious roleplay communities and servers that want configurable vehicle running costs.

Main features

• Clean and modern fuel station UI.
• Supports public fuel stations.
• Supports custom fuel stations.
• Supports multiple fuel types.
• Includes configurable fuel prices.
• Includes dynamic prices with configurable ranges.
• Includes optional station stock system.
• Includes optional job-based station management.
• Includes optional station NPCs.
• Supports buying and refilling jerry cans.
• Supports vehicle fuel persistence for owned vehicles.
• Supports custom fuel consumption by RPM.
• Supports custom consumption multipliers by vehicle class.
• Supports custom consumption multipliers by vehicle model.
• Supports electric vehicle exclusion.
• Includes low fuel warning system.
• Includes staff commands for fuel control and debug.
• Supports ox_target integration.
• Supports ox_inventory integration for jerry cans.
• Supports ox_lib notifications.
• Includes fallback 3D text interaction if ox_target is not used.
• Includes developer exports.
• Designed to be lightweight and performance-friendly.
• Includes a clean and fully commented configuration file.
• Includes English and Italian translations.

Performance

The resource is designed to be optimized and lightweight during gameplay.

In our test environment, the script runs at 0.00 ms while idle and around 0.01 ms while active.

Actual performance may vary depending on server build, framework version, other resources and configuration.

Configuration

The resource includes an editable config.lua file. You can edit language, UI branding, payment account, database tables, fuel persistence, target system, inventory integration, notifications, staff permissions, security checks, blips, fuel behavior, jerry can settings, animations, fuel types, fuel consumption, pump hashes, public stations, custom stations, station management, station stock and restock prices.

This allows server owners to adapt the system to their own economy, vehicles, jobs and gameplay style without editing the protected core logic.

Asset Escrow information

This product uses the official Cfx.re Asset Escrow system. The core client and server logic are protected, while the most important customization files remain editable.

Editable files include config.lua, locale files, SQL files, README file and image assets.

Customers can modify the important configuration options while the protected logic keeps the product secure.

Requirements

• FiveM server.
• ESX-based roleplay server.
• oxmysql.
• Lua 5.4 compatible resource environment.
• Cfx.re account with access to purchased assets.

Optional integrations

• ox_target.
• ox_inventory.
• ox_lib.

Support

Support is provided for installation issues, bug fixes and product-related problems. Custom edits, custom server-specific rewrites or compatibility work with heavily modified frameworks are generally not included.