Codem xFuel — A complete vehicle fuel system for FiveM roleplay servers.
A clean, fully configurable fuel resource that works standalone or alongside your framework. Players pull up to any gas station pump, select their fuel type, pay, and fill up — with per-vehicle-class consumption rates, multiple fuel grade pricing, and developer exports for deep integration with other scripts.
FEATURES
- Pump Interaction — Players approach any gas station pump in the world and interact with it to open the refueling interface. Works with all default map pump models and supports adding custom pump models.
- Multiple Fuel Types & Pricing — Configure separate prices for different gasoline grades to match your server's economy. Adjust each fuel type price independently from the config.
- Per-Vehicle-Class Fuel Consumption — Set how much fuel each vehicle class consumes. Motorcycles, sedans, SUVs, and heavy vehicles can all burn fuel at different rates to add realism to your economy.
- Vehicle Blacklist — Prevent specific vehicles from refueling or consuming fuel entirely. Blacklist any vehicle by model name from the config.
- Default Vehicle Fallback — If a vehicle does not have a registered image or name, a configurable default image and name displays in the UI instead of a blank entry.
- Map Blips — Add blips to any number of gas station locations on the map. Blip type, color, scale, and name are all configurable per location.
- Standalone or Framework — Works completely standalone with no framework dependency. Optionally plug in ESX or QBCore to handle player payments after refueling via the editable server and client files.
- Interaction Handler Support — Choose your preferred interaction handler — drawtext, ox-target, or qb-target. CodeM mTextUI is automatically used instead of drawtext if present on the server.
- Speed Unit Configuration — Set the speed unit displayed in the UI to kmh or mph to match your server's region and HUD style.
- Custom Pump Model Support — Running custom map props or MLOs with non-default pump models? Add any pump model hash to the config and xFuel will detect and interact with them automatically.
- Developer Exports — Two clean exports let other scripts read or set fuel levels on any vehicle directly. Fully compatible with HUDs, mechanic scripts, and any resource that needs fuel data.
- Editable Handler Files — Client and server editable files are escrow-ignored, giving full access to customize the payment flow, interaction triggers, and framework hooks without touching protected code.
FRAMEWORK SUPPORT
- Standalone (no framework required)