~~~~~~~~~~~~~~~~~~~~~
Alchemy Stockpile Kegs v1.2
~~~~~~~~~~~~~~~~~~~~~~

created by shanjaq.
utilizing freshFish's MWScript Extender


~~~~~~~~~~~~
About the Plugin
~~~~~~~~~~~~~

Adds containers which pull ingredients from your inventory when activated if at least one of those ingredients is already in the keg. This allows you to create your own sorting system and relieves the effort in maintaining it thereafter. They can be found in a Keg Dispenser near the classroom podium downstairs in Balmora, Guild of Mages.

Features in 1.2:
-Fixed case where one ingredient would not transfer if it was the only item in player inventory

Features in 1.1:
-Added "Dispense Ingredients" button to transfer all but 1 of each item to player inventory, which is desirable for mods like Alchemical Knowledge which filters ingredients by effects in the potion brewing menu.
-Fixed case where one ingredient would not transfer if it was the last item in player inventory

Features in 1.0:
-The scripts recognize ANY ingredient in your inventory, whether original to the game or added by another mod.

This plugin REQUIRES MWScript Extender. This is an amazing tool, which was created by freshFish and greatly expanded upon by cdcooley. Without the enhanced scripting functions it provides, the features of this plugin could not have been implemented. You will need version 0.9.2 or higher; older versions don't support the new scripting functions used by this mod. Note: current versions of MGE XE should have MWSE integrated.

~~~~~~~~~~~~~~
Installing the Plugin
~~~~~~~~~~~~~~~~

To install, just extract the plugin archive into your Morrowind\Data Files folder. All files will be placed in their proper folders.

IMPORTANT: Because MWSE is required, you will need MGE XE which bundles MWSE (or if only using MWSE, run MWSE.exe, not Morrowind itself,) in order to play the game. Once MWSE starts, you'll be greeted with the familiar Morrowind Launcher and can continue normally. Consult the MGE XE or MWSE documentation for exact information on installation and use.

~~~~~~~~~~~~~
Playing the Plugin
~~~~~~~~~~~~~~

Downstairs in Balmora, Guild of Mages, you will find a curious object next to the podium, follow the soft red glow to the keg dispenser. There are no quests to perform or items to be purchased before you can get started. The kegs can be used as follows:

- Drop a keg on the ground at the desired location: This allows you to interact with it as a normal container.
- Interact with the container and choose "Open Container"
- Place at least one of each ingredient you would like to stockpile in the keg.
- Next time you interact with the container, if your inventory contains any more of the same ingredients, choosing "Restock Ingredients" will pull them into the keg.
- Using the "Dispense Ingredients" button will transfer all but 1 of each ingredient in the keg to your inventory, preserving your sorting system for next time you Restock.
- If you must relocate the keg, make sure it is empty before repackaging or you will lose the ingredients.

The kegs have a virtually unlimited capacity - they can hold quite a lot of ingredients. However, they will NOT accept any other types of items.

~~~~~~~~~~~~
Technical Notes
~~~~~~~~~~~~~

This mod should be compatible with just about any other plugin out there. It alters one cell (adds a keg dispenser to the Balmora, Guild of Mages downstairs classroom.)

~~~~~~~~~~~~~~~~~~~
Other Mods for Alchemists
~~~~~~~~~~~~~~~~~~~~

Alchemy Storage Helper by Scruggs, which adds a portable ingredient satchel updated with MWSE to carry ingredients added by any other plugin. I use this to declutter my inventory while out adventuring, then empty it into the kegs with my own sorting system at my stronghold.

Alchemical Knowledge
Apoapse's Alchemy
Poison Crafting
4NM Alchemy
Cyrodons Projectile Potions
AOF Potions
Alchemical Warfare

~~~~~~~~~~~~~~~~~~
Credit where credit is due
~~~~~~~~~~~~~~~~~~~

Alchemy Storage Helper MWSE Update created by scruggs (for the item transfer loop)
MWScriptExtender was created by freshFish and improved upon by cdcooley.
Scripts were edited and compiled using Dave Humphrey's MWEdit.
GhanBuriGhan compiled all accumulated knowledge of the Morrowind scripting universe in the modder's bible, Morrowind Scripting For Dummies.

Contact me by sending a personal message on NexusMods (nexusmods.com/morrowind/mods). My handle there is AstralJam8.