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

# Getting Started

> Step-by-step guide to creating your first vehicle model in CoolCars.

Creating a custom vehicle in CoolCars is a creative process that combines 3D model configuration (via Resource Pack) and fine-tuning physics in configuration files.

## Vehicle Folder Structure

Each car is a separate folder inside `plugins/CoolCars/cars/`. The name of this folder will be the **model identifier (key)**.

For example, if you create a folder named `my_super_car`, the spawn command will be:
`/car spawn my_super_car`

### Required Files

Inside each car folder, there must be four configuration files:

<CardGroup cols={2}>
  <Card title="components.yml" icon="puzzle-piece">
    Visuals: models, seats, lights, trunk, and menu.
  </Card>

  <Card title="performance.yml" icon="gauge-high">
    Physics: speed, acceleration, suspension, and fuel consumption.
  </Card>

  <Card title="behavior.yml" icon="shield-check">
    Behavior: durability, collisions, landing damage, and combat.
  </Card>

  <Card title="localization.yml" icon="language">
    Texts: names and descriptions in different languages.
  </Card>
</CardGroup>

***

## Quick Start: The Copy Method

The easiest way to create a new car is to use the existing `Volga` as a template.

1. **Copy** the `plugins/CoolCars/cars/Volga` folder.
2. **Rename** the copy (e.g., to `Lada`).
3. **Change** the `display-name` in `localization.yml`.
4. **Reload** the plugin with `/car reload`.
5. **Spawn** your new car: `/car spawn Lada`.

<Info>
  Even if you haven't set up your Resource Pack yet, the car will appear using default models (e.g., iron ingots), but the physics and functions will already work.
</Info>

## Visual Setup Process

The configuration process usually looks like this:

1. **Model Setup:** You specify `CustomModelData` for items in `components.yml`.
2. **Offset Adjustment:** You adjust the positions of wheels, steering wheel, and seats to fit your 3D model.
3. **Physics Testing:** You adjust mass and engine power in `performance.yml` to make the car feel right.

<Frame caption="Example of real-time offset adjustment process">
  <img src="https://mintcdn.com/coolcars/QY_WTQ6VIv0J3pk1/images/coolcars/setup-process.png?fit=max&auto=format&n=QY_WTQ6VIv0J3pk1&q=85&s=61a29560eb9bf40dd7db80f51edcd9cd" width="1318" height="735" data-path="images/coolcars/setup-process.png" />
</Frame>

***

## What's Next?

Now that you understand the general structure, let's move on to the detailed configuration of each file:

<CardGroup cols={2}>
  <Card title="Component Setup" icon="object-group" href="/en/creating-a-car/components">
    Learn how to place wheels and configure the menu.
  </Card>

  <Card title="Physics Setup" icon="bolt" href="/en/creating-a-car/performance">
    Make your car fast or heavy.
  </Card>
</CardGroup>