# Fuel Theft

Introduce a new level of strategy and risk to your FiveM server with the Fuel Theft Script, allowing players to steal and deposit fuel from vehicles. This script adds an immersive and engaging mechanic for players looking to capitalize on every drop of fuel.

⚡ **Key Features**:

* **Fuel Theft & Deposit System**: Players can use specific tools to steal or deposit fuel from vehicles, offering a unique gameplay mechanic that adds depth to the server’s economy.
* **Customizable Minigame**: Enhance the fuel theft process with an optional minigame that adds a layer of skill and risk, with difficulty levels you can adjust to fit your server's needs.
* **Dynamic Vehicle Interactions**: Certain vehicles can be blacklisted from fuel theft, while others may trigger alarms or even explode if players aren't careful.
* **NPC Tool Shop**: Players can purchase the necessary tools for fuel theft from an NPC, adding an additional layer of interaction and preparation.
* **Realistic Progress Bars**: Fuel theft and deposit processes are time-based, with progress bars that reflect the amount of fuel being transferred.
* **Explosion & Alarm Mechanics**: Vehicles may explode if certain conditions are met, such as attempting fuel theft while the engine is running, adding a thrilling risk to the process.
* **Police Response**: Optionally, enable a police response mechanic that adds a chance for law enforcement to be alerted during fuel theft attempts.

📋 **Requirements**:

* **QBCore Framework**: Seamlessly integrates with QBCore for handling items, currency, and more.

🔧 **Setup & Configuration**:

1. **Installation**: Download and place the script in your server’s resources folder. Add the start command to your server.cfg.
2. **Configure Theft Settings**: Customize the list of blacklisted vehicles, explosion chances, minigame difficulty, and more through the `config.lua` file to suit your server’s needs.
3. **NPC & Tools**: Set up the NPC for players to purchase tools and configure the prices of each item.

Whether you're looking to add a new criminal activity or increase the stakes in your server, the Fuel Theft Script offers a thrilling and immersive experience for players in FiveM.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.tzmc.dev/docs/qb-core/fuel-theft.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.