Name: Kajsa a Troll Companion
Version: 1.5
Date: 3/16/2010
Category: Companions
Author: Joben

=================
Requirements:
=================

Oblivion 1.2.416

=================
Description:
=================

A innovative troll companion to go adventuring with.

=================
Details:
=================

Say hello to Kajsa.
Her name comes from Ysatters-Kajsa, a troll is Scandinavia mythology.
She is high quality companion creature with several innovative features.

When you activate the mod you will be given the summon power.
You must use this spell to call her into the game world the first time.

Control:
You can tell her to follow, stay, or go to a home location that you define.
If you want her back there is a summon power, or a quest arrow so you can locate her.

She has a unique Multi-Click control system.
If you click Use on her once it toggles Follow/Stay.
If you double click it opens an orders/options menu.

If she gets into a fight with a friend, the first click should stop it.
If the fight is with a hostile enemy you probably won't be able to get her attention.

If you want her to attack something you can mark the target with a special ranged spell.
Or you can shoot it with an arrow poisoned with special Troll Bait
A bait proccessor is provided so you can brew troll bait from common ingredients.

Follow Behavior:
Her follow AI is carefully scripted.
If she is very near the player she will wander slightly and look at things.
If she starts to fall behind, or if you start running, she will run up to you and follow closely.
If she falls significantly behind, she will speed up.
If she gets stuck far behind, as so often happens to followers in Oblivion, she will quietly teleport in behind you when you aren't looking.
If the player sneaks she will sneak also.

Combat and Death
Kajsa is "Almost-Essential" (tm) ;)
If she is defeated in a fight she will stay knocked out until the fight is over, then she will recover.
This is more balanced than just being Essential, more convenient then a resurrection kit or spell, and far more immersive than either.
If she is incapacitated outside of combat she will recover in about 30 seconds.

She has a modified combat style and is somewhat more lethal then a standard troll.
You can tell her try to stay nearby in fights, and/or not pursue fleeing enemies.
But she's just a troll and doesn't always obey perfectly.

Health, Stats and Abilities
She is always 2 levels less than the player, within minimum 2, maximum 42.
Her stats are set using the leveled "Hard" and "Very Hard" Azhklan Trolls as references

She has water walking because trolls have no swim animations.
Trolls have a natural health regeneration, Kajsa heals faster than normal trolls.
She has an ability which will repair any Damage Attribute effects.
She has several small resistance perks to make her more suited to heavy combat, but retains a normal troll's heavy weakness to fire.


=================
Installation
=================

1. Extract this archive to any folder and then copy the contents to Oblivion's Data folder.
2. Start Oblivion Launcher, click Data Files, and enable the .esp file(s).

=================
Un-Installation:
=================

1. Start Oblivion Launcher, click Data Files, un-check the .esp file(s).
2. Delete the files/folders associated with the mod.

=================
Upgrade:
=================

This version contains several new features you will NOT GET unless you do a cleansave.

1. De-activate the mod, load, save and exit.
2. Activate the new version, load and play.

=================
Incompatibility:
=================

Do not use the mod Teach Spell To Others on the companion critter.
It doesn't work on animals anyway More importantly the spell's script interacts
with the critter's menu system is a bizarre and unpredictable way.

=================
Known Problems:
=================

Very rarely, when reviving after a battle in which she was knocked out Kajsa will get stuck in place.
If you know why this happens, or discover any sort of repeatable circumstance that triggers it please let me know!

You can fix it by opening the console, clicking on her and typing entering the following command: Resurrect 0

=================
History:
=================

3/16/2010 - 1.5 - New stable Relz

Tweaked resistances.
Cleaned up testing debris.
Shelved wonky "play dead tactic" concept for now.

3/12/2010 - 1.4c - Testing results implemented

Critter leaves/won't enter Sneak mode if in combat
Added "Attack and Play Dead" test spell
Increased Stay Near distance to ~1500 units
Adjusted distance checks on StartCombat spell

3/09/2010 - 1.4b - Testing results implemented

Increased Stay Near distance to 1024 ( ~16 yards/meters)
Moved all death handling to quest script
Kajsa will stay knocked out no less than 30 seconds
Small boost to starting HP
Poison maker produces ingredients now, brew your own bait poisons

3/08/2010 - 1.4 - New Features For TES Alliance Beta

Added Start combat spell
Added Troll Bait Poison and maker
Improved Wander Near behavior.
Added Double-Click control system.
Significantly re-organized and optimized script.
Replaced Essential status with scripted Revive-After-Combat function.
Added combat behavior options: Stay near me and Don't chase fleeing enemies.

x/03/2010 - 1.3 - Unreleased minor tweaks

3/03/2010 - 1.2 - Tweaks

Improved combat style
More protective of player
More complex follow behavior

2/15/2010 - 1.1 - Public Release

Re-wrote messages to be more immersive and in first person.
Gave Kajsa water walking because trolls have no swim animations.
Tweaked Kajsa's stats and size.
Misc minor script optimization.
Added code to make Kajsa sneak when PC does.

2/14/2010 - Private Release

Follow, stay, go home and set new home behavior implimented.

=================
Contact:
=================

Joben on TES Alliance or the Bethsoft boards.
SrJoben on TES Nexus.

=================
Credits:
=================

Thanks to Bethesda for creating Oblivion.
Thanks to InsanitySorrow for his ReadMe Generator this file is based on.
Themythofstrider for Mythic creatures.

=================
Tools Used:
=================

Insanity's ReadMe Generator
TES Construction Set
TES4Gecko

=================
Contents List:
=================

SRJtrollKajsa.esp
Creatures/Troll/Fluffytroll.nif
creatures/troll/FluffyTroll.dds
creatures/troll/FluffyTrollAlpha.dds

This is the same model and texture paths as the troll in my Riverbend House mod.
So if you happen to have both and want to uninstall one, leave the nif and dds files or you'll break the other too.

=================
Licensing/Legal:
=================

You must contact me and obtain my permission before re-packaging any part of this mod. If I do not respond within 4 weeks, feel free to do whatever you like with this mod.