*********************************
The Elder Scrolls III
MORROWIND: Jasmine, a Morrowind Companion

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

Index:
1. Summary
2. Features
3. Requirements
4. Installation
5. Using the mod
6. Known Issues
7. Use in other mods
8. Unistallation
9. Credits
10. Contact info
11. version history

=======================================
1. SUMMARY
=======================================
This mod adds a female Redguard named Jasmine who will join you in your adventures provided you do her a favor first. I wrote most of her dialogue to revolve around the Main Quest (MQ), so those not doing it will miss out on quite a bit of the mod. She does have her own backstory and a few quests that you'll be able to partcipate in should you keep her around.

=======================================
2. FEATURES
=======================================
This mod uses Grumpy's companion template and scripting system - updated and improved by Melian - that includes companion leveling, levitation ability, warping and water breathing. Jasmine can be played by any level character at any stage of the Main Quest, but it is perferable to find her before you start the MQ.

Notes:

In version 1.12, I introduced a telepathy ring similiar to what Kateri's Julan mod uses. She will not give you the ring until you have a global reputation of three or greater. Once you do, talk to her to get the ring.

As of 2.7, Jasmine will only focus on her scouting skills:

Majors: Light Armor, Marksman, Restoration, Block, Long Blade.

Minors: Sneak, Unarmored, Medium Armor, Short Blade, Athletics.

She will also teleport with you if you use Recall or one of the Teleportation spells.

As of 2.5, Jasmine will now swap places with you if you ask her to take my place under her "change what you're doing" topic.

=======================================
3. REQUIREMENTS
=======================================
This mod requires Tribunal and Bloodmoon as well as Better Bodies version 2.0+, otherwise some of the clothing worn by the NPCs will look strange.

=======================================
4. INSTALLATION
=======================================
Copy the files in the Data Files folder into their respective folders:
JAC_Jasmine.esp goes into the main Data Files folder (\Data Files\).
The subfolders in the Icons folder go into the Data Files\Icons subfolder.
The subfolders in the meshes folder go into the Data Files\meshes subfolder.
The subfodlers and files in the texture subfolder go into the Data Files\Textures subfolder.
Select the JAC_Jasmine.esp file in the Morrowind launcher to play.

You can read more information on how to install mods here: http://forums.bethsoft.com/index.php?/topic/106063-morrowind-mods-faq/

=======================================
5. Using the mod
=======================================
To start the quest, speak to anybody in Seyda Neen about the latest rumors.

=======================================
6. KNOWN ISSUES
=======================================
This mod was not designed for players that choose to become werewolves or vampires. A vampire should have no issues playing with it, but those that choose to be a lycanthrope should not allow her to see you change. If she does, she will attack and report you as a werewolf. It is not recommended that you use any mods that change the Main Quest like Never say Never. The primary focus of this mod was its dialogue and while those mods won't break this, you'll miss out on a good portion of the new dialogue.

This mod may not work properly with MCA's love making or with the Romance mod due to how they operate. It will, however, work perfectly with Mr. Cellophane's Lovers and Legends and my update to that mod.

NOM users: this mod uses a number of resources from NOM and that mod should load after this one (have a later date). You can either use Wrye Mash to redate NOM or load it into the CS and save it without changning anything. I will keep the date of this mod the same throughout its updates.

This mod adds a house to the area northwest of Seyda Neen and may conflict with mods that add content there like Vality's grass mod. This mod also makes a change to Addamasartus and the Eight Plates in Balmora by adding NPCs to them. It also adds a house outside of Ebonheart and a Dwemer style tower north of the Ahemmusa Camp.

Caius will not talk to you if Jasmine is in follow mod. If you leave her somewhere while teleporting, you will need to use her telepathy ring to have her stop following. She has unique greetings depending upon what quest Caius has you performing when you retrieve her from the Eight Plates in Balmora.

There is a 72-hour bug in which NPCs are reset if you do not talk to them at least once in any 72 game hour period, or if they are not within the same cell as you. If you don't talk to Jasmine at least once every 72 game hours, her teleportation ring may cease to function. You can use Jasmine's telepathy ring to contact her once every 72 hours or so if you need to leave her somewhere.

The scabbard for Deandre's scimitar uses the left pauldron slot. This was so that it would show up on the outside of any clothing worn. It may clip with certain non-BB clothing and any clothing that uses the neck slot. You'll have to mirror any pauldrons if you want to wear two.

Though Jasmine will teleport with you whenever you use Recall or one of the Intervention spells, she will only do so if you teleport to an exterior cell because of an engine limitation.

