Storage Helpers 2.5

by CDCooley
2015-07-16

for
The Elder Scrolls V: Skyrim

SkyUI 4.1 and SKSE 1.7.2 or higher are now required.
(Version 1.6 is the last version that works without SKSE.)


*********************************************************************

The SkyUI 5.0 crafting menu no longer uses categories, so container
and furniture crafting are now performed using a special crafting
menu instead of the standard forge.

Please report any problems and make suggestions for improvements
on either the Bethesda forums or on the Skyrim Nexus.


*********************************************************************


KEY FEATURES

* Craft pouches, chests, sacks, barrels and various other containers.

* Turn bandoliers, pouches, and backpacks into real wearable containers.

* Move, rotate, and resize almost any object in the game.

* Put multiple items into a container with a single click.

* Rename your containers (and other objects).

* Access teammate inventory and horse saddlebags quickly.

WHAT'S NEW

* Custom container and furniture crafting menu.


*********************************************************************

DESCRIPTION

If you have the right supplies (leather, iron ingots, wood, etc.) you
can craft various containers. Drop the container any place you like
(including other people's houses) and you will have a safe storage
location for your use. If you want to move it later, just Drag it and
you can move it to a new location or pick it up.

Don't limit yourself to just those containers, craft portable versions
or just convert backpacks, bandoliers, and pouches from others mods
into wearable containers you can see equipped on your character.

You can move, resize, and rename containers, furniture, and almost
anything you can select in the console. You won't be able to move
standard game bookshelves and a few other items, but you can move
mannequins, weapon racks, tables, rugs, and most other items.

Do you hate that you can "Take All" but not "Put All"? Well how
about "Put Most", "From Top", and "All of Item" options. You can
now use R to put almost everything (except the clothes you are
wearing, your favorite items, and a few other special items like
gold, lockpicks, and quest items) that are showing in the current
inventory window. Pressing P will only transfer items from the top
of the display down to the currently selected item. And pressing I
is a quick way to put all of a single selected item into the
container without the annoying quantity slider. And if you want to
stash that quest item into one of your wearable or named containers,
go ahead the I key can do that too.

And now you can get quick access to teammate inventories and a special
saddlebags container.

The key mappings can be viewed (and changed) from the Storage Helpers
MCM page on the System page (press Esc to get started).


*********************************************************************

INSTALLATION

If you use NMM or Wrye Bash, it should be a standard install.

If you're doing things manually, just copy the StorageHelper.esp
and StorageHelper.bsa files from the 7z archive into your Data
folder and activate the ESP in the launcher.

SKSE can be found at http://obse.silverlock.org/ and is required.

SkyUI can be found at

I highly recommend using SkyUI since its filtering system is
much easier to use and more powerful than my Quick-Keys feature.



UPGRADING

Just overwrite the old ESP and BSA files with the new ones.

Make sure you have a backup of your saved game just in case
anything goes wrong, but that's standard advice.



POTENTIAL INCOMPATIBILITIES

Mods that modify the Steed Stone effect should be loaded after
this one. The change made by this mod was simply to prevent
unlimited carrying capacity for wearable containers but many
other mods that change the Steed Stone make a similar change.



LIMITATIONS AND QUIRKS

Grab display shelves and choose "Disable Container Features" to
make them act as simple static shelves. To re-enable the container
features you will need to select them using the console and then
use the rename feature. (Disabling them simply removes the name
which makes them stop responding to the normal game crosshairs.)

Display shelves can display most items, but items without bounds,
items that are too big, and items added to a shelf after all of
the available display space is used may not appear correctly. Items
can always be retrieved from the container itself or from the world
if displayed, but spacing placement of items is limited by the fact
that not all items have correct bounding properties set in the CK.

Quest items are moved by the SKSE scripts. You'll need to remember
where you left them if they get placed into one of the containers.

Moving groups of items takes time. If you close the container menu
window moves will stop. If similar items are showing individually
in the inventory (as typically happens after crafting a set of items)
then the group move feature may not move all of them correctly.

The portable and wearable containers appear in the armor section
at the top.

Converting some item into a wearable container will change the
base weight of all copies of that item in the game, so it's a
good idea to only use unique or rare items.

You have to hold Left Shift while activating a wearable container
item that you have dropped into the world to pick it up again. A
normal Activate will simply open it as a container.



*********************************************************************


GENERAL MCM (Mod Config Menu) OPTIONS

No Key Labels
Don't show extra labels in the container menu.

No Dropped Item Comments
Disables the world interaction quests which make guards comment on
items you drop, strangers try to return the containers you're trying
to place, groups of people fighting over things, etc.

No Smithing Experience
Crafting containers and furniture won't improve your Smithing skill.

Transfer Soul Gems
This controls which types of soul gems are moved with the Put Most feature.
(Options are ALL, FILLED, and NONE.)

Saddlebag Capacity
Using the Place key on any teammate will open the inventory sharing menu.
Using it on a horse will access a special Saddlebags container and you can
specify the weight limit for the saddlebags here. (0 disables this feature.)
(The configurable limit is between 0 and 2400 in steps of 300.)

Weight Reduction %
Percentage of weight reduction for the contents of wearable containers.

Weight Base Adjustment
Weight added to or subtracted from portable and wearable container tokens.
Negative values can only offset the weight of the container and contents.

Teleport to Storage Cell
Storage Cell contains all of of the real containers used by portable,
wearable, and linked named container items. Grab any container to recover
a matching carriable token or just search through the containers for
misplaced items. (You can also mark Named Storage containers as unused
in case you need to reuse them since there's a limit of 128.) Press the
Place key to return to your original location when done.

Craft Containers/Furniture
Open the container and furniture crafting menu.
You can also open it by pressing the Place key while the Character Menu
is open. (The Character Menu is the one with arrows giving access to the
Skill, Magic, Inventory, and Map menus that is normally opened with the
Tab key or the B control on a gamepad.)


DEFAULT KEY MAP FOR THE ITEM MOVEMENT FEATURE

Place (Move/Rename/+) [NumLock]
Starts and stops item move mode. (See General page for other uses.)
Used with Slow at end of move it locks item in place.
Used with Fast at end of move it causes item to fall immediately.

Mode (modifier) [not used by default]
Modifier key used to convert the Center, Fall, and Slide keys into Grow,
Shrink, and Tilt actions (allowing use of fewer keys to avoid conflicts
with other mods) if "Use Mode Key" option is selected.

Center [NP 5]
Resets the item rotation and makes it face the player.
With Slow it will also be moved to table height.
With Fast it will also be moved in front of the player.

Fall [NP Enter]
Causes item to fall and react with other items.
With Slow returns item to its starting position.
With Fast tries to return item to its original game location (if nearby).

Slide Up [NP 9]
Slide Down [NP 3]
Slide Away [NP 8]
Slide Closer [NP 2]
Slide Left [NP 4]
Slide Right [NP 6]
Only used while moving items.

Slow (modifier) [Left Shift]
Modifier key used to make items move more slowly.
(See General page for other uses.)

Fast (modifier)
Modifier key used to make items move more quickly.
(See General page for other uses.)

Activate/Journal/Pause/Console
The Activate control acts like Place to end item movement.
Journal, Pause, and Console controls will cancel the move and put it
back in its original position.

Grow [NP *]
Only used while moving items.
When disabled it is replaced by Mode + Center.
Pressing with Shrink resets size to default.

Shrink [NP /]
Only used while moving items.
When disabled it is replaced by Mode + Fall.
Pressing with Grow resets size to default.

Tilt +X [NP 7]
Tilt -X [NP 1]
Tilt +Y [NP +]
Tilt -Y [NP -]
Turn Left [NP 0]
Turn Right [NP .]
Only used while moving items.
When disabled it is replaced by Mode + Slide ...

Use Defaults - Unique
Reset all to defaults with each action mapped to a unique key.



*********************************************************************

DOCUMENTATION FROM THE MCM

SPECIAL ACTION KEYS

Place Key (Move/Rename/Open/Teleport/Craft) [NumLock]
Moves an item that is selected in the console, targeted in the
crosshair, or a nearby static. (See the Key Map page for a list
of the keys used in item movement mode to manipulate the item).
Used with Fast it renames the targeted item. (See Fast key note.)
The Place key also allows quick access to follower inventories
and a special horse saddlebags container.
Used in the Map Menu it teleports you to the Storage Cell where
you can retrieve lost items.
Used from the Character Menu (Tab/B button) it opens the container
and furniture crafting menu.

Fast (modifier) [Left Alt]
Used with Place to rename the targeted or selected item.
Rename only renames a single item, not all of its type and may
not work on NPCs and some quest related items.

Slow (modifier) [Left Shift]
Used with LeftEquip to convert bandoliers, backpacks, and other
clothing items into wearable containers.
Used with Activate to pick up wearable containers from the world.
(Sneaking does the same with a gamepad.)

LeftEquip (inventory menu) [Right Mouse Button]
Opens wearable containers (while in inventory menu).
Used with Slow to convert bandoliers, backpacks, and other
clothing items into wearable containers.

Grab (must be held) [Activate]
Using the Grab control on crafted containers will show a special
action menu allowing you to pick up the container link it to a
special remote container which can safely hold quest items.


EXTRA CONTAINER MENU CONTROLS

All of Item (container menu) [R]
The Ready Weapon control or 'Take All' key now becomes 'Put Most'
when looking at the player items and attempts to transfer everything
in the current (possibly filtered) category view. Equipped, favorite,
and special items like lockpicks, gold, wearable containers, and quest
items aren't transferred. Keys will only be transferred from the KEYS
category view.

All of Item (container menu) [I]
The Quick Inventory control is the 'All of Item' action and transfers all of
the currently selected item to or from the container without the quantity
prompt. Even quest items will be moved (despite the warning message) if the
destination is a portable, wearable, or named storage container.

From Top (container menu) - [P]
The Quick Magic control is the 'From Top' action and is similar to 'Put Most'
but also works to take items from a container. It will transfer from the top
of the currently showing (possibly filtered) list of items down to the
currently selected one (or to the bottom of the list if none is selected).



CONTAINER TYPES

Portable Containers
A small set of portable (and wearable) containers (Knapsack, Pouch,
Sacks, etc.) can be crafted and will appear in the armor section of
inventory. They can be equipped, but have no matching graphic.
LeftEquip will open them as containers. Their weight will be adjusted
based on their contents, but because of a game limitation you can only
use one of each. If dropped Slow must be held while activating to pick
them up again!

Wearable Containers
Clothing and items from other mods (bandoliers, backpacks, etc.) can
be converted for use a wearable containers (with Slow + LeftEquip).
LeftEquip will then open them as containers and their weight will be
adjusted based on their contents. Because of a game limitation every
item of that type in the game gains the new weight, so don't use the
feature on common items! If dropped Slow must be held while activating
to pick them up again!

Crafted Containers
Versions of most of the game's containers can be crafted at any forge.
All (except the portable containers) are meant to be dropped into the
world and used as normal containers. They are safe storage, but if
placed in cells that are reset by other mods they could be lost. When
linked to Named Storage (using the menu accessed with the Grab control)
they are safe enough to hold quest items. Using Grab you can pick them
up again and carry them to other locations.

Named Storage
Crafted containers linked to Named Storage in the Storage Cell are safe
even for for quest items. When linking a crafted container (with the
Grab control) you choose a name for the link and a matching container
is created in the Storage Cell. If you reuse a name with crafted
containers of the same type (i.e. two baskets) they will link to the
same named remote storage container. (But a basket and a chest both
named 'Junk' will not share the same storage.

Display Shelves
Crafted Shelves can display almost any item, but not all items have the
information required for correct placement. The script that displays
items will do its best, but some items will not be displayed and others
will be placed in bad positions. All items (even those that can not be
displayed) will remain in the shelf container, but any displayed items
can be retrieved directly without opening the container.

Closed Baskets
The standard closed baskets (which are just normal clutter in the game)
can be converted into usable containers without using the crafting
system. Just target the basket and press the Place key to move it
and when you are done it will be converted into a real container.



HOW DO I?

Craft containers and furniture
Open the Character Menu (press Tab) then press Place (NumLock).

Convert bandoliers into containers
Hold the Slow (Left Shift) key (or be Sneaking) while using the
LeftEquip (Right Mouse Button) on an item in your inventory.
(You can switch them back the same way.)
(Jewelry, helmets, boots, gloves, and armor can't be converted.)

Pick up wearable containers
Hold the Slow (Left Shift) key or be sneaking while you activate
it. (The normal Activate control will simply open the container
not pick it up even though it's technically a piece of clothing.)

Move or resize things
Target an item in your crosshair or just position so some
interesting item is right in front of you then press the Place
key (NumLock). Or you can open the console, select an item, and
press Place while the console is still open.

Rename things
Target an item like you would to move it but hold the Fast (Left
Alt) key down while you press the Place key.
It's a bad idea to rename NPCs and quest items. If something
loses its name and you can't activate it you can probably still
select it in the console and give it another name.

Open teammate inventories
Target your teammate in the crosshair and press the Place key.
(NPCs and creatures can't be moved, so if it's a teammate I open
the inventory instead.)

Access horse saddlebags
Target your horse (or any horse really) and press the Place key.
(This is a special Saddlebag inventory provided by this mod not
the horse's real inventory or the ones provided by mods like
Convenient Horses.)

Put groups of items in a container
The special game controls usually mapped to R, I, and P are
used to move groups of items at a time.\nRead the notes for
each key on the General page for more details.

Put quest items in a container
Press the I key (or whatever you've key you've remapped it to)
on the quest item from your inventory. The feature only works
to move quest items into wearable or named containers. (The
item is really moved into a container in the Storage Cell so
if you can't find it later you can just Teleport there and
look through the containers rather than trying to remember
which house or dungeon you were in when you stored it away.)

Make two containers share one inventory
Use Drag on a crafted container and choose the option to link
and name the container. All containers that look alike and have
the same custom name will also share the same inventory.

Find things that are missing
Open the map menu and press the Place key (NumLock) to teleport
to the Storage Cell and look through the containers there. All
items stored in the wearable containers and linked named
containers are really stored somewhere in that cell. When you're
done, just press the Place key again to return to where you were.



*********************************************************************

NOTES FOR MODDERS AND ADVANCED USERS

Feel free to report static items from the default game, DLCs, or mods
that aren't movable and should be. I'm happy to add them to the list
in future updates. (You can also just click on the in the console now.)

Alternately you can add items to the formlist yourself. Here's a little
script fragment as an example of how to add forms from your own mod
without creating a dependency on StorageHelpers.

| FormList SHList = Game.GetFormFromFile(0xF08D,"StorageHelpers.esp")
| if (SHList && !SHList.HasForm(MY_FIRST_STATIC_ITEM)
| SHList.AddForm(MY_FIRST_STATIC_ITEM)
| SHList.AddForm(MY_SECOND_STATIC_ITEM)
| ; add as many as you like, but remember furniture and other items
| ; that can be activated don't need to be added to this list.
| endif



*********************************************************************

RELEASE HISTORY

0.5 - 2012-05-24 - Initial public testing release.
0.6 - 2012-05-30 - NPC support, portable containers, key remapping
0.7 - unreleased - added SEQ file, NumPad container placement
0.8 - unreleased - script refactoring, bug fixes
0.9 - 2013-11-03 - more containers, SkyUI-based item transfers
1.0 - 2013-11-22 - wearable containers from clothing, move static objects
1.1 - 2013-12-01 - no auto-move keys, reset/cancel item move options
1.2 - 2014-01-21 - non-widescreen support, changed crafting categories
1.3 - 2014-01-25 - use wearable containers with gamepad controls
1.4 - 2014-01-26 - Equipping armor and clothing possible again!
1.5 - 2014-02-15 - Improvements to Center, Fall, Rotate, and Lock items
1.6 - 2014-07-10 - Easier translation layout, no error trying to move actors
2.0 - 2015-01-15 - Rename items, MCM options and key mapping, display shelves
2.1 - 2015-02-08 - Allow disabling new shelf display feature
2.2 - 2015-04-02 - Teammate and saddlebag inventory access, soul gem option
2.3 - 2015-04-14 - Fix load order bug that unlinked named storage containers
2.4 - 2015-06-24 - Fix to prevent books jumping off of the shelves
2.5 - 2015-07-16 - Add custom container and furniture crafting menu.



FUTURE DEVELOPMENT & WISH LIST

Faster transfer of groups of items.

Unique wearable containers for converted clothing.



*********************************************************************

CREDITS AND LICENSING

Thanks Bethesda developers; SKSE, SkyUI and NifSkope creators; CK wiki
contributors; and the Nexus and Bethesda forum communities.

Two SkyUILib version 1.0 (http://www.nexusmods.com/skyrim/mods/57308/?)
SWF files are included in unmodified form to allow text input.

The best features are not possible without SKSE and SkyUI.

I used NIFSkope (http://niftools.sourceforge.net/wiki/NifSkope) to
make movable versions of some of the game's static container meshes.

Feel free to use the meshes I've altered for your own Skyrim mods,
but remember they can not legally be used for other games.

The scripts in this mod are mine (for better or worse) but the ideas
are pulled together from old Morrowind scripts, code on the CK Wiki,
and ideas posted in the forums with the most important contribution
being schlangster's instructions on how to inject a SWF movie to
interact with the SkyUI menus. The new display shelf script is inspired
by Unlimited Bookshelves by da5id2701 which I recommend for its fixes
to book bounds.

I'm interested in working with anyone who would like to improve this,
but please don't upload this mod to any other mod distribution sites.
It's official home is on the Skyrim Nexus: http://skyrim.nexusmods.com

Please post comments and complaints on the Bethesda or NexusMods forums.


Charles Cooley
[email protected]
cdcooley on the NexusMods and Bethesda forums