FS-Fuel

FS-Fuel adds working nozzles, custom hoses, fuel prices, and electric charging to your server. Players connect a nozzle to their vehicle and follow their sale on the pump's physical display.

These docs cover FS-Fuel 1.0.0. Updated October 2, 2026.

Start Here

1. Install the required resources and choose your payment adapter in Installation.
2. Review Configuration, especially payments and interactions.
3. Follow Usage at a supported pump.

Expected result: a nozzle connects, the pump displays the sale, and the configured payment provider settles the bill. See Troubleshooting if a step fails.

Installation and Configuration

Start with the setup guide below. Pump placement, custom screens and exports are separate advanced tasks; they are not prerequisites for an ordinary supported pump.

Guides

• Install & configure: installation, payments, prices, vehicle settings, and the fuel gauge.
• Pumps & chargers: the station manager, placement controls, JSON locations, and custom pump models.
• Price signs: normal and tall signs, model replacement, and roadside lighting.
• Custom displays: fit physical screens to your own pump or charger models.
• Troubleshooting: common problems and what to check.
• Exports: connect a garage, HUD, or another script.

How to fill a vehicle

1. Park beside a pump. Turning off the engine avoids the optional gasoline refueling explosion risk.
2. Leave the vehicle and press E at the pump to take a nozzle.
3. Walk to the vehicle's fuel cap and press E to connect it.
4. Watch the pump display. Filling stops when the tank is full, unless the optional overfill feature triggers.
5. Press E at the vehicle to remove the nozzle, then return it to the pump with E.

With target interactions enabled, select the matching actions in your target menu instead.

Gasoline and diesel vehicles use the same liquid-fuel pumps. The vehicle determines the fuel grade and price. Return the nozzle before starting a sale for a different grade.

Your bill stays open until you return or drop the nozzle. Removing it from the vehicle pauses filling without starting a new bill. The default limit is four active nozzles per player, shared by gasoline and EV connections. Only one can be handheld; connected vehicles can continue filling independently.

Electric vehicles

Use an electric charger instead of a liquid-fuel pump. The steps are the same, and the display shows kWh instead of gallons. Charging works with the engine on or off, including while someone is seated in the connected vehicle.

The charger and connector models are included. Use the station manager to add or move charger locations.

Included features

• Modern LCD, classic mechanical, vintage, and EV displays on supported models.
• Custom hoses that hang, wrap around pumps and nearby props, and break when stretched too far.
• Separate gasoline and diesel prices for Los Santos, Sandy Shores, and Paleto Bay, always ending in 9/10 cent.
• Nine 3D price sign styles, including tall variants and optional roadside lamps.
• An admin station manager with world placement, ground snapping, precise adjustments, and persistent JSON saves.
• Tank and battery sizes, driving consumption, EV regeneration, and a configurable vehicle fuel gauge.
• Positional sounds, optional fuel spilling and overfilling, and temporary payment holds.

Liquid fuel is measured in US gallons; electricity uses kWh. The vehicle's underlying fuel or battery level remains 0 to 100% for garage and HUD integrations.