=======================================
7. USE IN OTHER MODS
=======================================
Most of the resources in this mod are modder resources and do not require permission to use provided you credit the original authors and include their readmes. The stories in this mod are written by various authors and you should contact them if you wish to reuse them. "The Sage of Torrin" and all of the poems are written by me and I ask that you contact me should you wish to reuse them in your mod. I do not mind giving consent, but I would like to know where my work is being used.

=======================================
8. UNINSTALLATION
=======================================
To properly uninstall this mod requires either using Wrye Mash's repair all function or the Morrowind Code Patch's saved game cleaner. This mod will likely invalidated your saved games unless you clean your save.

To uninstall:

1. Remove everything from Jasmine you want to keep.
2. Save the game and exit completely.
3. Load Wrye Mash and uncheck the mod.
4. Use the Repair All function to remove all traces of the mod.
5. Load your save and click past any errors, they won't show again.

If you are using the MCP, follow steps 1&2, but use the launcher to uncheck the mod. Load as normal and click past any saves.

=======================================
9. CREDITS & THANKS
=======================================

A special thanks to:

Elaura for all of her help and support and for beta testing the new additions.
Cyrano for helping me with my many dialog questions. If it weren't for him, this mod may never have happend.
Anais for helping with the initial groundwork on this mod and for her work on the Tall Papa series.
Aldert for initial Alpha testing and feedback.
Harborgolfer for creating the faces for me.
Shasta Tharne for creating Jasmine's house.
Talyn82 and Loriel for helping to beta test version 2.0.
Chocolate Mouse for helping beta test and for providing suggestions for improvments.
Chengiz Khan and Lyssia for helping beta test.
Apophis2412 for betatesting and providing error feedback and improvement ideas.
Glasseyed for beta testing and suggesting improvements to Jasmine's dialog.
Forest Stalker for helping out with the dialog and providing ideas for quests.
Emma and Kateri for giving me the inspiration for doing this mod as well as helping out with my many questions.
Stuporstor for writing Jims's dialogue.
Dingo/Dingosky for creating Jims's and Lariah's house.
Sethyas Velas, Redsrock, Canis216 and Marcel Rhodes for allowing me use of their stories.
Grumpy for his companion system. R.I.P my friend, you are missed.
Melian for all of her scripting help.
Sethyas Velas/Black Hand for his stories and for finishing the Tall Papa series.
Hicks233 for helping to beta test.
Everybody at Great House Fliggerty and the official forums for helping me stay motivated and getting this done.

Credits:

Bethesda for making this great game.
Jasmine's head is Playboy Playmate Miss December 2006, Kia Drayton.
Charon's head is the artist Prince.
Waylas's head is the actor Denzel Washington.
Elaura: Making spelling and grammar changes and suggetions and beta testing.
Emma: Deandre's, Jim's, Lairah's and Lorit's heads; Warren's and Astrid's heads, hairs and bodies. Refer to her CoM2 readme for full credits. Lorit's face was retextured (darkened) by me.
The Better Head's team: Deandre's, Jim's and Lairah's hairs.
Andyguy: Charon's hair and Jim's and Charon's ears.
Louis/Ren: Jasmine's hair, physiqued by Gagatek. Also Lorit's hair.
Gagatek: extra hair colors for Jasmine.
TommyKhajiit: Charon's rapier.
dongle: Adamantium Towershield & bathtub
Truthsnark: Deandre's, Jim's and Charon's shirts.
Korana: Bath soaps, bath oil and ladies' wearable towels. Deandre's pants and boots are from her Falconeer's outfit.
Faylynn: quilted bedspread texture
kittybrod: stained-glass lantern, red folded and open cloths
Earth_Wyrm: icon for the stained-glass lantern
Phijamma: decorative wooden bowl and plate
Barabus: brass kettle and saucepan
Calislahn: frying pan
The Wanderer: 3-shelf bookcase.
Clavis: Rug in the basement.
Lord Yig: tapestry.
Gianluca: Large rug in the main room.
Pheobe: blue pots, bowls, flasks, vase and cups in bedroom.
LadyE: fruit, as used in "Necessities of Morrowind" by Taddeus & Nymeria.
CrazyBoy: grill.
Nelothsmouth: barrels.
Paschors: Brocade chair.
Princess_Stomper: the kitchen stove and adjacent counter was inspired by the contruction of same in various homes in "Leyawiin".
Khan Raider: silver katana mesh and textures.
Sethyas Velas: custom books and "The Walkabout" books III & IV.
Anais: "The Walkabout" books I & II.
Dingo: Jasmine's parent's house.
Redsrock: "Cyrus the Restless and the Killing of Hakan" book.
Canis216: "In the Heart of the Alik'r" book.
Marcel Rhodes: "One Shot" book.
Plangkye: Lariah's and Lorit's dresses and boots.
Dragon Lance: Deandre's sword and scabbard.
Cydine & Maboroshi Daikon: Book rotate scripts.
Andres Indoril: Lorit's Mansit tower.
Alaisiagae: new adamantium tower shield mesh based on LadyE's and Dongle's work.
Abot: Helping with fixing dialog errors and corrections.
TheSkyMOves: Helping with bug testing.

