Description

Koldysek Advanec Fuel System

Turn your gas stations into a real player-owned business.

Koldysek_FuelSystem is a complete fuel and gas station system built around realistic gameplay, player-owned stations, fuel logistics and an active economy. From physically refueling vehicles with a fuel nozzle to ordering tanker deliveries and managing your station's finances — everything is designed to feel like an actual business.

⛽ Realistic Refueling

• Physical fuel nozzle attached to the player's hand

• Real GTA rope physics for the fuel hose

• Optional lightweight drawn hose system

• Jerry cans with full fill & refuel functionality

• Support for multiple fuel types

🏪 Player-Owned Gas Stations

• Buy and own gas stations across the map

• Set your own fuel prices

• Multiple fuel tanks with individual capacities and stock

• Station-specific bank/till system

• Rename, sell or transfer stations

• Configurable public station fallback pricing

• Customizable station blips

📈 Dynamic Fuel Market

Fuel prices aren't simply randomized.

Wholesale fuel prices can be connected to the Koldysek_Bridge TradeDeck market, allowing oil market movements to directly influence your supplier prices.

Buy fuel when prices are low, manage your stock and set your own retail prices.

🚛 Fuel Delivery System

Stations need to be supplied by actual deliveries.

• Order fuel from configured suppliers

• Approval and delivery process

• Collect tanker trailers from the depot

• Refundable delivery deposits

• Drive the tanker to your station

• Physically unload the fuel

• Automatic handling of cancelled, failed or lost deliveries

👥 Employee Management

Hire employees directly through the management tablet and control exactly what they can access.

• Manage Prices

• Manage Deliveries

• View Finances

• Manage Team

• Withdraw Funds

• Manage Shop

All permissions are validated server-side.

💳 Loyalty Cards

Sell branded loyalty cards at your station and offer customers a custom member price.

Players can also purchase and use jerry cans directly through the station's NPC clerk.

🔧 Misfueling & Vehicle Damage

Putting the wrong fuel into a vehicle actually matters.

Misfueling causes persistent engine damage tracked by vehicle plate, surviving restarts and garage visits until the vehicle is properly repaired.

📊 Advanced Finance Dashboard

Track your entire station business through a modern management dashboard.

• Revenue

• Expenses

• Profit

• Today / 7 days / 30 days / All Time

• 12-month financial overview

• Interactive TradingView charts

• Transaction history

• CSV export

• Optional Discord webhook reports

🌍 English & Czech

Fully localized and ready to use in English and Czech.

Adding additional languages only requires translating the locale file.

🔒 Server-Authoritative

Built with security and reliability in mind.

Prices, fuel amounts, permissions, deliveries and station finances are validated server-side. Database transactions are handled atomically to prevent unauthorized money movement or inconsistent station data.

📦 Requirements

Required

• Koldysek_Bridge

• ox_lib

• ox_target

• oxmysql

• ox_inventory

Optional

• ox_fuel — used only for background fuel consumption simulation