Recruit HK-47 on Taris v1.0
======================================


By brents742
============


Version Notes
=============
v1.0 - 8/10/2021
- Initial release

Requirements
============
None

Installation
============
Run TSLPatcher.exe and follow the prompts.
The patcher will make backups of any existing files you may have that are the same as files this mod uses.
Keep track of this backup folder - which will be located wherever you have the TSLPatcher.exe running from.

The only override warning you might get during installation is for k_ptar_opengate.ncs.
This will be already present in your override folder if you have my Recruit T3-M4 early mod.

Uninstalling
============
Copy and paste the original backed up files of tar_m02ac.rim, tar_m02ac_s.rim, tar_m02af.rim, tat_m17ac.rim, and tat_m17ac_s.rim that
the TSLPatcher made during installation into the Modules folder within your swkotor directory.

Description
===========
-This mod allows for recruiting HK-47 into your party as early as possible (Taris) in a way that does not interfere with the story arc.

-Yuka Laka is trapped on Taris by the Sith Quarantine! Kebla Yurt has graciously allowed him refuge within her shop until the occupation lifts.
Yuka needs credits and he needs them fast, so he offers HK-47 for purchase on Taris if the player has enough credits. How will he escape and make it back to Anchorhead???

-Some additional dialog has been added to Yuka Laka on Taris and Tatooine.

-HK-47 will appear in your Taris apartment after being recruited.

-Nothing has been removed from the game. If you want to wait until Tatooine for HK-47 to enter your party as normal, you can still do that.

-This mod simply adds the ability to purchase HK-47 from Yuka Laka on Taris instead of waiting to do so on Tatooine.


Getting Started
===============
This mod works best from a new save.

Loading an existing save will have the game call up cached information for the module Yuka Laka and HK-47 appear in (tar_m02ac) and they will not appear.

There are ways to delete this cached information but, again, just starting a new save is best.

Important - Timing
==================
If you do not purchase HK-47 before going to Davik's estate, your next available opportunity will be on Tatooine as normal.

Compatibility
=============
IMPORTANT - This mod makes changes to the following modules:

tar_m02ac
tar_m02af
tat_m17ac

A mod that makes changes to the above modules, both the .rim and s.rim variants, should be fine so long as this mod is installed after it.

As an example, a mod that changes tar_m02ac.rim's m02ac.git file may cause HK-47 and Yuka Laka to no longer appear on Taris if that mod overrides entirely your existing file.

The main takeaway is to be cautious during install. If there are any override warnings, stop what you are doing and let me know.

If you run across a mod that this mod seems to conflict with,
please let me know and I will work to update this mod to address it.

What Specifically does this mod do?
===================================
-k_ptar_opengate.ncs (found in your override folder after installation of this mod, or already existing if you have my Recruit T3-M4 early mod, allows for three party members to exit the Outcast camp, as vanilla only included MoveTo instructions for the Hendar scene to two party members as that is all you were meant to have at that point in the game.

-m02ac.git was modified (within tar_m02ac.rim) to place waypoints for Yuka Laka and HK-47 to spawn in Kebla Yurt's shop.

-m02af.git was modified (within tar_m02af.rim) to place a waypoint for HK-47 to appear in your Taris apartment like the rest of your party members.

-tar_m02ac_s.rim -Modified to include the necessary scripts present within tat_m17ac (Yuka Laka's Anchorhead shop) to allow for the proper recruitment of HK-47.
-Modified to include dlg files (tar17_08hk57_01 and tar17_08yuka_01 respectively) that mimic the same dlg files in tat_m17ac but changed where needed to reflect the Sith Occupation of Taris.
-Modified to include utc files (tar17_08hk57_01 and tar17_08yuka_01 respectively) that mimic the same utc files in tat_m17ac.
-k_act_hk47bought.ncs is a script that was created to set boolean KES_HK1 to indicate HK-47 has been purchased on Taris.
-m17ac.git was modified (within tat_m17ac.rim) to reflect the location of a trigger that will remove the HK-47 UTC from Yuka Laka's shop if and only if he has already been purchased on Taris.
-tat_m17ac_s.rim -Modified Yuka Laka's dlg file (tat17_08yuka_01) to give Taris specific dialog if HK-47 was purchased on Taris. Otherwise, regular dialog will trigger.
-New trigger UTT file created that will fire script k_ptat_killhk47.ncs that removes the HK-47 UTC from Yuka Laka's shop if and only if he has already been purchased on Taris.
-k_con_hk47join.ncs checks to see if KES_HK1 boolean is true, and ensures Taris specific dialog only fires the first time the player speaks with Yuka Laka on Tatooine.
-k_act_hk47join2.ncs flags HK-47 as having been purchased locally so Yuka Laka (Tatooine version) does not mistakenly believe he still has an HK-47 unit to sell you. Also sets Yuka Laka as having been talked to for the first time to prohibit Taris conversation every time you speak to him.
-Created the following Booleans:
KES_HK1 boolean - flags when HK-47 has been purchased on Taris. This is reflected in globalcat.2da changes that TSLPatcher makes during install.

Permissions and Disclaimers
===========================
I, brents742, reserve the right as author of this mod for sole permission to upload some or all of this mod
anywhere for any reason.

If you would like to include any part of this mod in anything, then please
contact me for permission.

The user of the mod is responsible for any damage to their game that may result from using this mod.
Users are encouraged to make relevant backups and do their research on existing mods they have installed
to double check compatibility. All efforts have been made to ensure this mod is as unobtrusive as possible
but ultimate responsibility lies with the end user to check for possible conflicts before installing.


Special Thanks
==============
Fred Tetra - KOTOR Tool

TK102 - DLG Editor

Stoffe and Fair Strides - TSLPatcher

Prydeless for their pink lightsaber mod that inspired me to begin modding to begin with.

The entirety of the DeadlyStream modding forums for their inexhaustible resources and information
that allows anyone with a computer and an idea to sit down and learn how to make their first mod.

Lucasarts, Bioware, and Obsidian for making a game I am still funneling dozens of hours into
nearly two decades after its initial release.

Contact
=======
PM me on Nexus or DeadlyStream or alternatively post on the mod itself and I will get back to you.