Migrating to Plurion

Watch first changes nothing in your shop. Plurion only reads your sales, so you can try the dashboard on your real numbers. Full migration also converts your vendors. No other system yet? See Start here. Only the shop’s owner and its admins see Migrate.

#Three questions, then your plan

The first time you open Migrate, it asks three questions. Your answers decide which cards appear on your plan:

• What you sell with today. Tick every system you use: CasperVend, MD Vendor, Allomancy, Other vendors.
• Whether you also sell on the SL Marketplace: Yes or No.
• Your goal: Watch first, Full migration or Not sure yet (starts as Watch first).

Then Your migration plan lists your steps in the recommended order. You can open any card at any time. Adjust profile reopens the questions, and How it works sums up each step.

Which cards appear, and when

Card	Appears if you answered
Connect CasperVend	CasperVend
Import your history	CasperVend, MD Vendor or Allomancy
Connect Marketplace	Yes, you sell on the Marketplace
Sync your catalog	CasperVend, MD Vendor or Allomancy
Convert your vendors	Full migration, or only Other vendors

The cards your answers left out wait, folded, under More steps.

#What you can undo, and what you can’t

Four cards out of five only add information to Plurion, and your current system keeps working. Converting your vendors is the exception. It happens in-world, and it’s final.

#Connect CasperVend (live feed)

Only CasperVend sends Plurion each sale as it happens. For MD Vendor and Allomancy, import a newer export to catch up. The Webhook Salt that CasperVend gives you lets Plurion check that each sale really comes from CasperVend.

1. On the webCopy Plurion’s addressOn your plan, open Connect CasperVend. Under Paste this URL into My Casper, click Copy.
2. On the webPaste it into My CasperIn My Casper, open the Overview tab → Webhooks. Paste the address, tick Product purchase and SL Marketplace purchase, and save.
3. On the webBring the salt backMy Casper then shows a Webhook Salt. Copy it, paste it under Paste back the Webhook Salt and click Save.

Mirrored sales are records only. CasperVend still delivers the item, and Plurion delivers nothing and takes no commission on them.

#Import your history

One CSV export brings years of sales, and the customers behind them, into Plurion. Plurion recognizes CasperVend, MD Vendor and Allomancy exports on its own. Imported sales are history, and Plurion delivers nothing for them. Keep the file as a backup.

1. On the webOpen the cardOn your plan, open Import your history.
2. On the webChoose your fileClick Choose CSV file. Plurion shows the format it detected and four counts: Ready, Skipped, Date range, Total paid.
3. On the webImportIf the dates and the total look right, click Import … sales and wait for Import complete.

If something’s off

• Unrecognized CSV format… → the file isn’t a sales export from one of those three systems. Export the sales report again.
• Lines counted as Skipped → open Why some lines were skipped, under the counts, to see why.
• More sales since? Import a newer export. Sales already in Plurion are skipped.

#Connect the Marketplace (optional)

If you also sell on the SL Marketplace, Linden Lab can tell Plurion about each Marketplace sale directly.

1. On the webCopy Plurion’s addressOpen Connect Marketplace. Under Paste this URL into Automatic Notifications (ANS), click Copy.
2. On the webPaste it on the MarketplaceOn the SL Marketplace, open My merchant home → Automatic Notifications (ANS) and click Edit. Replace the address there with Plurion’s, and save.
3. On the webBring the salt backThe Marketplace then shows the Notification salt under the address. Copy it, paste it under Paste back the salt LL gives you and click Save.

Several brands on one Marketplace store

Once the feed is connected, Advanced settings appears at the bottom of the step. If your account owns other shops, Multi-shop routing (Marketplace) sends each Marketplace sale to the right shop by a keyword in the listing title, in the order you set. A sale that matches no rule stays on this shop.

Set the rules on the shop that holds the Marketplace connection, since a rule saved on another shop never fires. Rules apply to new sales only.

The same panel is where you declare co-creator shares on your listings, under Marketplace co-creators. See Marketplace sales in Splits.

#Sync your catalog

Syncing links each product name from your imported sales to a product in your catalog. That lets past buyers redeliver, your updates reach them, and the migration kit recognize your vendors.

1. On the webLet auto-sync do most of the workOpen Sync your catalog. When the Auto-sync matched products banner appears, click Review & sync. It lists the products Plurion can create: imported names that exactly match an item in your DropBoxes and sold above L$0.
2. On the webCheck, then syncUntick anything that looks wrong and click Sync the … kept. Each product takes the price of your most recent sale of that item. If that sale was discounted, fix the price in Products.
3. On the webLink the rest by handClick a remaining name, then either Create new Plurion product and Sync to Plurion, or Match to existing, pick a product and Map to selected. For a name you no longer sell, click Mark as no longer sold.

