Marketplace & Listings

/marketplace and the marketplace NPCs let players browse, list, and trade properties.

🧍 Marketplace NPCs

Marketplace NPCs spawn at the locations in Config.MarketPlace.Locations. Interacting with an NPC opens the same marketplace UI as /marketplace, just anchored to that NPC's location.

🪧 Creating a Listing

A property owner can list their property from /housing → property → List:

1. Pick a listing type (sale / rent).

2. Set the price (validated against MarketPlace.Validation.MinPrice and MaxPrice).

3. Add an optional description (capped at MaxDescriptionLength, default 500 chars).

4. Optionally upload a thumbnail and up to MaxGalleryImages gallery images.

5. Confirm - the listing appears on the marketplace and a sale sign appears at the property (see Sale Signs).

Real estate agencies list company-owned properties the same way - see Real Estate Business.

🖼️ Images

When Config.MarketPlace.ImageService.Enable = true, agents can upload images that are served to the gallery UI. With RequireThumbnail = true, a thumbnail is mandatory.

All image and metadata fields are optional by default - players who don't want to upload anything just see a stock thumbnail.

❤️ Favourites

Players can favourite listings from the marketplace. Favourites are stored in rcore_housing_marketplace_favorites and persist between sessions.

⚡ Instant Sell

Config.MarketPlace.InstantSell = {
    Enable     = true,
    Percentage = 50,
}

Instant sell pays the player Percentage % of the listed price and re-lists the property under the "city" owner at full price. When someone buys it back, the resale money is voided.

Use this when you want a quick exit option for players who don't want to wait for a buyer.

✅ Validation

Rule	Default
Minimum price	1000
Maximum price	100,000,000
Maximum description length	500 chars
Phone number required	false
Images required	false

Tighten these in marketplace configuration.