WowAce

By following the procedure defined below, you will be able to safely move lists from the older version of SuicideKingsGeo (pre 5.0 versions) into the new addon. It is important to understand the limitations of this import process before doing so. It is also strongly recommended that you follow this procedure before making any other lists, and use them as your starting point with the new addon.

Limitations

• Characters imported using this process are ALL considered Mains. The import process does not understand that a character can be an Alt. If you are, or plan on using the Main/Alt relationship feature of the new version, you will need to make those changes to the lists by hand following the import.
• All characters in the new version have a class associated with them. The import process will attempt to use the Class Lists of the old version to resolve class names, and then, check your guild roster. After that, it will ask you, for every unresolved character's class, one at a time, to specify the classes of each. A little preparation in the old plugin, and ensuring that all characters in all lists are also in your class lists will go a long way to making the import quick and easy.
• VERY IMPORTANT : This procedure will OVERWRITE any existing lists that have the same names as your old lists.

Procedure

Step 1: Locate and move your old SV file

The old Saved Variables file will be located under your WTF folder, at the following path

<Warcraft Dir>\WTF\Account\<accountname>\<servername>\<charname>\SavedVariables

and will be called

SuicideKingsGeo.lua

NOT the SKG.lua file (thats the new one). Once you have located that file, copy or move it to the new SKG addon directory:

<Warcraft Dir>\Interface\Addons\SKG\

If there is already a file there with that name, just overwrite it.

Step 2: Go in game

When you load the game, be sure that the SKG addon is ENABLED for the character you're going to login as, and if it is still present, DISABLE the SuicideKingsGeo addon. While their structures and data do not match, many of the commands, variables and state management of the new plugin match the old, and it cannot work side-by-side.

Once in game, the new addon will detect the fact that you have made the old lists available to it, and ask if you want to import them. Again, please aware of the limitations and warning listed above before Clicking 'OK' to proceed.

Step 3: Processing

The import occurs in 3 phases, detailed here:

• Phase 1 : Create temporary lists of all the players, the roll lists, and attempt to resolve all player's classes using the old Class Lists, and then your Guild roster.
• Phase 2 : If there are any remaining unresolved Classes, query the user for each player to select the correct class from a chooser
• Phase 3 : Once all characters have their records completed, convert and complete the processing and cleanup of the old lists into the new format.

Step 4: Post Import Steps

After the import is complete, it is recommended to exit the game (thus saving the newly formed lists), delete the SuicideKingsGeo.lua file from the SKG addon folder, and remove the SuicideKingsGeo addon folder entirely (if you have not done so already).

At this point, you should be ready to roll with the new addon using your old lists.

Finally, if your lists previously contained ALL Mains and Alts as individual entries, but you would like to use the new Main/Alts relationship feature in the new version, there is some additional information available at Managing Mains and Alts.