What is this?

This mod fixes bugs in vanilla script for bookshelves in player houses (such as ones in Breezehome).
No change in their functionality. Just some bugfixes.

The mod will fix already-corrupted bookshelves too, details are described later.

2016.02.13 - Merged in USLEEP 3.0.1.
Thanks to Arthmoor for merging!


Requirements

None.


Compatibility

Compatible with all official DLCs.
Works fine with whatever that doesn't modify bookshelves.
Load order doesn't matter, as this fix doesn't have any ESPs.
Data structure is compatible with original vanilla one, and can be removed anytime without stains in saves.

Conflicts with following mods, as they modify the same file as this mod does.

• Bookshelves Updated SKSE Script
• Unlimited Bookshelves
  

You can still migrate from these mods. See Migration Guide described later.


Installation

Unpack the archive and copy "scripts" folder into your Skyrim Data folder.
If you are asked to overwrite, check if you are using any incompatible mods. See Migration Guide described later if needed.
Once you are sure, overwrite. It's highly recommended to make backups of any overwritten files!

Skyrim Data folder is usually found in:
    "C:\Program Files (x86)\Steam\SteamApps\common\Skyrim\Data"


Uninstallation

Just remove files you have installed in the process above.
No extra action like cleaning saves or resetting cells is needed.


Fixing already-corrupted bookshelves

Bookshelves may have been already corrupted by bugs in vanilla scripts.
Their inventory spaces can 'expand' by the bugs but extra books cannot show up on the shelf.

This mod can fix that and correct their inventory size.
Fixing process will trigger once the shelf is empty.

To trigger the fix,

• Empty the shelf you want to fix by taking out everything from its inventory.
• Or if it doesn't work, take out all books on the shelf by hand (one by one), once the shelf looks empty, open its inventory and empty it, then close it.
  

Open the inventory of the shelf again, and you will see its inventory size is now correct.
(To be precise, the process will trigger once all books in the display are removed, and there could be books still remaining in the inventory when it triggers. But you will lose nothing, as all items remaining will be transferred silently into your inventory.)

By the way, correct inventory sizes of bookshelves are:

• 11 for narrow shelves
• 18 for wide shelves
  

Migration Guide

If you migrate from mods that conflict with this mod, follow these steps.
Please be warned that I haven't tested with all conflicting mods, so this process may or may not work. Always have your backup save!
The author cannot help with broken saves resulted in the process!

• Make a backup save!
• (Optional) Empty bookshelves before removing an incompatible mod. If you forgot to empty them, you will need an extra step (6) to clean up remaining books.
• Save in an outdoor area.
• Remove the mod and install my mod.
• Done.
• (Optional) If you forget to remove all items from your bookshelf in step (2), there will be duplicated copies of books still remaining on the shelf (even after its inventory is empty), and you have to remove them by hand.
  

Note that when you open each bookshelves for the first time after migration, fixing process might trigger, and all remaining books in their inventory would be transferred silently into your inventory. This looks like suddenly all books are gone, but you will find them in your inventory.

You will see some warnings if you were taking a papyrus log, which claim some variables are missing in your save data. Those variables used to be added and used by the conflicted mods, so you can ignore them. They won't be included in your next save.


What's wrong with the vanilla scripts?

There are some defects in vanilla scripts. All bugs described below are fixed with this mod.

• Bookshelves' inventory spaces 'expand' so that they can keep more books than normal ones do, but excess number of books cannot be displayed on the shelf.
• Book(s) in a shelf's inventory space could disappear into Oblivion.
• Sometimes books change their positions on shelves.
• Books could disappear when dropped from your inventory.
• Books from a removed ESP eat up their slots in a shelf permanently if they were placed on a shelf when the ESP was removed.