Fuel

Everything you need to know about how the fuel system works and how to set it up.

Do not reload the plugin or the server to put these changes into effect. Restart the server.
Information
The default fuel items can be found in the config.yml. Some examples are: Wood items, coal, wool items, lava buckets, wheat, etc... 
To refuel your vehicle open the fuel gui (controls), and drag the items onto the fuel bucket.
General Fuel Settings
fuelEnabled: true
fuelBarEnabled: true
#1: Text, 2: Icon
fuelBarType: 2
iconFuelBarSize: 30
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.
Adding Fuel Items
fuelMaterialValues:
 'OAK_LOG':
  material: 'OAK_LOG'
  fuel-amount: 4
Setting                                                                          
Info
'OAK_LOG'
Set a unique name for the fuel.
material
Select the material/block/item which shall be used to refuel.
fuel-amount
Set the amount each item should refuel the vehicle for.
​
You can add as many or as few items as you'd like to.
Custom Fuel Item
 'CUSTOM_ITEM_1':
  material: 'PLAYER_HEAD'
  displayName: '&eFuel Can'
  lore:
   - '&7Used to refill vehicles fuel.'
  fuel-amount: 20
  displayNameRequired: true
  loreRequired: true
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.
Custom Skull Fuel with HDB
If you are using HeadDataBase* 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.
 'CUSTOM_ITEM_1':
  material: 'PLAYER_HEAD'
  displayName: '&aFuel Can'
  lore:
   - '&7Used to refill vehicles fuel.'
  fuel-amount: 50
  displayNameRequired: true
  loreRequired: false
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.
HeadDataBase - config.yml
disabled-heads:
  - "ID:812"
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!)
HeadDataBase - config.yml
rename-heads:
  812: "&aFuel Can"
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> 


* HeadDataBase is not affiliated with Vehicles, the developer or any of our plugins.

Shop

General Settings

Last modified 8mo ago

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.

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

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.