If I missed anybody, it was purely unintentional. Please email me and I will add you into the credits. Thank you.

=======================================
10. CONTACT
=======================================
You may contact me either via email at [email protected] or via GHF or the official forums under the username "Jac". If you email me, please put "Jasmine" somewhere in the message title or I may delete it as spam.

=======================================
11. VERSION HISTORY
=======================================

1.0
Initial release.

1.10
Fixed spelling issue in the Hortator topic.
Added scripting subroutine to help prevent Jasmine from becoming stuck.
Corrected hair mesh for Jasmine.

1.11
Fixed "Where's Jasmine" topic. Asking Elone where Jasmine is will cause her to appear in front of her house.
Fixed looping dialogue with the "my family" topic.
Fixed looping dialouge issue with the "Use what I use" dialogue option under the Combat Techniques topic.
Added silver katana to various merchants.
Added ebony katana to Waylas.
Add four new books by Sethyas Velas and quests to recover them.
Added a scroll by Sethyas Velas to the Morag Tong guildhall.

1.11a
Fixed bug in the dialogue results box that may prevent Jasmine from rejoining after Charon is dead.
Changed some of Jasmine's topics so they will show up at the top of the topics list.

1.12
Fixed Jasmine's responses to the Vivec informants quests.
Added exclusive healing potions to Waylas and Charon.
Increased Waylas's level.
Added potion saver scripting routine to Jasmine to prevent her from drinking all of her healing potions at once.
Added a telepathy ring. Jasmine will gift it when you reach a global reputation of at least 3.
Added an alternative leveling system by Melian.
Added the ability to determine a few of Jasmine's skills through dialogue.

1.13
Fixed telepathy ring dialogue: changed "loose" to "lose".
Fixed journal filtering for Hassour's thoughtful gift topic.
Added unique dialogue for the Orvas Dren topic.
Lowered the weight of Charon's rapier from 40 to 15.
Fixed typo in the responses to one of Elone's greetings.
Revamped Jasmine's script (thanks to Melian). Jasmine should no longer dissapear when going through doors with other NPC companions in tow. Added new spells used by the scripts and removed uneeded ones from Jasmine. She'll still teleport, swift swim, water breath, etc. as necessary.
Revamped Jasmine's following Ai while levitating, swimming, etc.
Added slowfall Ai scripting and spells.
Added script routine by Melian to move Jasmine from the player when using fast tranport (ships, Silt Striders, Mageguild guides).
Added the spell "Heart Heal" to Jasmine to help increase her survivability in melee combat. She will not cast it on the player.
Changed the default leveling script to add back in magicka for Jasmine; decreased her Destruction to 5 to prevent her from casting area of effect spells.
Added a missing book from a quest to a rogue Ashland camp. The book will update the journal if the quest is active.

1.13a
Fixed Deandre's greetings to prevent some topics from not showing.
Fixed Hassour Zainshbani's dialogue topic.

1.14
Fixed Deandre's greetings to prevent some topics from not showing if you first greet him after you have a global reputation of 15.
Revamped Jasmine's following routine to fix possible issues with other NPC companions also following.
Added dialogue to Jasmine concerning Deandre's book retrival quests.
Added extra dialogue to the Waylas and Charon confrontations. It is now possible to change your mind.

2.0
Changed contact email address.
Overhauled Jasmine's greetings to better fit the new content.
Added in romance quest for male players. Female players will still be able to do Jasmine's main quest, but will not have the romance options.
Added in Jasmine's parents and a house for them outside of Ebonheart.
Added in two teenagers from Emma's Children of Morrowind mod.
Fixed numerous dialouge errors and added additional dialogue.
Added in a dress by Plankgye for Jasmine's mother, Lariah.
Changed Jasmine's follow scripts to Melian's new versions.
Fixed potential issue with breaking the game if you ask Elone where Jasmine is before Jasmine offers to join you. Elone will not have this topic until Jasmine offers to travel with you.
Fixed possible CTD issue with Deandre's "The King's Pardon" dialogue topic.