To fix a wrong link, open the name and click Reset mapping. Synced names are remembered for later imports. If you’re not ready, Skip for now on the card lets you move on.

#Convert your vendors

The migration kit turns each existing vendor into a Plurion vendor where it stands. The object, its place and its picture stay, and there’s nothing to re-rez. You drop the kit on each vendor in turn, and each one takes about 30 seconds.

Rez it from your Starter Pack, then left-clickPlurion [Migration Kit]

What to prepare, system by system

How the kit finds each vendor’s product

At the drop, Plurion looks for the vendor’s product in this order and stops at the first match:

• Its own past sales. CasperVend records which vendor made each sale. If you synced that product’s name, the vendor gets that product.
• The item inside it. MD and CasperVend keep a copy of the item they sell in the vendor. If one of your products delivers an item of exactly that name, the vendor gets that product.
• Its name. The vendor’s name must be exactly an imported name you synced. A trailing “Vendor”, as Allomancy’s Quick Setup adds, doesn’t count.
• Nothing found. The vendor still converts, then waits for you to pick its product (Needs setup, below).

What the kit removes, and what stays

The kit deletes every script, notecard and texture inside the vendor whose name doesn’t start with “Plurion”. Everything else stays in the prim: objects (including the item the vendor used to give), sounds, animations, landmarks. The vendor keeps its name and its picture, which is painted on the prim.

Prepare the kit (once)

1. In Second LifeUnpack the kitIn your inventory, open the Plurion [Starter Pack] folder (your Plurion objects). Rez Plurion [Migration Kit] on your land, left-click it → Copy to Inventory. A folder Plurion [Migration Kit] appears in your inventory. From now on, use that folder, not the box.
2. On the webCreate your configIn Migrate, open Convert your vendors. Check that the shop at the top of the sidebar is the right one, then tick I understand: they’re deleted for good. Click Create config, then Copy under 2 · In-world. Your config works for 7 days, for this shop only.
3. In Second LifePaste it into the kitIn the new folder, open the Plurion [Config] notecard. Paste your config (two lines) under the text that starts with #, then click Save. Keep it private.

Convert one vendor, then the rest

1. In Second LifeTry one vendorPick a quiet vendor. Drag the Plurion [Migration Kit] folder from your inventory onto the vendor. It pulses blue for up to 25 seconds while the kit reads its picture.
2. In Second LifeAccept the debit permissionSecond Life asks whether the vendor may take money from you. Click Allow access. Each converted vendor asks once. Without it, the vendor shows “Paused: accept DEBIT” and no Pay button (why Plurion needs it).
3. On the webCheck the feedOn Convert your vendors, the vendor appears in the Live conversion feed within seconds. Matched means it found its product; the other statuses are explained below.
4. In Second LifeDo the rest, about ten in a rowDrop the same folder on the next vendors and accept each permission. If you drop it on too many at once, some conversions miss their turn. If your chat then says “backend unreachable - touch to retry”, touch that vendor.

The live conversion feed

If something’s off

• Nothing happens when you drop the folder → you can only drop items into an object you own and can modify.

Whenever the kit doesn’t convert, it removes itself and leaves the old system’s scripts in place. Its lines start with “[Plurion] Migrate kit:”.

The chat says…	What to do
“waiting for the 'Plurion [Config]' notecard...”	Nothing. The folder’s items are still arriving.
“no 'Plurion [Config]' notecard in the kit…”	The notecard is missing or renamed. Keep its exact name, Plurion [Config], then drop the folder again.
“paste your 2 lines from … into 'Plurion [Config]'…”	Paste your config, click Save, drop the folder again.
“your 2 lines are expired or wrong…”	Create a new config on Convert your vendors, replace it in the notecard, drop again.
“couldn't reach Plurion…”	Drop the folder again.
“nothing to convert here…”	That object holds no other system. It’s already a Plurion vendor, or empty. An empty prim now holds a Plurion vendor script, so delete it from its Content if you don’t want a vendor there.
“this is a Plurion object, nothing to convert…”	Drop the folder on a vendor instead. Then delete the items the kit added from that Plurion object’s Content.

Rarely, after a stopped attempt, the old vendor no longer shows its Pay button. Reset its scripts from your viewer’s Build menu (Scripts → Reset Scripts).

#After the switch

• Check your prices in Products, since products created during the migration take your most recent sale price.
• The objects you stocked in your vendors are still inside. Leave them or take them back.
• Keep Connect CasperVend connected while a CasperVend vendor is still selling, or while CasperVend forwards your Marketplace sales.
• When you’re through, click Mark as done on the Convert your vendors card. It only ticks the card, and you can undo it.

#Common questions