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

The Elder Scrolls III
MORROWIND:
Y.A.P.H.M. (Yet Another Portable House Mod)
Version: 1.0
by Tizzo

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

Index:
1. Installation
2. Playing the Plugin
3. Save Games
4. Known Issues/Conflicts
5. Revisions

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

1. INSTALLING THE PLUGIN

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

To install the plugin, unzip the files into the Morrowind directory.

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

2. PLAYING THE PLUGIN

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

To use this mod check the box next to YAPHM.esp in the Data Files menu of your Morrowind launcher.

This mod adds a portable home to the game. There is no special quest to do, or item to find, or spell to learn to access the home. Upon loading the game, everything needed to use the home is automatically added for the player.

To travel directly to the new home, please cast the scripted entry spell or use the following command:

coc "YAPHM, Main Room"

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

3. PLUGIN FEATURES

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

The home has the following features:

---

** Scripted Entry and Exit: Casting the scripted entry spell gives you the choice to teleport into the home or not. To exit the home, use the special "Exit Door" and you will be teleported back to wherever you were previously.

If needed, the player can also sneak while activating the door, which teleports your character to Seyda Neen. This feature is included in case the player somehow sets a Mark in the house, which would otherwise leave them stranded.

Please note, entry and exit of the home utilizes the "Mark" and "Recall" spell effects. Entering the home will over-write any Mark you have set.

---

** Alchemical Ingredient Sorter: This Sorter will sort Morrowind, Tribunal, and Bloodmoon ingredients. The Sorter is a single container in the form of a desk, located in the "YAPHM, Main Room" cell

To use the sorter, simply activate the container as you would normally, and select "yes" from the messagebox popup.

---

** Scroll Sorter: This sorter will sort nearly any spell scroll in the game. It takes the form of a small end-table next to the Alchemy Sorter desk. To use the sorter, simply activate the container as you would normally, and select "yes" from the messagebox popup.

---

**Soul Gem Sorter: a small box on top of the Scroll Sorter. Sorts any and all >Unfilled< Soul Gems, not including Azura's Star. To use the sorter, simply activate the container as you would normally, and select "yes" from the messagebox popup.

---

** Potion Sorters: There are two chests on the floor near the other Sorting containers. Rather creatively, they are labeled "Potion sorter: A through J" and "Potion Sorter: L through W". These two Sorters will sort most potions based on their effect into the respective container. Please note, these sorters will not sort spoiled potions, alcohols, or quest related potions. To use the sorter, simply activate the container as you would normally, and select "yes" from the messagebox popup.

---

(Please note, the various Sorters have a capacity of zero. To place any of their respective items into them, you must use the Sorter feature associated with the container.)

---

** Alchemy Desorter(s): A tray on top of the Scroll Sorter has several activator scrolls, which act as a convenient way to draw out any ingredients used to make the following potions from the Alchemical Ingredient Sorter:

-- Restore Health

-- Restore Fatigue

-- Cure Common Disease

-- Restore Magicka

-- Feather

-- Levitation

-- Water Breathing

-- Fire shield

-- Fortify Strength

-- Invisibility

The scripts used for this take into account your Alchemy skill. Any ingredients listed for the above potions found in "The Alchemists Formulary" will be removed from storage and added to the player inventory provided your base skill in Alchemy is > 5. All others will be removed and added once your Alchemy skill is great enough to actually see the effect on the ingredient itself.

---

** Music Box: Included is a special "Ornate Dwemer Music Box", based on a script from "Music Boxes v.3" by Xiamara, based on the version of the script found in "Ashlander Tent DX" by Gaius Atrius.

The script has been slightly altered to allow for the box to act as a standard container, and as an activator for the music menu script.

Activating the box normally will result in the standard container behavior, I.E. It will open, you can remove or add items to the container within the weight limit. If it is activated while the Player Character is sneaking, however, a script will run which allows you to select an .mp3 to play in-game.

Included with the mod is a set of small music files, provided with Xiamara's original mod, for testing purposes. These are to be replaced with the .mp3 files of your choosing.

The music box, being a working container, is a permanent fixture of the home.

To add your own music, simply rename your .mp3 files to the same filenames as the provided
music files, and put them in the "Music/YAPHM"' folder, instead of the originals.

Please note, the "Cancel.mp3" file should not be changed. If you do change it, overwrite it with the copy of "Cancel.mp3" found in this archive.

---

** Locking Chest: A small chest which can be locked by activating it while sneaking. If activated normally (not while sneaking) then the chest acts as a normal container. Oh, there's not a key to it, so you'll need to pick it open or use a spell.

---

** Shrine: A shrine which lets you cure diseases and poisons. You can also use to to restore your attributes. It's comparatively expensive to use though.

---

** Dwemer Stove: a Necessities of Morrowind compatible Dwemer stove. For flavor, the door is scripted to allow opening and closing.

---

** Ample Storage: About 3750 units, not including the infinite capacity of the various Sorters.

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

4. Save Games

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

This plugin should not invalidate your old saved games. If you remove the
plugin from a game already in progress, you will have to click through
all those error messages. However, you should be able to continue on afterward.

**Note: As a rule, you should backup all your saves before using this or any
other plugin, as a precaution against any strange error you might encounter.

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

5. Known Issues/Conflicts

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

-- Mods which change the TESCS IDs of various ingredients,
scrolls, etc. will break the respective sorters for those items
included in this mod.

-- The Alchemy Desorter scrolls may not get the correct ingredients
for a given potion if you use a mod which changes the
effects on alchemy ingredients.

-- "YAPHM" is a weird acronym. It sounds like "Yap Hum" in my head?
Go with that, I guess.

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

6. Revisions

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

Version 1.0

-- Inital Release Version. Yay!

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

7. Credits

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

Bethseda Morrowind Team -- For making a game that's kept me interested and entertained since 2002.

Dragonsong -- Interior building tutorials taught me the basics.

Phaedrus -- The various Sorters are based on the sorter found in his "Mudcrab Island" house mod.

Ghanburigan, Yacoby, Melian -- Morrowind Scripting for Dummies, an invaluable aid.

Nicholiathan -- Desorter script, modified slightly.

Qwert -- Editing the "Pocket Dimension Home" is what got me started using the TESCS.

UESP.Net -- For being such an awesome resource.


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

Any bugs should be reported to me as soon as possible, so they can be fixed.
You can PM me on the official forums.

This mod may be posted on other sites, provided that the site owner contacts
me for permission or I send it to him/her, and I am credited as the mod author.

Enjoy, and thank you for using my mod!