Game Development Community

dev|Pro Game Development Curriculum

Torque Script Tool Kit (TSTK)

by Edward F. Maurina III · 04/24/2009 (3:15 pm) · 16 comments

downloads.roaminggamer.com/gglinks/090424/tstk.png
The Torque Script Tool Kit is a collection of utility scripts (and other cool stuff) that I (and others) have written (and continuously improved) over the years. Currently, the kit includes 156 scripts.

I strongly encourage all Torque engine users to download this kit and to become familiar with it. I guarantee that this kit will save you hours of coding, debugging and will help you write better scripts of your own.

To Download
You can download the kit here.

Staying Up-To-Date
This kit will be added to over time, so if you find it useful, you will also find it worthwhile to check back occasionally and pick up the latest version.

You can check your version by running the function rgVersions(); in the console.

After running this script you should see a message like this:
"Torque Script Toolkit: 103 Last updated: 23 APR 2009".

Of course, your version and last update may be different. Just compare this data to that shown on the download page and get a new copy if yours is older.

Documentation
These scripts are only lightly-document, but never fear, the scripts are pretty self-explanatory in nature and I'm sure you'll figure out how to use them easily and quickly. Also, you should keep track of my blog, because I will be posting examples using TSTK from time to time.

Kit Contents
A full listing of the contents of the kit is provided and maintained on the TSTK download page, but as further enticement for you to download this, here is a listing of the individual files:

Common Files - These files contain scripts that can be used with all of the Torque game engines.
arrayObject.cs - Contains scripts to support array objects (objects that store array data, thus allowing you to ‘pass arrays’ in TorqueScript)
Fields.cs - Contains utility scripts, useful for manipuating strings of fields.
Record.cs - Contains utility scripts, useful for manipuating strings of records.
Words.cs - Contains utility scripts, useful for manipuating strings of words.
File.cs - Contains utility scripts, useful for manipulating files.
GUI.cs - Contains utility scripts, useful for manipulating GUI controls.
Math.cs - Contains scripts for performing various complex (and simple) mathematical calculations.
Object.cs - Contains utility scripts, useful for manipulating objects.
SimSet.cs - Contains utility scripts, useful for manipulating simsets.
Strings.cs - Contains utility scripts, useful for manipulating strings.
eventRouter/EventBind.cs - Contains scripts for (un)binding keys maps to event router events.
EventRouter/EventRouter.cs - Hierarchical event routing and handling system.

TGB Files - These files contain scripts that can be used with TGB only.
accessMethodGenerators.cs - No description yet.
behaviors.cs - No description yet.
EventManager.cs - No description yet.
ImageMaps.cs - No description yet.
levelLoading.cs - No description yet.
t2dSceneObject.cs - No description yet.
WorldLimit.cs - No description yet.
editors/fieldTypes.cs - No description yet.
editors/levelEditor.cs - No description yet.

TGE Files - These files contain scripts that can be used with TGE only.
GameBase.cs - No description yet.
Networking.cs - No description yet.
SceneObject.cs - No description yet.


Contributing Scripts
In addition to adding my own scripts to this kit over time, I will be accepting submissions from the community. I will review these submissions and add them as long as they meet minimum requirements (which I will set). So, if you have something you want to submit, simply go to the download page, and learn how to submit your scripts.


#1
04/24/2009 (3:24 pm)
Edward, I am the creator of the RotateVector functions www.garagegames.com/community/forums/viewthread/33277. I had forgoten all about them. Glad someone got some use out of them.
#2
04/24/2009 (3:32 pm)
Ryan,
Thank you so much for commenting. I have been worrying about those scripts because I wanted to give proper credit and didn't remember the originator. I almost didn't release them, but I've found them so useful I decided to go ahead and keep them in.

Can I list you as a contributor on the TSTK page?

By the way, I used those scripts in another resource I'll be putting out in the future. So, thanks a ton for saving me effort.

-Ed M.
#3
04/24/2009 (3:40 pm)
It seems almost a life time ago when I wrote those. I was trying to make a bot aware of it's surroundings by doing ray casts for object collisions. It started getting a bit to complicated though. In the end it was just a bit of fun and the code was lost in a file shuffle somewhere. You can list me, I am just glad they were used. Keep up the good work, I refer to GPGT often.
#4
04/24/2009 (6:21 pm)
Great Resource, it saves us bunch of time!
#5
04/24/2009 (10:32 pm)
@Edward,

Nice resource will be helpful...

BTW... Download link on GG site gives 404 error...:)
#6
04/25/2009 (6:40 am)
It appears you cannot directly link to your resources from outside your site. Going to the site and highlighting the downloads link from there works a treat.
Thankyou Ed. (love your books btw.)
#7
04/25/2009 (8:24 am)
Thank you.
#8
04/26/2009 (2:47 am)
thanks for sharing!... (your first link is broken)
#9
04/26/2009 (1:37 pm)
Sorry folks. I fixed the link. It seems I accidentally typed a minus sign (-) in front of the http: :)

-Ed M.
#10
04/27/2009 (7:43 am)
Another thank you Edward, great stuff coming from you lately. I'm definitely going to look through these scripts as I'm sure some will be useful to me.
#11
04/28/2009 (9:24 am)
Link don't work
#12
04/29/2009 (12:29 am)
Thank you... ^^
#13
06/16/2009 (1:24 am)
hi,I am working with TGEA1.7.1. and I find there are some minor mistakes in your TSTK install introduction file "install_TGEA.txt".

step3 and step4 are described as follows :
=========================================================
3. Locate the following lines:

$isDedicated = false;
$dirCount = 2;
$userDirs = "tools;" @ $defaultGame;


4. Change the above lines to:

$isDedicated = false;
$dirCount = 3;
$userDirs = "TSTK;" @ "tools;" @ $defaultGame;
=========================================================

"$dirCount" should be replaced by "$modcount" and
"$userDirs " should be replaced by "$userMods "

what's more the version check function is actually named as "rgVersions()", not "rgVersion()".


I am a huge fan of your books. good luck ~
#14
08/01/2009 (7:41 pm)
Hi, Ed,

I'm reading your MP & Engine Coding book now, and it seems very helpful, particularly since I was recently tasked with doing the AI.

We are using T3D beta 4, and with its new folder structure, I am not sure how your toolkit would be installed for it. Is there any difference? Would you please provide and update for T3D?

Thanks.
#15
05/05/2013 (9:37 am)
Anybody have this still? The links are broken.

-Jeff
#16
06/13/2013 (9:51 pm)
For anybody that may be interested in this, I did a little digging and found the wiki for it. Download link is listed and working as of this date.

roaminggamer.com/wiki/index.php/TSTK

As an additional measure, I have posted a link to an archive hosted by The Wayback Machine (I highly recommend using this tool on any dead link you may find. Chances are there is an archived copy of it.)

web.archive.org/web/20091021052909/http://roaminggamer.com/wiki/index.php/TSTK

This archive will almost surely stay up for an appreciable amount of time.