T3-M4 Lightsaber Construction Mod 1.2.0

Tired of missing a lens? T3-M4 can help! You can have a lightsaber as early as your first trip to the Ebon Hawk in a way that fits in with the story & adds additional dialogue & immersion to the game. You can construct as many lightsabers as you have crystals!

UPDATE: Reconstruct Visas Marr's destroyed ligthsaber via T3-M4 for some added dialogue and influence gain/loss options with Visas when you give it back to her.

T3-M4 Lightsaber Construction Mod v1.2
======================================

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

Version Notes
=============
v1.0 - 3/4/2021
     - Initial release
    
v1.1 - 3/7/2021
     - Added ability for T3-M4 to rebuild Visas' lightsaber and place in player inventory after Visas joins the party
     - Created new dialogue with Visas via existing sound files for returning her lightsaber
     - Added new influence gain/loss options with Visas when returning her lightsaber
    
v1.2 - 8/10/2021
     - Updated M4-78 compatibility to properly display T3's dialog options for the planet
     - Grammatical errors corrected when returning Visas' lightsaber to her

Requirements
============
TSLRCM 1.8.5 or above

Installation
============
First, it should be noted that using Steam Workshop is NOT recommended as it can cause any number of issues during your playthrough. Especially with TSLRCM.
With that in mind, if you are using Workshop mods, follow the Steam instructions below versus the regular install instructions.

REGULAR TSLRCM INSTALL USERS:

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.

TSLRCM + M478 INSTALL USERS:
You will need to go into the download files and copy the t3m4.dlg file from the M4-78 folder within the folder called Compatibility.
Drop this in your respective override folder after regular install of this mod. Failing to do so will cause M4-78 to not be accessible as T3
will lack the dialog options to unlock the planet without this file.

TSLRCM INSTALLED FROM STEAM WORKSHOP USERS:

