[TUTORIAL] Migrating content and settings from an older version

[WillLem]

RetroLemmini now has a completely open file system. This is so that users can completely customise their copy of RetroLemmini (if they wish to do so), and also makes project maintenance much easier and keeps the directory as tidy as possible.

When you install a new version, to minimise the possibility of missing resources and to keep everything running smoothly, please follow this guide carefully. If in doubt, keep a backup of your old version somewhere until you're happy that you've got everything set up in the new version:

A Guide To Migrating Content and Settings Between RetroLemmini Versions

1) Set the new version of RetroLemmini as a brand new directory - unzip it to a location of your choosing and leave it titled "RetroLemmini X.X" so that you know at a glance which version you're on. Or, if you wish to name the directory "RetroLemmini", first rename your old directory "RetroLemmini old" or similar.

2) Open the new and old RetroLemmini directories at the same time, side-by-side.

3) Move any replays from the old "replays" folder to the new "replays" folder.

4) Move any levels/packs from the old "levels" folder to the new "levels" folder. In most cases, it's OK to overwrite the default packs (Lemmings, Oh No! More Lemmings, etc), but be sure to check that these haven't been updated in the current version. If unsure, don't copy these packs across.

5) For "gfx", "music" and "sound", it's generally OK to move these straight across from the old version, but - as with step (4) - be sure to check that you aren't overwriting any updated files unintentionally (if you wish to overwrite them, that's OK, as long as you know what you're doing!).

Steps 6 onwards are different depending on which version you're migrating from/to.

If migrating from 2.1 or earlier to 2.2 or later:

6) Move the "resources\players" folder to the new "settings" folder.
7) Move the "resources\players.ini" file to the new "settings" folder (but don't put it in the "players" folder!)
8) Copy the contents of the old "settings" folder to the new "settings" folder.

If migrating from 2.2 onwards to a later version:

6) Copy the contents of the old "settings" folder to the new "settings" folder.

If everything's been done correctly, the new version should run without issues, retaining all of your existing content and settings. If you need assistance with any of this, don't hesitate to post here or PM me and I'll do my best to help you.

Enjoy RetroLemmini!