# Parking Slots

Before a player can list a car, they need at least **one parking slot** in the zone they want to list in. Slots are individual boxes within `Config.Zones[X].CarMarketBoxes`.

***

## Buying a slot

::::steps
### Open the tablet → "My cars"

The page shows all zones with their slot grids.


### Click an empty slot

Empty slots are highlighted. You'll see a confirmation modal with the price and weekly fee.


### Confirm purchase

`Config.Parking.SlotPrice` is removed from your bank, and you now own that slot.

:::hint{type="info"}
If a zone owner exists, **they receive the slot purchase money**. Otherwise it's just deducted (server keeps it).
:::
::::

***

## Using a slot

Once owned, the slot shows as **Free** until you list a car into it. Through the **Sell car** flow, the system auto-picks the closest free slot you own in the target zone.

You can also **move** a parked vehicle to a different slot via **My cars → click occupied slot → Move**.

***

## Weekly fees

Every 7 days, `Config.Parking.SlotWeeklyFee` is deducted from your bank.

| Outcome  | What happens                                                     |
| -------- | ---------------------------------------------------------------- |
| ✅ Paid   | `next_payment_at` rolls forward 7 days                           |
| ❌ Unpaid | Slot is freed, listing in it (if any) is removed from the market |

:::hint{type="warning"}
Auto-eviction is **silent**. The player won't get a popup — only a tablet refresh will show their car is gone. Consider hooking into `koja_carmarket:client:vehicleSold` to notify the original owner.
:::

***

## Slot states (UI)

| State            | Color  | Meaning                                |
| ---------------- | ------ | -------------------------------------- |
| `not_purchased`  | grey   | Available to buy                       |
| `owned_by_other` | red    | Another player owns this slot          |
| `free`           | green  | You own it; assign a vehicle           |
| `occupied`       | blue   | You own it; a vehicle is parked here   |
| `expired`        | yellow | Fee unpaid; slot will be freed shortly |

## Related pages

- [Exchange Zones](/free/carmarket/features/exchange-zones) — A player can own an entire zone and run it like a small business: set listing fees, take commission on every sale, cap how many listings can run concurrently.
- [Auctions](/free/carmarket/features/auctions) — Time-boxed bidding with a clear winner and a buy-out finalization step.
- [Overview](/free/carmarket/features/overview) — What players can actually do with Koja-Carmarket, from their POV.
- [Listings](/free/carmarket/features/listings) — The simplest flow: a player lists a vehicle from their garage at a fixed price; another player walks up to the market zone, opens the tablet, and buys it.
- [Test Drives](/free/carmarket/features/test-drives) — Let a buyer try the vehicle before they commit.
- [Features](/free/carmarket/features) — back to the section overview