Auto Book Placer

version 3.04

* OBSE required *


This is version 3.04 of Auto Book Placer. Version 1.1 is also available here for those allergic to OBSE.

Version 3.0 is a complete rewrite of the earlier versions and includes the following features:
- Ability to stack any shelf, not just shelves in the player houses. (As long as the shelf model is known by the mod).
- Ability to stack potions, alchemical apparatus and drinks.
- Ability to stack wine bottles onto wine racks.
- Bookshelves & wine racks can be picked up, dropped, repositioned and resized.
- Bookshelves & wine racks can be purchased at any general store.


Move the crosshair over a bookshelf and press the 'AutoBookPlacer Key' (default 'P'). Then select from the following options:

1 Stack shelf
2 Take items
3 Resize shelf
4 Reposition shelf
5 Pick up shelf


--------------
1 Stack Shelf
--------------
Selecting this will cause a container to open. Place any items you wish to stack in there. When you close the container the items will be stacked onto the shelf.
You also have the chance to auto-select a certain category. This will save you having to trawl through your inventory for all the books, etc. Choosing an auto-select will cause all items of that category to be added to the stacking container.

As many items as possible will be stacked. Any items not stacked will be returned to your inventory. Possible reasons for an item not being stacked:
* too tall for shelf
* too deep for shelf
* no room left on shelf
* item model is not known by the mod - I had to measure and input the sizes of each stackable model. There are a lot of models!

Items will be stacked in alphabetical order by name. If your version language is English, books will be stacked alphabetically by series name, then the number in series. For instance, 'Beggar' is part of the 'Eslaf Erol' series, so 'Begger' will be stacked as if it begin with E. All books in a series will be stacked in order.


------------
2 Take items
------------
Any items on the shelf will be automatically moved to your inventory.
I have noticed a bug with this where you receive items in your inventory that were not on the shelf. I am not sure of the cause of this and it does not happen all the time.


--------------
3 Resize Shelf
--------------
Walk towards the shelf to shrink it. Walk away to resize it. When finished resizing cast the spell again to lock the size.
You are able to resize a shelf from 0.5 to 2 times the model size. If you want to fit more books on your shelf, making it bigger is a good idea!


------------------
4 Reposition Shelf
------------------
Don't like the current location? Select reposition and you can walk around the room with the shelf held in front of you, allowing you to position it exactly where you want. When shelf is in the desired position, cast the spell again to fix it in place.


---------------
5 Pick up shelf
---------------
This will remove the shelf from the game world and add it to your inventory. If the shelf is also a container, all items will be removed from the container and placed in your inventory. Shelves are not light!

Dropping the shelf causes you to go into reposition mode with the shelf. Don't drop shelves outside, you will never see them again.


=====================================
Where to get bookshelves / wine racks
=====================================
* In your own home
* In other people's homes (!)
* From general stores

The general stores have bookshelves and wine racks for sale. You could quite easily steal them from other buildings if you are that way inclined.

Important Note: Any changes you make to the position or size of a bookshelf placed in the game will be PERMENANT after saving. Uninstalling the mod will not restore these bookshelves. I recommend you leave the pre-placed bookshelves as they are and only use the buyable shelves for repositioning and resizing.


==============
Compatibility
==============
Should work with any mod. Please let me know if it does not work with a certain mod and I will investigate the issue.


========================
Possibly Asked Questions
========================
* I am trying to cast the spell on a bookshelf but it says 'Not Stackable'
- The shelf model is not in the mod's list. Probably because it is not a very good shelf ( some shelves are too small and cannot fit any books on at all ). If you really want a particular shelf model including, let me know and I will check it out.

* I dropped a bookshelf in an exterior cell and it dissappeared
- Yes it will. I'm not entirely sure why as to be honest I have not investigated it. Just don't use them outside.

* Is this mod compatible with...
- It should be, try it. If there is problem let me know.

* What items can be stacked?
- Currently: All books, potions, alchemical apparatus. Wine bottles on wine racks.


=======
Credits
=======
Mod by Horny Quintus.

Thanks to,
the OBSE team for an excellent set of extensions to the script language. You've allowed me to achieve nearly all I want to achieve with this mod.
Langy for your original OBSE version that gave me the inspiration to use OBSE
Anybody who left comments on the original AutoBookPlacer, for your ideas and support.
And anyone who has helped me with this mod in the past. I am useless at keeping track of names so my apologies for that.