Koja Scripts
FREE

Exchange

The exchange is the player-or-server-owned tier above zones.

Exchange

The exchange is the player-or-server-owned tier above zones. A player can own an entire zone, set their own listing fee, and earn commission on every sale that happens in their zone.

Settings

shared/config.lua
Config.Exchange = {
    ZonePurchasePrice = 250000,           -- one-time price to own an entire zone
    DefaultListingFeePerWeek = 500,       -- per-listing weekly fee (sellers pay zone owner)
    DefaultCommissionPercent = 5,         -- cut taken from each sale
    MaxListingsPerZone = 50,
}
FieldDefaultPurpose
ZonePurchasePrice250000One-time bank cost to claim a whole zone
DefaultListingFeePerWeek500What each seller pays the zone owner per active listing per week
DefaultCommissionPercent5Cut of each completed sale paid to the zone owner
MaxListingsPerZone50Hard cap on simultaneous active listings per zone

How money flows

When player B buys a vehicle from player A in a zone owned by player Z for $100,000:

B pays           → 100,000
Z (zone owner)   ← 5,000   (5% commission)
A (seller)       ← 95,000

If a zone has no owner, the seller gets the full price.

Player-set overrides

Once a player owns a zone, they can override the defaults from the Exchange owner panel in the tablet UI:

  • Listing fee per week
  • Max listings
  • Commission %

These overrides are persisted in koja_carmarket_exchange.

Listing fee flow

Same cadence as parking: every minute the server checks listing_fee_paid_until < NOW():

  1. Fee due → remove from seller's bank → credit to zone owner (minus commission %).
  2. Failure → listing deleted from the market.

Zone owners listing their own vehicles skip the fee.

  • Custom Vehicle Images — By default the tablet UI fetches vehicle images from https://docs.fivem.net/vehicles/.webp — that covers every stock GTA V vehicle, but not modded cars on your server.
  • Parking — Players can buy individual market slots within zones, pay weekly rent, and park their listed vehicles there.
  • Overview — All tunable settings live in shared/config.lua.
  • Test Drive — Buyers can take a listed vehicle for a spin before committing to a purchase.
  • Configuration — back to the section overview