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

## How to become a zone owner

:::steps
### Approach the zone NPC

Use any of the configured `Config.Zones` locations.


### Open the tablet → "Exchange owner"

If the zone has no owner, you'll see a **Buy entire zone** action.


### Pay `Config.Exchange.ZonePurchasePrice`

Default: `250,000` from your bank. The transaction is atomic — money is only deducted if the insert into `koja_carmarket_exchange` succeeds.


### Tweak settings to taste

Once you own it, the **Exchange owner panel** lets you set:

* **Max listings** — how many sellers can list at once
* **Listing fee per week** — what sellers pay you per active listing
* **Commission %** — your cut on every sale
:::

## What you earn

Every time **any** vehicle in your zone sells:

```
buyer pays $100,000
├─ commission to you  → $5,000  (if commission_percent = 5)
└─ remainder to seller → $95,000
```

Every active listing, every 7 days:

```
seller pays $500     → you receive $500 (minus any commission cut)
```

:::hint{type="info"}
If **you** list a car in **your own** zone, the weekly listing fee is **skipped** — you don't pay yourself.
:::

## Settings persistence

| Setting          | Where it lives                                 |
| ---------------- | ---------------------------------------------- |
| Owner identifier | `koja_carmarket_exchange.owner_identifier`     |
| Listing fee      | `koja_carmarket_exchange.listing_fee_per_week` |
| Max listings     | `koja_carmarket_exchange.max_listings`         |
| Commission       | `koja_carmarket_exchange.commission_percent`   |

Defaults come from `Config.Exchange` until a player buys the zone, then their settings persist independently.

## Selling a zone

Currently **not implemented** — once you own a zone, ownership is permanent until a server admin runs SQL to release it:

```sql
UPDATE koja_carmarket_exchange SET owner_identifier = NULL WHERE zone_id = 'zone1';
```

This is on the roadmap for a future version (auction-style transfer).

## Related pages

- [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.
- [Parking Slots](/free/carmarket/features/parking-slots) — Before a player can list a car, they need at least one parking slot in the zone they want to list in.
- [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