Real estate

Guide for the staff tablet (agents / housing staff). Players use the Market when marketAccess is "public".

• 1. Configure access
• 2. Open the staff tablet
• 3. Browse and manage a property
• 4. Create a shell property
• 5. Create an IPL interior property
• 5. Money rules
• Related guides

1. Configure access

Set who may open the staff panel and the public market:

Config.HousingStaff = {
    mode = "both", -- "both" | "job" | "admin"
    jobs = {
        { job = "realestate", grade = 0, duty = true },
    },
}

Config.RealEstate.marketAccess = "public" -- or "realtor"

marketAccess	Who can open the market
realtor	Housing staff only
public	Anyone (command / export / optional item)

Grade permissions live in Config.RealEstate.grades: viewListings, viewPropertyDetail, listForSale, sellProperty, removeOwner, assignOwner, manageRent, manageAuctions, editListingMedia, createShellProperty, createShellPack, editShellPack, or all = true.

2. Open the staff tablet

1. Create / give the item from Config.RealEstate.item (default realtor_tablet), or enable the radial (Config.RealEstate.radial), or set openCommand.
2. Go on duty with a configured job (if duty = true), or use admin when mode allows it.
3. Use the item / radial / command → panel opens on Properties.

3. Browse and manage a property

1. On Properties, filter by status, type, zone, or search name.
2. Open a card → property profile (photos, owner, keyholders, rent, listing state).
3. From the side panel, run grade-gated actions:
   • List for sale / rent / auction
   • Sell to State ID / assign owner / remove owner
   • Edit photos (banner + gallery URLs, max maxImages)
   • Set waypoint / edit shell (shells only)

4. Create a shell property

1. Open the Shells tab (needs createShellProperty / pack perms).
2. Follow Creating properties — Shell.
3. If Preview drops you into the void, you do not have that default or custom shell resource. The catalog is still supported if you buy it later. We do not provide support for installing those resources.

5. Create an IPL interior property

1. Open the Interiors tab (same createShellProperty permission).
2. Pick an interior and optional theme.
3. Follow Creating properties — IPL.
4. Packs / themes: IPL interiors. If Preview drops you into the void, you do not have that default or custom shell resource — the catalog is still supported if you buy it later. We do not provide support for installing those resources.

5. Money rules

All sales, rent, deposits, and commissions use bank via prp-bridge.

Config	Role
commissionPercent	Agent cut on mediated sales
vacantProceeds	"none" sinks vacant-sale remainder (commission still paid when possible)
bidDepositPercent	Default deposit for offers / auctions
maxImages	Max gallery URLs (default 10)

Related guides

1. Market — player browse / buy
2. Rent — list, pay, evict
3. Auctions & offers — deposits and timers
4. Exports — phone apps