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

The Elder Scrolls III
MORROWIND:
Wolf Companion, Kolka
Version: 2.5
by Tizzo

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

Index:
1. Installation
2. Playing the Plugin
3. Plugin Features
4. Save Games
5. Known Issues/Conflicts
6. Revisions
7. Upgrading From Previous Versions
8. Credits

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

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 KolkaWolf.esp version of your choice in the Data Files menu of your Morrowind launcher. Please select only one version of the mod to use!

This mod adds "Kolka the Wolf" to your game.

Kolka is a trained wolf, found in the Rethan Ancestral Tomb. This is a new tomb, and is found near the Odai Plateau, close to a certain lost ebony mine.

Kolka is difficult to kill, hard to lose, and can even carry a little bit of stuff.

She will also fight beside you. Try not to trip over her, give her plenty of treats.

(It's not a very complicated mod to play.)

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

3. PLUGIN FEATURES

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

Kolka has Five versions, one for each model of wolf: Black, BoneWolf, Hircine, Red, and White.

Please only use one!

Your new woof has several useful companion scripting features:

- Will warp behind the player if she lags far behind.
- Can warp with you when you use Recall, Intervention, or scripted teleports.
- Can be summoned to your location with her magic chew-bone.
- Can be instructed to Wait or Follow by sneaking and activating her.
- You can easily swap places with Kolka by jumping and activating her while doing so.
- You can swap places with Kolka (if you are stuck in a doorway for example) via dialogue.
- You can inspect her stats, and see how your buddy is doing (in the "Health" menu).
- Kolka can be set into 'Durable Mode' via dialogue, making her functionally invulnerable.
- Kolka levels with the player, her stats increase as your character's stats increase.
- Kolka levitates and water walks with the player.
- Kolka can be healed with potions via dialogue.
- Kolka can do tricks: Sit, Lay Down, Heel, Howl, and Play Dead!
- Kolka has 'Potion Saver' code, meaning she will not drink all your health potions.
- Players can ask a Guard where Kolka is located, and she will be warped to a nearby tavern.
- There is a wide variety of commentary on your new buddy (based off Race/Class/Other).
- Ask around via the "-^ My Wolf ^-" topic!

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

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

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

-- Kolka can get stuck in an 'animation loop' which causes attack noises to constantly play. This is quite rare, and is an engine based bug. To resolve this issue if it happens to you during play, use Kolka's bone and the issue should stop.

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

6. Revisions

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

Version 2.5

-- Script edits to bring code in line with other creature companions I've authored.

-- Various fixes and typo edits.

-- Additional urn added to tomb cell in honor of a recently lost family pet.

-- Model changes on some chests in the tomb cell.

-- Addition of 'Worg' version of Kolka.

Version 2.2

-- Clarified what is considered a "treat" in the dialogue.

-- Renamed two chests in the "Rethan Ancestral Tomb" cell to draw attention to them.

-- Other stuff I am probably forgetting.

Version 2.1

-- Kolka will now "Shift It!" regardless of what animation is currently playing.

Version 2.0

-- Renamed 'Kolka Iron-Fang' to 'Kolka the Wolf'.

-- Added Bone Wolf and 'Hircine Wolf' model and skin options.

-- Moved the whole tomb part of the mod into it's own, unique cell: Rethan Ancestral Tomb.

-- This new tomb is near Balmora, close to the Vasir-Didanat Mine.

-- Added rocks to make the new tomb entry reachable without having to edit landscape.

-- Removed latest rumors edit from Khuul, since the whole thing is in the Balmora area now.

-- Remove vampire from the premises.

-- Added tributes to various modders that have passed over the years.

-- Added a 'Return Home' amulet to the tomb.

-- All permacorpses in the mod now have the option to disable them via sneak and activate.

-- Tweaked scripts to fix bugs with the Companion and to correct oversights.

-- Tweaked damage values on Companion to account for other bug fixes.

-- Added a couple skippable encounters to the Tomb in lieu of removed vampires.

-- Removed 'Iron-Fang Sword' and replaced it with a Devil Katana.

-- Other stuff I am probably forgetting.


Version 1.0

-- Initial Release Version. Yay!

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

7. UPGRADING FROM PREVIOUS VERSIONS

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

Unload Kolka and set her to wander in another cell. Save, then exit the game.

Uncheck the old version and make a new save with the mod unloaded.

(It helps to "clean" your save with an external tool like Wrye Mash at this point.)

Exit the game again, check the updated version of the mod.

Load the clean save, go back to the Alen Ancestral Tomb, and collect Kolka again.

... Maybe give the little gal a treat for being a good sport about the whole ordeal.


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

8. Credits

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

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

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

Greatness 7, Emma, Grumpy, DinkumThinkum, others -- Various pieces of code, dialogue, information, inspiration, and a host of other things. Thanks, everyone!

UESP.Net -- For being such an amazingly useful resource.

Danae -- Lots and lots of constructive feedback, help testing, and being awesome.

abot -- Helping out with code fixes, the 'bump' script, and generally being a great person.

Melchior Dahrk -- "Worg" model for Kolka, being awesome.

Stripes -- Their "Creature Casting Animation Patch" is the base animation file for Kolka.

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


Any bugs should be reported to me as soon as possible, so they can be fixed.
You can PM me on the NexusMods forums, message me on the Morrowind Modding Discord, or message me on Reddit (as "TizzoHeavy")

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!