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

> Настройка канистр с топливом, ремкомплектов и других игровых предметов.

Файл `items.yml` позволяет вам кастомизировать предметы, которые игроки используют для взаимодействия с машинами. Вы можете изменить их внешний вид, название и эффективность.

## Канистра с топливом (`fuel.canister`)

Канистра используется для заправки машин. Вы можете создать несколько типов канистр с разным объемом.

```yaml theme={null}
fuel:
  canister:
    material: HONEY_BOTTLE
    capacity-liters: 10.0
    custom-model-data: 1
    display-name: "&6Канистра с топливом &7({liters}/{capacity}L)"
```

### Основные параметры:

* **material**: Тип предмета в Minecraft.
* **capacity-liters**: Сколько литров топлива вмещает канистра.
* **unbreakable**: Если `true`, предмет не будет тратить прочность (если это инструмент).

<Tip>
  Используйте плейсхолдеры `{liters}` и `{capacity}` в названии или описании, чтобы игрок видел текущий уровень топлива в канистре.
</Tip>

***

## Ремкомплект (`repair.kit`)

Ремкомплект позволяет игрокам чинить поврежденные части машины или восстанавливать общее здоровье.

```yaml theme={null}
repair:
  rate-units-per-tick: 0.08    # Скорость ремонта
  kit:
    material: RABBIT_HIDE
    max-units: 10.0            # Запас "прочности" ремкомплекта
```

* **rate-units-per-tick**: Определяет, как быстро расходуется ремкомплект при зажатой кнопке ремонта.
* **max-units**: Общий запас единиц ремонта в одном предмете.

***

## Локализация предметов

Для каждого предмета можно настроить перевод названия и описания (lore), который будет зависеть от языка игрока.

```yaml theme={null}
localization:
  ru:
    display-name: "&bРемкомплект &7({units}/{capacity})"
    lore:
      - "&7Единицы: &f{units}&7/&f{capacity}"
  en:
    display-name: "&bRepair Kit &7({units}/{capacity})"
    lore:
      - "&7Kit units: &f{units}&7/&f{capacity}"
```

<Frame caption="Пример отображения канистры и ремкомплекта в инвентаре">
  <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 Теги

Вы можете добавить произвольные NBT-теги к предметам. Это полезно для интеграции с другими плагинами или для создания уникальных предметов через плагины на кастомные крафты.

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