When you upgrade your Mesmerizer to a new version, you will usually want to retain your configuration (triggers, etc). This page describes in detail how to do that.
A Mesmerizer configuration consists of several parts, each of which needs to be transferred to the new Mesmerizer to keep the configuration intact. Those parts are:
- The Access notecard
- Custom content (notecards, animations, sounds, images or objects that have been added to your Mesmerizer)
- Triggers and other stored information
Each of these parts is transferred in its own way. But first, you should determine who is going to be performing the configuration transfer. Some of the transfer has to be done by the wearer, and some has to be done by someone listed as an "owner". If you're self-owned, then you can do it all yourself. If not, then you and your owner should perform the update together. The section headings below indicate who is to perform the actions in each section.
Saving existing configuration
Before starting, it's worth the wearer creating a folder in inventory, as a place to temporarily store any items that have to be moved across. Once you've created the folder, wear your current Mesmerizer.Saving triggers (owner)
Issue a /99 backup command. This will cause the Mesmerizer to generate (and say to you) a series of channel-99 commands that can be used to inject the triggers and other state into the new Mesmerizer. In the final step of the upgrade, you will just copy the commands one at a time into chat to load the triggers into the new Mesmerizer. But first the rest of the content needs to be saved, so you may want to copy the channel-99 commands from the chat window into a notecard, so that they'll be easy to find if there's a delay in performing the rest of the upgrade.
Saving access notecard (wearer)
- If the Mesmerizer is locked, then have your owner unlock it with /99 unlock.
- Right-click the Mesmerizer and choose "edit" from the pie-menu. In the edit popup, move to the "content" tab and wait for it to populate.
- Scroll down to find a notecard called "Access".
- Drag this notecard from the content tab into your inventory, into the folder you created in step 1.
Saving custom content (wearer or owner)
Many Mesmerizer users do not have any custom content in their Mesmerizers. The most common types of custom content are scripts and subliminal sets, but custom sounds, images, animations and objects are also possible. If you don't have any custom content, then you can simply skip this section (and the one concerned with restoring custom content into the new Mesmerizer).Custom content is injected into a Mesmerizer by an Installer or Auto-Installer object. Both types of installer serve as an intermediary container for custom content. The difference is that an Installer is used explicitly by the wearer to inject content into their own Mesmerizer, whereas an Auto-Installer can have content added to it at any time by an owner, and it will then transfer that content to the wearer's Mesmerizer.
Assuming you used an Installer (or auto-installer) to inject the custom content, then the simplest thing is to simply use those same installer(s) to inject it into the new Mesmerizer once you're wearing it - that way you don't need to save anything out of your current Mesmerizer.
If you originally inserted the content manually, you should take this opportunity to put the content into an Installer.
Note that Mesmerizer 1.1 introduced a new (and required) naming convention for most custom content. For example, script notecards must have names starting with "Script:", and subliminal notecards have names starting with "Subliminal:". If you are transferring custom content from version 1.0 Mesmerizer to a later version, you will have to rename the notecards according to their function. If you are in this situation, you should probably contact me in-world to help.
Preparing the new Mesmerizer
Once you (or your owner) have saved everything from your old Mesmerizer, it's time to move to the new one. It's best to do this in a sim with as little lag as possible.Before switching Mesmerizers, it's worth updating any inventory links that point to the current Mesmerizer, to make them point to the new one instead. If you saved outfits while wearing the original Mesmerizer, those outfits will contain links to the old Mesmerizer, and if you wear one of those outfits, you'll end up wearing the old Mesmerizer again (maybe both the old and new one, if the new one is locked). Updating the links will avoid this.
To update links, find the old Mesmerizer in your inventory, right-click it, and choose "Replace Links". This will cause a "Replace Inventory Links" window to pop up, with two fields, labeled "Old" and "New", with the old Mesmerizer already in the "Old" field. Drag the new Mesmerizer from the inventory window into the "New" field. This isn't actually moving the new Mesmerizer anywhere - it will just make links to it. Then push the "Start" button, and each link that pointed to your old Mesmerizer will be replaced with a link to the new one. Wait until it's finished, and then close the "Replace Inventory Links" window
If your old Mesmerizer is locked, have an owner unlock it via the /99 unlock command, and once it's unlocked take it off.
Now wear (or add) the new Mesmerizer.
The first time you wear the new Mesmerizer, it will go through an initialization process. It's important that you allow this process to complete. If it fails for any reason (for example if you get a timeout message), follow the instructions in the Quick Start Guide to re-run the initialization.
Restoring configuration into the new Mesmerizer
Restoring the Access notecard (wearer).
Once your new Mesmerizer is initialized (and while it's still worn), the first thing to do is to restore your owner list. To do this, first find the new Mesmerizer in inventory. It's usually easiest to find in in the "worn" tab in the inventory window. Right-click the inventory entry and choose "Edit". In the edit popup, switch to the Content tab. Wait for the tab to populate, then scroll down until you see the Access notecard. Right-click it - the menu choices should be Open, Properties, Rename and Delete. Choose "Delete".Leaving the edit window up, go back to your inventory (switch to the "All Inventory" tab) and find the temporary folder in which you saved the Access notecard from the old Mesmerizer. When you've found your original Access notecard, simply drag it from inventory into the Content tab of the new Mesmerizer. Then close the edit popup.
Restoring custom content (wearer or owner)
This section assumes that you have one or more Installers or Auto-Installers containing your custom content. To load content from an Installer the wearer simply touches the Installer. To load content from an Auto-Installer, an authorized person (usually an owner) touches the Auto-Installer and selects "Upload" from the menu.Restoring triggers (owner)
Finally the owner can restore the triggers and persistent state that were saved in the first step. The owner should look back in their chatlog and locate the channel-99 commands that were emitted in response to the backup command (or find the notecard in which you saved them). Then simply copy each command (that begins /99 followed by the wearer's name) into chat. Copy and paste each such command as a single string, even if it stretches across multiple lines. And only issue each command once, or you may end up with duplicate triggers.Once you've issued all the /99 commands via chat, the new Mesmerizer should contain all the triggers and state that the old one did (including such things as whether or not the Mesmerizer is locked, and the RLV relay mode). You can issue a /99 backup command to verify that you have the correct number of triggers.
No comments:
Post a Comment