> ## Documentation Index
> Fetch the complete documentation index at: https://coolcars.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 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.

```yaml theme={null}
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).

<Tip>
  Use the `{liters}` and `{capacity}` placeholders in the name or lore so players can see the current fuel level in the canister.
</Tip>

***

## Repair Kit (`repair.kit`)

Repair kits allow players to fix damaged car parts or restore core health.

```yaml theme={null}
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.

```yaml theme={null}
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}"
```

<Frame caption="Example of canister and repair kit in inventory">
  <img src="https://mintcdn.com/coolcars/QoXtKOorMvt8sk6O/images/coolcars/items-preview.png?fit=max&auto=format&n=QoXtKOorMvt8sk6O&q=85&s=bc57e04e5f6df20cae37dff72f62c915" width="1139" height="192" data-path="images/coolcars/items-preview.png" />
</Frame>

***

## 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.

```yaml theme={null}
nbt-tags:
  "my_server:rarity": "epic"
  "cars:repair_item": true
```