> 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/configuration/dealership.md).

# Dealership

Edit `rcore_dealership/configs/config.dealership.lua` for how players interact with dealerships and how they pay for vehicles.

## 🎯 Interaction Points

`Config.Dealership.Points` defines how players open the dealership and the business management laptop.

| Point      | Type   | Default             | Purpose                                          |
| ---------- | ------ | ------------------- | ------------------------------------------------ |
| `open`     | NPC    | `ig_siemonyetarian` | The salesperson players talk to.                 |
| `business` | Object | `prop_laptop_jimmy` | The laptop used to manage a business dealership. |

Each point has an `icon`, `model`, and `distance`. A marker-based variant of the `open` point is included as a commented-out alternative.

## 📍 Marker

`Config.Dealership.Marker` controls the world marker used for stock deliveries, test-drive returns, and repo deliveries.

| Option         | Default                   | Description                                                          |
| -------------- | ------------------------- | -------------------------------------------------------------------- |
| `Enabled`      | `true`                    | Whether the marker draws.                                            |
| `Type`         | `1`                       | [Marker type](https://docs.fivem.net/docs/game-references/markers/). |
| `Scale`        | `vector3(5.0, 5.0, 1.0)`  | Marker size.                                                         |
| `Color`        | `{r=255,g=200,b=0,a=230}` | RGBA color.                                                          |
| `ZOffset`      | `-0.97`                   | Vertical offset so the base sits on the ground.                      |
| `DrawDistance` | `50.0`                    | Stop rendering beyond this distance.                                 |

## 💰 Purchase Accounts

`Config.Dealership.Purchase` sets which accounts money moves through.

| Option        | Default | Description                                                                     |
| ------------- | ------- | ------------------------------------------------------------------------------- |
| `CashAccount` | `money` | Cash account (ESX `money`, QBCore `cash`). Used for cash and trade-in payments. |
| `BankAccount` | `bank`  | Bank account. Used for bank payments, financing, and all business operations.   |

## 🔢 Custom Plate

`Config.Dealership.Purchase.CustomPlate` controls paid custom plates.

| Option      | Default | Description             |
| ----------- | ------- | ----------------------- |
| `Price`     | `5000`  | Cost of a custom plate. |
| `MinLength` | `3`     | Minimum plate length.   |
| `MaxLength` | `8`     | Maximum plate length.   |

## 🏦 Financing

`Config.Dealership.Purchase.Finance` controls vehicle loans.

| Option                    | Default         | Description                                        |
| ------------------------- | --------------- | -------------------------------------------------- |
| `InterestRate`            | `0.15`          | Interest added to the financed amount (15%).       |
| `DownPaymentPercent`      | `0.20`          | Down payment required up front (20%).              |
| `PaymentIntervalDays`     | `7`             | Days between installments.                         |
| `MaxMissedPayments`       | `3`             | Missed payments before the vehicle is repossessed. |
| `LatePenaltyPercent`      | `0.10`          | Penalty added to a missed installment (10%).       |
| `CollectionCheckInterval` | `60`            | Seconds between payment checks.                    |
| `TermWeeks`               | `Min 3, Max 12` | Loan term in weekly installments (default 12).     |

## 🔄 Trade-In

`Config.Dealership.Purchase.TradeIn` controls trading an owned vehicle toward a purchase.

| Option          | Default | Description                                                                                          |
| --------------- | ------- | ---------------------------------------------------------------------------------------------------- |
| `Depreciation`  | `0.30`  | Value lost on trade-in - the player gets 70% of market price.                                        |
| `PayoutSurplus` | `true`  | If the trade-in is worth more than the new car, pay the difference. Set `false` to void the surplus. |

## 📦 Orders

`Config.Dealership.Purchase.Order` controls cash orders for vehicles a business dealership doesn't have in stock.

| Option               | Default | Description                                                                     |
| -------------------- | ------- | ------------------------------------------------------------------------------- |
| `DownPaymentPercent` | `0.35`  | Down payment charged now; the rest is paid on pickup. Only affects cash orders. |