When installing with TSLPatcher, you MUST select your Steam workshop TSLRCM directory. Not the main KOTOR 2 directory. When asked by TSLPatcher to browse for a folder, go to your main Steam folder, then steamapps. Then workshop. Then content. Then 208580 (This is KOTOR 2's game code) then find the TSLRCM file. For TSLRCM + M4-78 it will be called 1402798020. For regular TSLRCM it will be called 485537937. Choose which of these folders you have for TSLPatcher to install to and let it work. If you are using other than English TSLRCM your folder code will be a little different.

!!!IF YOU DO NOT FOLLOW THE ABOVE INSTRUCTIONS AND ARE USING THE STEAM VERSION OF 1.8.5 THE MOD WILL NOT WORK!!!

Description
===========
-This mod expands upon existing lightsaber construction methods (Bao-Dur) and allows T3-M4 to not only help you
construct your first lightsaber, but further allows him to construct as many lightsabers as you have crystals
available in your inventory (double-bladed, one-handed, short lightsabers, and Visas Marr's lightsaber) - on demand.

-The intention of this mod is to give players the ability to have a lightsaber that fits into the existing lore and story
of the game as early as your first visit to the Ebon Hawk if they choose. I wanted a mod that didn't just magically give
the player lightsabers.

-How T3-M4 is able to help you create lightsabers is explained in as much detail as would be available
to the Exile at this stage in their journey. Speaking to T3-M4 and asking him to help you construct a lightsaber will begin
the series of short steps required that will activate this ability for T3-M4 and give you three crystals of your choosing
for use in construction.

-This mod pays careful attention to ensuring nothing is removed from the base game. If you still want to follow Bao-Dur's
lightsaber construction method and search for parts across the galaxy - you can do that!

-The Crafting a Lightsaber quest is now given directly after regaining your Force powers on Peragus.

-Using T3-M4 to construct a lightsaber will trigger the Crafting a Lightsaber quest as completed just like if you made one
through Bao-Dur. Bao-Dur will not ask you why you do not carry a lightsaber anymore once this occurs.
Likewise, if you have not used T3-M4 to construct a lightsaber before bringing Bao-Dur aboard the Ebon Hawk,
he will speak to you about a lightsaber as normal.

-Lightsaber training with Kreia is CONFIRMED to be working using T3-M4 to construct your lightsaber.

-Looting post Crafting a Lightsaber quest works as it would in the base game. Where you would have found a
lightsaber part, you will now find a lightsaber, just like in the base game.

-This mod was designed to work within the existing format of the game concerning lightsaber construction.
The only difference is the lightsaber quest will trigger early and is able to be completed via T3-M4 versus
only Bao-Dur. There are some additional dialogue options for immersions sake and T3 can construct multiple
lightsabers but everything else works exactly as it should.

-There's a cool story easter egg within the Security System tucked away

Getting Started
===============
This mod works best from a new save to experience all the changes as they were meant to be experienced.
This is not mandatory, however, as the mod is designed to be used at any point in the game.

If Using an Existing Save
=========================
Talk to T3-M4 and he will give you the access codes to the Ebon Hawk.
Ask him about lightsaber construction and he will direct you how to upgrade him.

If using a New Save
===================
Play the game as you normally would through Peragus.
T3-M4 will give you the Ebon Hawk's access codes before leaving Peragus.
Ask him about lightsaber construction and he will direct you how to upgrade him.

Important - Timing
==================
Due to the natural progression of the game, it is best to speak with T3-M4 about lightsaber construction just before or
after your initial conversation with Kreia aboard the Ebon Hawk. If you wait, your next opportunity will be directly after
leaving Telos.

Compatibility
=============
IMPORTANT - This mod relies upon the default crystal files that come with the game. (U_l_colo_01 thru u_l_colo_10)
Any mod that removes some of these files for some reason will cause this mod to not function at 100%. Mods that change
existing u_l_colo files should not be a problem.

Any mod that gives you a lightsaber and then changes how the Crafting a Lightsaber quest works is likely to conflict
with this mod.

A mod that just gives you a lightsaber and messes with nothing else should be okay, if also redundant.

-I have made a somewhat thorough search of existing lightsaber mods to search for any crystal files they may add.

-To my knowledge, no existing mod adds new crystals to the game beyond Prydeless' Pink Lightsaber mod.

-If you are using a mod that adds crystals to the game, then after running TSLPatcher.exe and the installation of
the base mod has completed, open the 'Compatibility' folder inside 'tslpatchdata' and drag and drop the secsys.dlg
from the folder corresponding to the crystal mod you have installed into the override folder located inside the
main directory of your KOTOR II installation. When prompted, override the existing file. I will update this file
as more mods come out / I am made aware of that add new color crystals to the game.

Current compatible crystal mods:
-Prydeless' Pink Lightsaber mod
-Working on adding more!

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

What Specifically does this mod do?
===================================
-000.dlg was modified to give the player the Crafting a Lightsaber quest early (Peragus after regaining Force powers).

-Global.jrl has been updated to reflect a non Bao-Dur specific lightsaber quest through string 128188 that comes
 with the base game and a new string appended to dialog.tlk that reads "With your companion's assistance, you have
 crafted a new lightsaber."
 
-103atton.dlg was modified to reflect T3's new abilities and gives the player owner identification codes to the Ebon Hawk.

-T3M4.dlg was modified with a new dialogue option that will begin the steps needed to allow for lightsaber
 construction (double-bladed, one-handed, short lightsabers, and Visas Marr's lightsaber)
 Will not allow creation without a crystal.
 Will properly set boolean 000_Lightsaber_Built that flags the Crafting a Lightsaber quest as completed. This is the same boolean
 the game has always used.
 T3 can be asked how he learned to help create lightsabers, after a brief explanation of time serving the Jedi, conversation
 is routed to existing conversation that can lead to the holorecording with KoTOR 1 characters.
 
-Modified u_have_any_co_cr.ncs, a script that comes with the base game, so the game properly checks bronze crystals in your inventory
 when checking for crystals (This script will continue to be updated to reflect additional lightsaber crystals that new mods add to the game).
 
-Modified baosaber.dlg so that Bao-Dur's conversation about lightsabers will not trigger if Crafting a Lightsaber quest
 is complete. This conversation will occur as normal if it is not complete.
 
-Modified secsys.dlg with an Access System Commands option.
 Added a hidden compartment with three crystals that can be made into any color.
 Created the process for upgrading T3-M4 to allow for lightsaber construction.
 Placed existing camera recordings within an Access Security Cameras option.
 
-Modified visasmarr.dlg to allow for dialogue when returning her rebuilt lightsaber as well as influence gain/loss options.
 
-Created the following Booleans:
KES_CR1 boolean - flags when the compartment crystals are created, preventing crystal creation from repeating.
KES_CR2 boolean - will allow for the secret easter egg to take place.
KES_CR3 boolean - prevents an infinite LS/DS point exploit from forming from repeating the secrete easter egg.
KES_CR4 boolean - flags T3-M4 as having had an update, allowing for lightsaber construction to take place.
KES_CR5 boolean - flags whether the character has received the Ebon Hawk's owner identification codes.
KES_CR6 boolean - flags when T3-M4 has helped rebuild Visas' lightsaber, preventing this option from appearing again in dialogue.
KES_CR7 boolean - prevents repeatedly activating the dialogue of giving Visas her lightsaber back.

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 all of this 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.