SpawnWeapon.cs
Version 1.1
by UberGuy (FT) - uberguy@skyreach.cas.nwu.edu
9/02/2001

REQUIRES: Writer's Support Pack
===============================
http://www.planettribes.com/lorne/support.vl2
http://www.planettribes.com/depot/downloads/index.asp?db=t2&Action=view&id=60


Update 1.1
==========
Added option to mute fire for a configurable delay after spawning.

Update 0.9
==========
This T2 script will allow you to select the readied weapon you spawn with. The
script browser panel will show a weapon selection dropdown that will initially
be blank.  You won't be able to select anything until you join a server, because
the script has to get the list of valid weapons in order to populate the
dropdown.  Once that's done, you can select a weapon from the list. Be aware
that even though you get a complete weapons list, you can still only spawn with
a weapon ready that you actually spawn with. Selecting a mortar when you are
playing base tribes won't do you any good - the ability is there just for
mods and new mission types where you might spawn with different gear.

Once you have selected a weapon, the script remembers that weapon's name until
you change it. That name will display in the dropdown even when you restart
T2 and haven't connected to a server. Whenever you spawn with a weapon of that
name, the script will change to that weapon.

NOTES FOR SCRIPTERS:
====================
This script contains a method of dynamic learning about weapon names from the
server that I haven't seen used before. I plan to extract that part of the code
and make it into a support script that other scripters can query for weapon
names. This is useful in kill-tracking scripts, since the built-in message for
kill events does not pass the weapon name, only the weapon "slot" - a number
representing the ordinal weapon number in the gametype's list. Without something
like this script to map that to weapon names, it's fairly useless.

TO INSTALL:
===========
Place spawnWeapon.vl2 anywhere under Tribes2\GameData\base.
Play T2!  The script is configured from Writer's script browser GUI.

Enjoy!
