[ESSENTIALS] Item Vendors

Vendors let you buy and sell game items for coin on your own land, at your own prices, even while you’re offline. There are two: a single item vendor that trades one line, and a multi item vendor that trades up to twenty.

Where the money is

The Marketplace HUB sells to players at about 2× an item’s value and buys from them at about 0.75×, give or take a little from hub to hub.

Everything between those two numbers is yours. Take an item worth 1,000 coin. The market sells it for about 2,000 and buys it for about 750. Sell it from your vendor for 1,500 and buy it from players at 1,000, and you have beaten the market on both sides. Your customers are better off, and you profit either way.

They hold database items, not prims

Never drag anything into a vendor’s Contents. Everything in SL Colonies is a database item, so a vendor is stocked by depositing from your inventory, or by restocking from a storage chest, never by dropping a prim in.

Setting one up

Rez it and it asks whether to create a new vendor or link to an existing one.

  • Create for a brand-new vendor, then give it a name.
  • Link when this prim replaces one you already have. It opens a web page listing your existing vendors of the same size. You can pick your whole sim up, rebuild it and put your vendors back without emptying them.

If you’re not signed in to the website, it sends you a one-time code by IM.

Short click and long click

Short click: View Inventory, Buy, Sell, Deposit, Withdraw.

Long click (hold for about a second, then release) opens the owner menu:

  • Manage Vendor: opens its page on the website.
  • Reset, and Change name. Free text over several lines, so it can read Deer carcasses / Buy 3 / Sell 2.
  • Hover text: on or off, which lines, and the colours.
  • Coin type: which currency it trades in.
  • Security: see below.
  • Set limit: the most of any one item it will take. Set 500 and it stops buying that item once it holds 500. That stops something cheap and easy to make filling your till.

Security

Security decides who can manage a vendor, never who can shop there. Anyone can always buy and sell.

  • Private: only you.
  • Colony: your colony’s leaders and managers can change its prices and stock too. It appears in the Vendors section of your colony page, it restocks only from the colony’s shared storage, and coins taken out on the website go into the colony’s stores.

Managing it on the website

Go to Your vendors and press Manage, or long-click the vendor and choose Manage Vendor.

  • Add a line from any item in the game. A single vendor takes one line and a multi vendor up to twenty.
  • Price it against the market. Every line shows what the market is asking and paying right now. Ask less than the market’s lowest asking price and pay more than its highest buying price, and both turn green.
  • Never pay more than you ask. If you do, a player can buy from you and sell straight back at a profit. The page warns you, and nobody can sell that line back to you, here or in-world.
  • Sell only or buy only, for one line or the whole shop.
  • Show or hide the shop’s name on the market’s lists.

The till

A vendor can only buy from players if it has coins. Put coins in from its page, and take them out whenever you like. The page shows what you’ve taken in sales, paid out to players, put in and taken out.

Your Vendors page also totals trades, coins in, coins out and your net across every vendor that’s checking in.

Stocking from storage

Link a line to a storage chest you own, or to one of the colony’s chests for a Colony vendor. Then set:

  • keep back: how much must always stay in the chest;
  • target: how many the vendor should hold.

When the line runs low, press Restock. It tops the line back up to the target, never drawing the chest below its keep-back amount. Restocking is deliberately a press, not automatic, so you stay in control of your stores.

How shoppers trade

  • Single item vendor: touch it and buy or sell right there in-world.
  • Multi item vendor: touch it, pick Buy or Sell, and a trading window opens on the website with that side ready. The trade only completes while the shopper is standing within 20 metres of the vendor, and the vendor confirms it in-world.

Decimal prices

Prices can take decimals, down to 0.001. A buyer pays the total rounded up to a whole coin. A seller needs to bring enough to earn a whole coin: at half a coin each, one item earns nothing and two earn one.

As a bureau de change

Set the coin type to any currency and a vendor becomes an exchange. Two neighbouring regions with their own minted coins can post rates at each other.

Keeping it up to date

Vendors check in with the website every hour. One that hasn’t checked in for about two and a half hours shows as Frozen: you can see what it holds, but you can’t change it until it checks in again. Resetting its scripts brings it back within a minute.

A vendor on older scripts shows as Needs updating. It still trades in-world, but it’s read-only on the website and doesn’t appear on the market. Update it with the updater box from our in-world store.

Retiring a vendor

A frozen or not-yet-updated vendor can be retired from the bottom of its page. Its goods come back to your inventory and its coins to your purse. A Colony vendor’s go to a colony chest instead. The vendor is then removed.

Making it fit

Stretch the vendor over your goods and set its texture to 100% transparent, and customers click your table. Or link it to your own mesh, but the vendor must be the master prim: select your mesh first and the vendor last, then link.

The product pages: