For the complete documentation index, see llms.txt. This page is also available as Markdown.

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.


Selling

1

Open the tablet at a market zone

Walk up to the NPC at any Config.Zones entry and interact (ox_target or E by default).

2

Go to "Sell car"

The page shows your garage on the right. Vehicles already on the market are filtered out.

3

Pick a car & fill the form

  • Car name β€” defaults to the model name, but you can rename for vanity (e.g. "Garage Queen β€” Low Miles").

  • Price β€” what you're asking. For auctions this is the minimum opening bid.

  • Description β€” free text shown on the listing.

  • Offer type β€” Buy now or Auction.

4

(Auction only) Set start & end dates

Use the custom date-time picker. Auctions go through three states:

  • Waiting β€” between create-time and auction_starts_at. No bids accepted.

  • Active β€” between start and end. Players can bid; price equals the highest bid.

  • Ended β€” past auction_ends_at. Winner clicks Buy out to finalize.

5

Click "Create listing"

The car is moved to a slot inside a zone you own. If you own multiple slots, the closest free slot to your current position wins.


Buying

  • Open the tablet at any zone β†’ Market tab.

  • Filter by car type, drive type, fuel type, price range.

  • Click a listing β†’ review details β†’ Buy Vehicle.

The vehicle is transferred to your garage; money is moved atomically with rollback if anything fails partway through.

For buy-now listings, the price is what the seller set. For ended auctions, only the highest bidder can buy out.


Editing your listing

In My offers you can:

  • Update the price

  • Update the tags

  • Remove the listing (refunds the slot weekly-fee for the unused time? β€” no, fees are non-refundable)


What gets persisted

Data
Table

The listing

koja_carmarket_listings

The spawned vehicle's slot

koja_carmarket

Completed sale (audit)

koja_carmarket_history

Last updated