Items (items.yml)

Configuration for fuel canisters, repair kits, and other in-game items.

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}"

Example of canister and repair kit in inventory

---

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