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). The vehicle store then lists every model the dealership sells.

Vehicles missing from the player's game files are hidden from the list automatically.

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

📦 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 for the pickup flow.