NPC Auto-Leveller 1.0

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
» NPC Auto-Leveller 1.0 Read-Me
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
NAME: NPC Auto-Leveller
TYPE: Modder's Resource
VERSION: 1.0
DATE RELEASED: July 2, 2017

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
» DESCRIPTION
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
A while back, Darth Tyren was asking me about how the KotOR 2 balances the enemies to make them tougher as you go on through the game. We then spent a few hours running some tests and digging through the files, with the end result being that the game seems to just upgrade the enemies' Hit Points and Force Points.

I then theorized that one could use the extra functions Obsidian added for modifying your skills, attributes, feats, and force powers to work up a framework for levelling up the NPCs without actually assigning them levels. This is the result of that work.

The heart of this modder's resource is the "fs_level.nss" #include file, where I've one main function called LevelUp and several support functions that will randomly assign feats, force powers, skill points (including support for cross-class skills), and attribute points at the appropriate times and in the appropriate amounts. I've scoured the various .2da files and the all of the default values and rules that the player has to obey are obeyed by the script as well.

Also, there are 750 .uti files included. There are 50 for each class, and each item handles the defense, saving throw, and attack modifier increases that a given class would get as they level. These items are not accessible or equippable in-game, as they use the hidden creature slots (specifically, slots 14 and 15).

I've shown how to use the #include file in the included "k_ai_master.nss" in the source folder. The compiled form is included in the installation.

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
» INSTALLATION
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
An installation which involves the TSL Patcher has been made ready for your use and is the simplest and easiest way to carry out installation.

You don't have to use the installer if you're just using parts of this or adapting it, but it's an easy way to get it all set up and ready to go.

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
» KNOWN BUGS
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Not exactly a bug, but the two slots I used may very well be used by animals like the Kinrath that have special properties to their attacks.

There are 2 ways to report bugs:
1: Post your issues in the Bug Reporting Thread.
2: PM your issues to Fair Strides at Deadlystream.

TO REPORT THROUGH PM

1) Go to DeadlyStream ( http://deadlystream.com/ ) and search for the user Fair Strides ( http://deadlystream.com/forum/user/9107-fair-strides/ )
2) Send a private message with as much detail as possible of what is occurring in your game. He will likely report back to you within a week.

TO REPORT THROUGH THE BUG THREAD:
1) Go to the Bug Thread ( http://deadlystream.com/forum/topic/5509-downloadnpc-auto-leveller/ )
2) Reply with as much detail as you can provide, and please list (and preferably link to) all the mods you're using.

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
» CONTRIBUTORS / CREDITS
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Darth Insidious, Malkior, Markus Ramikin, Darth Tyren, and probably many others who were willing to discuss the topic with me over Skype.

Darth Tyren for the initial investigative work and the idea itself.

90SK for some installer help on my Fumble! mod, whose changes.ini file I edited in Notepad for this mod.

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
» REDISTRIBUTION
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
This mod may be re-distributed, but may not be re-uploaded. I request that proper credit be given to me for making the mod, even if you use parts of the mod instead of the whole thing.

I would also like to be contacted before you release your mod.