Migrations

Most updates to this mod are safe to install directly. This page lists the exceptions — points in the changelog where the mod author explicitly warned that updating requires an extra step, or could break existing server data if you are not careful. A couple of entries below are flagged from source-checking a fix instead (noted as such) rather than an author warning, when the fix itself silently changes existing content's behavior.

If you are updating across a version not listed here, a plain update is expected to be safe. When in doubt, back up your Marketplace folder and save file before updating a live server either way.

Updating to 9.9.2: the VIP system is gone

The changelog calls this out as a breaking change, and checking the diff confirms it's thorough — this isn't just one setting:

If your server had a VIP tier set up through this mod (taxes, banker interest, or gated content), re-check all three after updating — none of it silently keeps working.

Updating to 9.8.9: re-check any KillAndCollect quest's level field

Not an author-flagged warning — found by checking the fix itself. Before 9.8.9, KillAndCollect's level field required one star less than the number written (see the now-removed entry on Known gaps for past versions), so existing quests written to work around that — e.g. writing 3 to mean "2-star minimum" — now require one star more than originally intended, since 9.8.9 makes the field mean exactly what's written (matching plain Kill).

If you have any KillAndCollect quests already live, check their level field against what you actually want after updating — a quest that used to accept 1-star-and-above creatures at level 2 now requires 2-star-and-above.

Updating to 9.8.6 or 9.8.7: test quests locally first

Both versions shipped large changes to the quest system. The author's own release notes for both said, verbatim: "BEFORE INSTALLING THIS VERSION TEST IT FIRST ON LOCAL CLIENT CAUSE LOTS OF QUEST SYSTEM CHANGES. IF YOU HAVE QUESTS ALREADY ON SERVER THEY MAY BREAK."

If your server has active quests and you are updating from before 9.8.6, install the new version on a local/test copy first, confirm your existing Quests still work as expected, and only then update the live server.

Updating from before 9.4.0: withdraw everything first

In version 9.4.0, the mod changed how it stores player data — moving from individual save files to a single combined database file. The author's release note: "Before installing this version please revert to old one and withdraw all Trade Post items / Banker items / Mail items. Marketplace moved from using .json data files to one single database file."

If you are updating a server from a version older than 9.4.0, have every player withdraw their marketplace listings, banked items, and mail attachments before you install the update — anything left in those systems at the moment of the switch may not carry over.

This mod version documented here (9.9.4) is well past this change; it only matters if you are jumping to a modern version from something very old.

Since 9.0.8: Transmogrification's visual-effects field is gone

Versions 8.2.3 through 9.0.7 supported a fifth field on a Transmogrification line — a numbered visual-effect ID (1 through 20, plus 21 for "player's choice", added in 8.2.3) that layered a glowing effect on top of the reskinned item. The author's 9.0.8 release note: "Removed transmogrification VFX's due to non-readable mesh."

If you're following an old guide or example that includes a fifth field on a Transmogrification line, drop it — it does nothing as of 9.0.8. Only the four documented fields (item, cost item, cost amount, ignore category) apply in this version. Two leftover text labels for it ("No Effect" / "Any Effect") still exist in the mod's translation file, but nothing reads them.

General advice for any update

Edit this page on GitHub