2.0a
Added additional dialogue revolving around the disturbing dreams during the Blades' quests and a few wilderness quests (e.g. The Death of a Tax Payer in Seyda Neen).
Fixed issue with female characters and male characters not engaged in a romance from being able to have Jasmine continue to follow after her quests were done.
Fixed journal naming issues.
Removed redundant dialogue from Deandre's Weary Warriors topic.
Renamed "Unsinged Warriors" to "Unsinger Warriors".
Fixed issue with rescuing Malexia before getting Tall Papa book quest for Sason.
Deandre will now mention where Jasmine's parents live when appropriate.
Fixed a journal entry not being given during one of Jasmine's quests.

2.1
Fixed an issue with Jasmine's follow speed - she should now stick closer to you while traveling.
Added dialog for the various Imperial Legion quests. Jasmine's disposition will raise or lower based on how you complete some of the quests. Hint: she doesn't like it when you bully widows.
Added a scimitar to Deandre and an additional quest to him. After finishing it, you'll recieve his scimitar (same stats as an Ebony scimitar, but it's not enchantable due to the textures used on it).
Added a dialog option to have Jasmine level if she's able without your having to sleep. She will only level her skills to your level. Also, her health will reset to its max. I inlcuded this option for mages who use the Atronach birthsign and the GCD mod - basically anybody that doesn't rest often or to level.
Jasmine's disposition will now increase after you do each of Deandre's quests.
Fixed various typos and other small bugs and included new dialog to various NPCs to flesh out thier character.
Added a new quest. Talk to Deandre after you have retrieved the fourth Tall Papa book. Also added a new NPC and Dwemer tower ruin.
Added new mesh for the adamantium tower shield Waylas wields.
Add new hair colors by Gagatek.
Added the Book Rotate scripts to Jasmine's and Deandre's books.

2.1a
Fixed various dialog bugs.
Fixed errors introduced in version 2.1.
Added missing textures and meshes to the archive.

2.1b
Fixed the book rotating system.
Fixed the sheathed version of Deandre's scimitar.
Added dialog for the Dark Brotherhood attacks and hunt.

2.2
Fixed numerous spelling and grammar issues.
Added an option to send Jasmine home via her "change what you're doing" dialog.
Added some compatibility features for a forth coming companion.

2.2a
Fixed a error in one of Deandre's greetings.
Added the ability to send Jasmine to Mournhold via her "Change what you're doing" dialog topic. Jasmine will now appear near the center of the five areas of Mournhold.
Added additional dialog to Jasmine's family concerning Charon.
Fixed minor dialog errors.

2.3
Removed [DELETE] messages from certain topics.
Fixed Jasmine's closet from equipping her if she's not following.
Fixed a dialog error for Sason when asking him about Deandre's books if you've previously rescued his wife.
Removed the "Where's Jasmine" topic from Elone if Jasmine is following you.
Fixed the "Nelos Onmar" topic: Jasmine no longer mentions helping Maurrie Aurmine if the quest isn't active.
Fixed Deandre's "Recovering some books topic." You can now decline his initial task.
Fixed minor dialog errors.

2.3a
Fixed greetings for Waylas after first meeting.

2.4
Added in a final quest for Deandre. You'll have to have found all of the Tall Papa books and convinced Surane to allow him to court her.
Fixed potential bugs with the journal not updating after defeating Waylas and Charon.
Removed certain topics after Jasmine comments on them.
Fixed Jasmine's telapathy ring.
Fixed spelling and grammar issues.

2.5
Fixed spelling and grammar issues, and possible dialog crashing errors.
Fixed an issue with Jasmine not leaving Caius' house consistently.
Added take my place option under change what you're doing topic.
Fixed repeating journal entries after killing Charon.

2.6
Fixed spelling and grammar issues, as well as a book naming inconsistency.
Fixed Jasmine's greetings not displaying while in the Eight Plates after talking to Caius about the MQ.
Applied Slartibartfast's texture fixes. His mod is not required to play this one.

2.7
Removed an issue with repeating journal entries caused by Charon's death.
Fixed Deandre's greetings when returning his statue.
Removed Jasmine's ability to follow the player's lead; she will only focus on her scouting skills now and tweaked the script to increase her health.
Added in the ability to have Jasmine follow you when you use Recall or one of the intervention spells (customs spells are fine).

2.7a
Fixed a CTD when talking to Jims after Charon is dead.
Fixed an option to ask Surane for Deandre's book without asking her to reconsider his advances.
Fixed the mention of "The Unsung Warriors" book by Deandre and mentioned where Raul is located.