Console Tracker

--------------------------------------------------
              Console Tracker v1.1
	by Fernando Aluani aka USS Frontier	 
--------------------------------------------------


-----------
DESCRIPTION
-----------

This script requires Foundation

Console Tracker is a simple script done by me in about 3 hours, to automaticaly write the stuff from the console to a determined file, (default is 'scripts\Custom\ConsoleTrackDump.txt'), to make error reports, or anything that involves checking what you did in the Console, or what happened in the console, easier, by automaticaly writing the console to a file with a determined delay (default 0.5 seconds) between each write.

So with this you won't need to continuosly open the console to check if there are errors happening, and if the game freezes, this will have printed it before, depending of the delay you had set.

------------
REQUIREMENTS
------------

- Foundation

-------------------------
Installation Instructions
-------------------------

To install this mod simply copy the the script folder contained in this mod's RAR file to your Bridge Commander Directory, Windows will probably ask if you want to override the existing folders in BridgeCommander Directory, so just choose "Yes to all".

----------
How To Use
----------
Simply install, and then in the game menu turn on the mutator "Console Tracker".

Now to change the Delay value ( the time in seconds between each consle dump), the FileName (the file in which the console will be dumped), and the AutoPressEnter (if the script should auto press enter) you will need to have more understanding about programming in python.
To change these values, open the script file, you'll see a big commented part, with a title "USER DEFINED VARIABLES", and between the lines " * YOU CAN EDIT BELOW THIS LINE" and " * DONT EDIT BELOW THIS LINE" are the Delay, FileName and AutoPressEnter variables.

Bear in mind that very low delay values may affect game performance, but with a low delay value you will have more chances of dumping the console, and thus being able to check later the error that happened, before the game ( or most probably the PC) freezes if a "fatal" error hapenned. As when i'm debugging my script i'm not really caring with performance, and the fact that my PC can handle it, i set the value of the Delay to 0.5 seconds for myself, but the default is 2.0 seconds. But please, fell free to change the delay value to your likings.

Also, an important note about the AutoPressEnter feature: if it is on, then the script, before dumping the console, will automaticaly "press enter" in the console so that when dumping, it will dump everything that was printed in the console until that moment making the dump more detailed, using this feature however has unfortunately a drawback: as it'll be "pressing enter" in the console automaticaly before each dump, the console will be filled with lines, depending of your delay, making the use of the console in-game hard, or even impossible if the delay value is a low one, by impossible i mean you won't be able to read anything from the console while in-game, you can type and such, but you won't see anything until closing the game and opening the dump file, that because of the "line flood" may be kinda big depending of the delay and if there was a lot of things on the console (in one of my tests, a mod of mine was printing a LOT of things in the console, and i mean a LOT, and the delay was 0.5, the dump had 500Kb size) . IF this setting is off, then the dump will only contain what is in the console on that moment, meaning that if the user don't press enter in it to show the newest error reports/prints, you won't be able to see them in the dump.

And remenber this when changing the variables:
- DelayValue  =  must be a float number (like 1.2), in seconds
	^- Default: 2.0 seconds
- FileName  =  must be a string, containing the path to a file without the file extension, the ".txt" extension is automaticaly used, like: "scripts\Custom\ConsoleTrackDump"
	^- Default: "scripts\Custom\ConsoleTrackDump"
- AutoPressEnter  =  must be 1 to set it on, or 0 to set it off
	^- Default: 1   (set to on)

--------
Bugs
--------

None that i know of.

Tested in Bridge Commander v1.1 with Kobayashi Maru 0.9.1 Mod, and some other thingies.

Thanks TiqHud for finding that bug that was causing a BSOD in some PCs.

--------
Contact me
--------
If you find any bugs, please contact me with the info you have about it (how did it happen, what happens, etc), or if you have some comments/ideas feel free to contact me too
my email is: fernandoragnarok AT hotmail DOT com
         (this is for anti-spam issues, change "AT" for "@" and "DOT" for ".", and you have my email)
Or you can find me in BCU's forum, KM's foruns, or BCS:TNG's forum by the name of USS Frontier

-----------
Copyright
-----------
THIS MATERIAL IS NOT MADE, DISTRIBUTED, OR SUPPORTED BY Activision TM & (C) INTERPLAY & PARAMOUNT PICTURES.

Star Trek, Star Trek: The Next Generation, Star Trek: Deep Space Nine, Star Trek: Voyager
and related properties are Registered Trademarks of Paramount Pictures
registered in the United States Patent and Trademark Office.
All original designs are copyright © Paramount Pictures.
No infringement of Paramount's copyrights is intended.

---------------
Distribution
---------------
All files in this zip are for personal use only and cannot be bought or sold. They also cannot be modified or released in any way without the author's permission.
They can be uploaded in any site but credits MUST be given.