The components.yml file is responsible for how your car looks in-game and how players interact with it. This is where you configure 3D models, seating positions, headlights, and the trunk interface.
Models and Visualization (models)
CoolCars uses the CustomModelData system to display 3D models. You can assign different models for the body, wheels, and steering wheel.
models:
body-material: IRON_INGOT
body-custom-model-data: 1
# Body model with headlights on (optional)
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
Element Offsets (visual)
To ensure 3D models are positioned exactly where they need to be, offsets are used. Coordinates are specified relative to the car’s center point.
- body-offset: Raises or lowers the body. Usually
y: 1.05 is standard to prevent the car from “sinking” into the ground.
- wheel-offsets: A list of 4 points for the wheels.
- steering-wheel-offset: Steering wheel position. It will rotate as the car turns.
Offset Layout Diagram
For correct configuration, use the following point numbering (top view):
| # | Component | Description |
|---|
| 1 | Body | The main car model (body-offset). |
| 2 | Steering Wheel | The rotation point of the steering wheel (steering-wheel-offset). |
| 3 | Front-Left | The first wheel in the wheel-offsets list. |
| 4 | Front-Right | The second wheel in the wheel-offsets list. |
| 5 | Rear-Left | The third wheel in the wheel-offsets list. |
| 6 | Rear-Right | The fourth wheel in the wheel-offsets list. |
Headlights (lights)
The lighting system in CoolCars allows you to create realistic light that illuminates the path in front of the car at night.
lights:
headlight-offsets:
- x: -0.46 # Left headlight
y: 0.78
z: 1.72
- x: 0.46 # Right headlight
y: 0.78
z: 1.72
range: 12.0 # Light range (in blocks)
level: 15 # Brightness (0-15)
update-ticks: 2
visible-effects: false
How Headlights Work:
- Light Source: The plugin creates invisible light sources at the points specified in
headlight-offsets.
- Model Swap: When headlights are turned on, the body model can change to the one specified in
body-material-headlights. This allows for “glowing” headlight textures in your resource pack.
- Range and Brightness: The
range parameter determines how many blocks forward the light will fall, and level determines how bright it will be (maximum 15).
If you want the headlights to look realistic, set up a model for body-material-headlights in your resource pack using emissive textures (glowing in the dark).
Seating Positions (seats)
The seats section defines where players will sit.
The first seat in the list is always considered the driver’s seat. Only the driver can control the car.
seats:
offsets:
- x: 0.70 # Driver
y: -0.10
z: 0.45
- x: -0.55 # Passenger
y: -0.10
z: 0.54
Exhaust System (exhaust)
Creates smoke particles from the exhaust pipes.
- offsets: Points where smoke appears (can be configured for each pipe separately).
- base-count: Number of particles at idle.
- max-count: Number of particles at full throttle.
When a player presses the interaction key, a GUI opens. You can fully customize its appearance.
