Skip to main content
The items.yml file allows you to customize the items players use to interact with vehicles. You can change their appearance, name, and effectiveness.

​
Fuel Canister (fuel.canister)

Canisters are used to refuel vehicles. You can create multiple types of canisters with different capacities. 
fuel:
  canister:
    material: HONEY_BOTTLE
    capacity-liters: 10.0
    custom-model-data: 1
    display-name: "&6Fuel Canister &7({liters}/{capacity}L)"

​
Key Parameters:

  • material: The Minecraft item type.
  • capacity-liters: How many liters of fuel the canister holds.
  • unbreakable: If true, the item will not lose durability (if it’s a tool).
Use the {liters} and {capacity} placeholders in the name or lore so players can see the current fuel level in the canister.

​
Repair Kit (repair.kit)

Repair kits allow players to fix damaged car parts or restore core health. 
repair:
  rate-units-per-tick: 0.08    # Repair speed
  kit:
    material: RABBIT_HIDE
    max-units: 10.0            # Repair kit "durability"
  • rate-units-per-tick: Determines how quickly the repair kit is consumed while holding the repair button.
  • max-units: Total repair units in a single item.

​
Item Localization

You can configure the display name and lore for each item based on the player’s language. 
localization:
  en:
    display-name: "&bRepair Kit &7({units}/{capacity})"
    lore:
      - "&7Kit units: &f{units}&7/&f{capacity}"
  ru:
    display-name: "&bРемкомплект &7({units}/{capacity})"
    lore:
      - "&7Единицы: &f{units}&7/&f{capacity}"

​
NBT Tags

You can add custom NBT tags to items. This is useful for integration with other plugins or for creating unique items via custom crafting plugins. 
nbt-tags:
  "my_server:rarity": "epic"
  "cars:repair_item": true