> For the complete documentation index, see [llms.txt](https://documentation.rcore.cz/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://documentation.rcore.cz/paid-resources/rcore_dealership/features/buying-a-vehicle.md).

# Buying a Vehicle

Buying a vehicle is the core dealership experience: a player walks up to a dealership, browses the catalog, configures a vehicle, and pays.

## 🛒 The Catalog

Players open a dealership through its interaction point - an NPC salesperson, a prop, a marker, or a target zone (configurable in the [Dealership config](/paid-resources/rcore_dealership/configuration/dealership.md)). The vehicle store then lists every model the dealership sells.

{% hint style="info" %}
Vehicles missing from the player's game files are hidden from the list automatically.
{% endhint %}

## 🎨 The Configurator

After picking a vehicle, the player enters the configurator to customize it:

* **Paint** - primary, secondary, pearl, and wheel colors, or custom RGB.
* **Wheels** - 12 wheel categories.
* **Parts** - spoiler, bumpers, and exhaust.
* **Custom plate** - an optional personalized plate.

Each option adds to the price. See the [Vehicle Mods config](/paid-resources/rcore_dealership/configuration/mods.md) for the full pricing reference.

## 💳 Payment Methods

| Method      | How it works                                                                                                                                             |
| ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Cash / Bank | Pay the full price up front.                                                                                                                             |
| Finance     | Pay a down payment, then weekly installments with interest. See [Financing](/paid-resources/rcore_dealership/features/financing-and-customer-tablet.md). |
| Trade-in    | Hand in an owned vehicle for credit toward the new one.                                                                                                  |

The final price is the base price plus any mods and custom plate.

## 🔄 Trade-In Rules

* Trade-in value is the vehicle's market price minus depreciation (30% by default), so the player receives 70%.
* A vehicle that is still being financed cannot be traded in.
* If the trade-in is worth more than the new car, the surplus is paid out only when `PayoutSurplus` is enabled.

Tune all of these values in the [Dealership config](/paid-resources/rcore_dealership/configuration/dealership.md).

## 📦 Business Dealerships

At a player-owned business dealership, a purchase consumes a matching stock item and creates an **order** that the player picks up later. See [NPC Orders](/paid-resources/rcore_dealership/features/npc-orders.md) for the pickup flow.