Migrations

From Resonite Wiki

When registering a Resonite account, you might encounter the message "Reserved Username". This means you are able to migrate your data from other compatible platforms.

In most cases, migrating is a one-way process but will not delete any data from the previous platform.

Migration Path

As previously mentioned, registering with a reserved username will bring out the following prompt.

You will need to input the password of the account on the platform you are migrating from in order to claim that username.

Window showing a text saying that the username is reserved. There is a large red section allowing people to reset their user ID.

User ID reset

Before registering the account and claiming the username, it is possible to choose to reset the user ID you had on the platform you are migrating from. In most cases, you will not need to check that option.

Doing this:

  • Is irreversible as user IDs cannot be changed after registration
  • Can and will break things (for instance, values stored in ValueUserOverride components will not match your user anymore, and previously made avatars using SimpleAvatarProtection will not work for you either)

Data migration

Once you've successfully validated ownership of the username, you will be prompted to migrate data from the platform the account is from.

You are able to migrate:

  • Favorited objects ( avatar, home, camera, keyboard and facets), those will overwrite your currently favorited objects
  • Contacts
    • Optionally message history
  • Inventory and worlds
  • Cloud variable definitions
  • Cloud variable values
  • Groups (if you had any on the platform you are migrating from)

You also may choose to set your old home as default.

Data migration might take up to a few hours to proceed. You can check on the status of your data migration in the migration tab of your dashboard. You will also receive an e-mail and a message from the Resonite Bot once it is finished.

Data migration will also grant you a temporary additional 1GB of storage that will be removed after a month.

Tips & Tricks

Second "Home" tab on dashboard

After migrating, you might end up with a second "Home" tab on your dashboard.

A recommended method to get rid of it is to start Resonite with the command line argument -resetDash. Doing this will completely reset your dashboard and remove your existing facets.