Koja Scripts
FREE

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.

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

  1. Approach the zone NPC

    Use any of the configured Config.Zones locations.

  2. Open the tablet → "Exchange owner"

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

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

  4. 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)

Settings persistence

SettingWhere it lives
Owner identifierkoja_carmarket_exchange.owner_identifier
Listing feekoja_carmarket_exchange.listing_fee_per_week
Max listingskoja_carmarket_exchange.max_listings
Commissionkoja_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:

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

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

  • Auctions — Time-boxed bidding with a clear winner and a buy-out finalization step.
  • Overview — What players can actually do with Koja-Carmarket, from their POV.
  • 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 — 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 — Let a buyer try the vehicle before they commit.
  • Features — back to the section overview