# Migrations Most updates to this mod are safe to install directly. This page lists the exceptions — points in the [changelog](changelog.md) 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: - `VIPplayersList`, `VIPplayersTaxes`, and `BankerVIPIncomeMultiplier` are no longer read from [server config](../setup/server-config.md). Leaving them in your `MarketPlace.cfg` is harmless — they're just ignored — but they no longer do anything: every seller pays `MarketTaxes`, and every banked deposit earns `BankerIncomeMultiplier`, with no VIP-tier exception. - The `IsVIP` / `NotIsVIP` [conditions](../concepts/conditions.md) still parse without error, but `IsVIP` now always evaluates to false and `NotIsVIP` always evaluates to true — see [Known gaps](known-gaps.md) for the current-version detail. Any dialogue option, quest, or zone flag that used to gate on VIP status needs a different condition now (guild membership, a faction, or a [custom value](../concepts/prefabs-and-assets.md#custom-values) you set yourself). - `OrConditionSeparator` is also gone in the same pass, unrelated to VIP specifically — the `||` OR-separator in [conditions](../concepts/conditions.md) is hardcoded now, no longer admin-configurable. This only matters if you had actually changed it away from the default `||`; if you never touched that setting, there's nothing to do. 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](known-gaps.md) 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`](../configs/quests.md#the-target-line-by-type)). 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](../configs/quests.md) 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](../configs/transmogrification.md) 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 - Read the entries between your current version and the new one in the [changelog](changelog.md) — the author calls out breaking changes there when they happen. - Back up your `Marketplace` config folder and save data before updating a live server, especially across a large version jump. - Test on a local or backup copy first if your server has valuable, hard-to-recreate content (long quest chains, custom zones, banked items). ## Related - [Changelog](changelog.md) — the full version history these warnings are drawn from. - [Known gaps](known-gaps.md) — current-version quirks, unrelated to updating.