********************************
** USLEEP SWAP MASTERS SCRIPT **
** created by matortheeternal **
********************************

___[WHAT IS THIS]___

This is an xEdit script made to help with switching mods that
are dependent on the individual Unofficial Patches (USKP, UDGP,
UHFP, UDBP), to be dependent on the Unofficial Skyrim Legendary
Edition Patch (USLEEP) instead. The script was extensively
tested and should make the transition from the old individual
patches to USLEEP easy for everyone! :)

NOTE: During this process you will have both the individual
unofficial patches enabled in your load order and USLEEP. This
is only so the swap masters process can swap the masters on
your files that are dependent on the individual unofficial patches.
You absolutely CAN NOT run the game with both the individual
unofficial patches and USLEEP enabled. You can have either
USLEEP enabled or the individual Unofficial Patches.

This script exists so the plugins that you would have to disable
from your load order in order to use USLEEP (because they
require the individual Unofficial Patches) can be used with
USLEEP instead.


___[INSTALLATION]___

1. You need TES5Edit installed. You can download it from Nexus
Mods here: http://www.nexusmods.com/skyrim/mods/25859
2. Install the two loose text documents in the same folder as the
TES5Edit executable.
3. Merge the included Edit Scripts folder with the Edit Scripts
folder alongside the TES5Edit executable.
4. You're done!


___[USAGE]___

1. Make sure you have the latest version of the unofficial
patches installed.
- USKP: http://www.nexusmods.com/skyrim/mods/19
- UDGP: http://www.nexusmods.com/skyrim/mods/23491
- UHFP: http://www.nexusmods.com/skyrim/mods/25127
- UDBP: http://www.nexusmods.com/skyrim/mods/31083
2. Install USLEEP.
- USLEEP: http://www.nexusmods.com/skyrim/mods/71214
3. Make sure your load order is set up like so:
- Skyrim.esm
- Update.esm
- Unofficial Skyrim Patch.esp
- Dawnguard.esm
- Unofficial Dawnguard Patch.esp
- HearthFires.esm
- Unofficial Hearthfires Patch.esp
- Dragonborn.esm
- Unofficial Dragonborn Patch.esp
- Unofficial Skyrim Legendary Edition Patch.esp
-
-
4. Run TES5Edit and load your mods that are dependent on the
separate Unofficial Patches, all of the Unofficial Patches, and
the Unofficial Skyrim Legendary Edition Patch.
5. Once the background loader is done (don't skip it!), right
click on any plugin in TES5Edit and choose Apply Script.
6. Choose USLEEP - Swap Masters Script from the dropdown menu and
click OK.
7. Pay attention to the messages log! If something goes wrong
it'll come up here. See the "Errors" section of this readme for
details on things that could go wrong.
8. Close TES5Edit, saving the files that were modified. Make
sure you check the "Backup" checkbox!
9. Re-open TES5Edit with the ESPs you modified and check each of
them for errors. If no errors are found you're good to go! If
errors are found, restore the backup ESP files from the TES5Edit
Backups folder in your Skyrim Data directory.
10. Disable the individual unofficial patches from your load
order. Your load order should now look like this:
- Skyrim.esm
- Update.esm
- Dawnguard.esm
- HearthFires.esm
- Dragonborn.esm
- Unofficial Skyrim Legendary Edition Patch.esp
-
-


___[ERRORS]___

Swapping masters is a complex process, and there are some things
that could go wrong. I've worked really hard to make this script
as robust and user friendly as possible, so hopefully that won't
happen too often.

1. File isn't loaded
If you run TES5Edit without loading all of the unofficial patches
and USLEEP, you may get an error about a file not being loaded.
If this happens, restart TES5Edit with the proper files loaded.

2. FormID remapping conflict
This should neever happen for the Unofficial Patches. If it does
it means that the script will need to be updated.

3. No FormID mapping found
If this occurs when handling overrides or references it shows
that certain records/references could not be handled by the
script, and will have to be handled manually.
If this happens when building a FormID map don't worry about it.
It just shows that certain records were not carried forward to
the new master file (in this case from the individual unofficial
patches to USLEEP).

4. Some files failed to have masters swapped
If this happens it means that the script was unable to swap the
masters for certain files automatically. Refer to the rest of
your log to find out why.


___[ADDENDUM]___

Thanks to zilav and the rest of the xEdit team for their constant
support.

Hope this helps you guys out! :)


-Mator