Файл components.yml отвечает за то, как ваша машина выглядит в игре и как игрок с ней взаимодействует. Здесь настраиваются 3D-модели, места для сидения, свет фар и интерфейс багажника.
Модели и визуализация (models)
CoolCars использует систему CustomModelData для отображения 3D-моделей. Вы можете назначить разные модели для кузова, колес и руля.
models:
body-material: IRON_INGOT
body-custom-model-data: 1
# Модель кузова с включенными фарами (опционально)
body-material-headlights: IRON_INGOT
body-material-headlights-custom-model-data: 1
wheel-material: IRON_INGOT
wheel-custom-model-data: 2
steering-wheel-material: IRON_INGOT
steering-wheel-custom-model-data: 3
Смещение элементов (visual)
Чтобы 3D-модели стояли ровно там, где нужно, используются оффсеты (смещения). Координаты указываются относительно центральной точки машины.
- body-offset: Поднимает или опускает кузов. Обычно
y: 1.05 — это стандарт для того, чтобы машина не “тонула” в земле.
- wheel-offsets: Список из 4-х точек для колес.
- steering-wheel-offset: Положение руля. Он будет вращаться при повороте машины.
Схема разметки оффсетов
Для правильной настройки используйте следующую нумерацию точек (вид сверху):
| № | Компонент | Описание |
|---|
| 1 | Корпус | Основная модель машины (body-offset). |
| 2 | Руль | Точка вращения рулевого колеса (steering-wheel-offset). |
| 3 | Переднее левое | Первое колесо в списке wheel-offsets. |
| 4 | Переднее правое | Второе колесо в списке wheel-offsets. |
| 5 | Заднее левое | Третье колесо в списке wheel-offsets. |
| 6 | Заднее правое | Четвертое колесо в списке wheel-offsets. |
Свет фар (lights)
Система освещения в CoolCars позволяет создавать реалистичный свет, который освещает путь перед машиной в ночное время.
lights:
headlight-offsets:
- x: -0.46 # Левая фара
y: 0.78
z: 1.72
- x: 0.46 # Правая фара
y: 0.78
z: 1.72
range: 12.0 # Дальность света (в блоках)
level: 15 # Яркость (0-15)
update-ticks: 2
visible-effects: false
Как работают фары:
- Источник света: Плагин создает невидимые источники света в точках, указанных в
headlight-offsets.
- Смена модели: При включении фар модель кузова может меняться на ту, что указана в
body-material-headlights. Это позволяет сделать эффект “светящихся” текстур фар в вашем ресурспаке.
- Дальность и яркость: Параметр
range определяет, на сколько блоков вперед будет падать свет, а level — насколько ярким он будет (максимум 15).
Если вы хотите, чтобы фары выглядели реалистично, настройте в ресурспаке модель для body-material-headlights с использованием emissive текстур (светящихся в темноте).
Посадочные места (seats)
Секция seats определяет, где будут сидеть игроки.
Первое место в списке всегда считается местом водителя. Только водитель может управлять машиной.
seats:
offsets:
- x: 0.70 # Водитель
y: -0.10
z: 0.45
- x: -0.55 # Пассажир
y: -0.10
z: 0.54
Выхлопная система (exhaust)
Создает частицы дыма из выхлопных труб.
- offsets: Точки появления дыма (можно настроить для каждой трубы отдельно).
- base-count: Количество частиц на холостом ходу.
- max-count: Количество частиц при полном газе.
Когда игрок нажимает кнопку взаимодействия, открывается GUI. Вы можете полностью настроить его внешний вид.
