# Fuel

{% hint style="danger" %}
Do not reload the plugin or the server to put these changes into effect. Restart the server.
{% endhint %}

***

## <mark style="color:orange;">Information</mark>

The default fuel items can be found in the `config.yml`. Some examples are: Wood items, coal, wool items, lava buckets, wheat, etc...&#x20;

To refuel your vehicle open the fuel gui ([<mark style="color:orange;">controls</mark>](/introduction/faq.md#how-do-i-drive-this-that-vehicle)), and drag the items onto the fuel bucket.

***

## <mark style="color:orange;">General Fuel Settings</mark>

{% code title="" %}

```yaml
fuelEnabled: true
fuelBarEnabled: true
#1: Text, 2: Icon
fuelBarType: 2
iconFuelBarSize: 30
```

{% endcode %}

| Setting           | Info                                                               |
| ----------------- | ------------------------------------------------------------------ |
| `fuelEnabled`     | Enable or disable the fuel entirely                                |
| `fuelBarEnabled`  | Enable or disable the fuel bar icon/text in your action bar.       |
| `fuelBarType`     | Choose between text or bars (icon) to indicate the remaining fuel. |
| `iconFuelBarSize` | For the icon fuel bar, select how many bars are displayed.         |

***

## <mark style="color:orange;">Adding Fuel Items</mark>

{% code title="" %}

```yaml
fuelMaterialValues:
 'OAK_LOG':
  material: 'OAK_LOG'
  fuel-amount: 4
```

{% endcode %}

| Setting       | Info                                                                                                         |
| ------------- | ------------------------------------------------------------------------------------------------------------ |
| `'OAK_LOG'`   | Set a unique name for the fuel.                                                                              |
| `material`    | Select the material/block/item which shall be used to refuel. It must be a valid vanilla Minecraft Material. |
| `fuel-amount` | Set the amount each item should refuel the vehicle for.                                                      |

{% hint style="info" %}
You can add as many or as few items as you'd like to.
{% endhint %}

***

## <mark style="color:orange;">Custom Fuel Item</mark>

{% code title="" %}

```yaml
 'CUSTOM_ITEM_1':
  material: 'PLAYER_HEAD'
  displayName: '&eFuel Can'
  lore:
   - '&7Used to refill vehicles fuel.'
  fuel-amount: 20
  displayNameRequired: true
  loreRequired: true
```

{% endcode %}

| Setting                               | Info                                                                                                                              |
| ------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------- |
| `'CUSTOM_ITEM_1'`                     | Set a unique name for the fuel.                                                                                                   |
| `material`                            | Select the material/block/item which shall be used to refuel.                                                                     |
| `displayName`                         | Set a display name for your item.                                                                                                 |
| `lore`                                | Set an optional lore for your fuel item.                                                                                          |
| `fuel-amount`                         | Set the amount each item should refuel the vehicle for.                                                                           |
| `displayNameRequired`, `loreRequired` | Enable or disable the option for the lore or displayname to be required. If enabled, the item needs to have that exact name/lore. |

### <mark style="color:orange;">Custom Skull Fuel with HDB</mark>

If you are using [*<mark style="color:orange;">HeadDataBase</mark>*](https://www.spigotmc.org/resources/head-database.14280/)*\** and would like to use the same fuel can as in the refuel gui, here is a small tutorial: (This works with every other head too.)

**Step 1:** Setup the fuel in the *Vehicles* config.yml like this.

{% code title="" %}

```yaml
 'CUSTOM_ITEM_1':
  material: 'PLAYER_HEAD'
  displayName: '&aFuel Can'
  lore:
   - '&7Used to refill vehicles fuel.'
  fuel-amount: 50
  displayNameRequired: true
  loreRequired: false
```

{% endcode %}

**Step 2:** In your *HeadDataBase* config.yml find `disabled-heads:`. Add the following head to that list. That head is now no longer buyable through the *HeadDataBase* menu.

{% code title="HeadDataBase - config.yml" %}

```yaml
disabled-heads:
  - "ID:812"
```

{% endcode %}

**Step 3:** In your *HeadDataBase* config.yml find `rename-heads:`. Add the following ID and name. (Make sure that the name of the skull in *Vehicles* and *HeadDataBase* are the same! Including color codes!)

{% code title="HeadDataBase - config.yml" %}

```yaml
rename-heads:
  812: "&aFuel Can"
```

{% endcode %}

**Step 4:** Restart your server, and you will now able to give players the fuel can skull with the following command: `/hdb give 812 <amount> <player>` \
\
\
\&#xNAN;*\* HeadDataBase is not affiliated with Vehicles, the developer or any of our plugins.*


---

# 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.vehiclesplugin.com/configuration/fuel-settings.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.