jTool3, Some fun stuff for Unreal, espceially Coop game, by Joss Liu
        j88oss@yahoo.com
        www.geocities.com/j88oss

Version history
06/16/2003 jTool3, new pawns and stuff

12/13/2002 well, this is really version 2, but I already called 1a
           "version 2" so what can I say? This is really version 2, while
           the previous one was 1a (or release 2)
           AdminTool removed (it will come later updated in its own
           package), AdminFilter removed, and some new items & pawns
10/03/2002 version 2 public release
           new items, new AdminTool functions, some bug fixes
09/15/2002 version 1 first public release


0.
Contents
------------------------------------------------------------------------
1. Introduction
2. Install
3. Items, Description
4. Recommendations
5. Known Bugs
6. Thanks

------------------------------------------------------------------------
1.
Introduction

1.1
Package file contents:
jTool3.u          - the class file
jTool3-readme.txt - this doc file

1.2
Description

jTool is a set of inventory items that I find useful in the Unreal CoopGame type, as run on Joss' Gold server. I expect they will also work in the DM gametypes, but not extensively tested yet. The source code has been removed from this to make a very small client download. Just send email if you want to see the sources.

------------------------------------------------------------------------
2.
Install

2.1
Download and unzip this package. (well, you already did that, didn't you?)

2.2
Remove any previous version of jTool, including the serverpackages= line from your unreal.ini file.

2.3
Put jTool3.u into your system directory (usually c:\unreal\system or c:\unrealgold\system). Put the jTool3-readme.txt anywhere you want to save it.

2.4
If you are installing this on a server, you will need to add this to your unreal.ini file under the [Engine.GameEngine] section (add to end of list):

ServerPackages=jTool3

2.5
To activate the psiMut mutator to use the pawn spawning inventories, add "?mutator=jTool3.psiMut" to your command line for starting the game. For example:

unreal nyleve?game=jCoop4.jCoopGame?mutator=jTool3.psiMut -server -log

------------------------------------------------------------------------
3.
Items, brief

3.1
Items available include:

Inventories:
AdminKey       A token that gives Admin privilege to the holder.
jBoots         Everybody makes jump boots :) Extra Air Control.
jScuba         The Marine Scuba gear extracted from UPak. Self-recharging.
               Much nicer than standard scuba gear.
jSpeed         A player speedup. Player can change his own speed up factor.

Pawns:
DeathTentacle  (by Maniac) A black tentacle smarter and faster and more
               sensitive than the green tentacle. Kills with one shot.
DemonSkaarj    (by Maniac) A giant fire textured skaarj shots powerful,
               accurate fireballs. Fun to watch 2 demonskaarj fight :)
jCannon        A stationary automatic cannon
jHugeCannon    A huge version of jCannon
jMinigun       A minigun version of jCannon
Princess       Miniature queen that teleports OK on levels other than endgame
TinyTitan      Miniature titan

Blocks:        These are blocks that can be summoned.
jBlockAll      Blocks all pawns
jBlockM        Blocks all monsters
jBlockP        Blocks all players

Stuff:         Pawn spawning inventory (experimental)
psiManta       Will spawn some manta
psiPupae       Will spawn some pupae
psiTinyTitan   will spawn tinytitan
psiHatchling   If you have Asgard2 monster pac, this will spawn some hatchlings
psiMut         a mutator that will place these in some scriptedpawn.dropwhenkilled
               add "?mutator=jTool3.psiMut" to your command line

3.1.1
To get them in your game:
summon jTool3.AdminKey
summon jTool3.jBoots
summon jTool3.jScuba
summon jTool3.jSpeed

summon jTool3.DeathTentacle
summon jTool3.DemonSkaarj
summon jTool3.jCannon
summon jTool3.jHugeCannon
summon jTool3.jMinigun
summon jTool3.princess
summon jTool3.tinytitan

For the psi items you should use the psiMut to add them to some pawns so that they activate when the pawn is killed. Add "?mutator=jTool3.psiMut" to the command line you start the game with.

3.2
Items, Descriptions

3.2.1
AdminKey
The AdminKey is a token you can summon for giving admin privilige to a single player without giving the adminpassword. It autoactivates on pickup, and has no HUD display. This token (and Admin privilege) will last until the player dies or it is revoked (killall AdminKey). Be careful, as someone with this can give the command "admin get gameinfo adminpassword" to get the password. You can help conceal your adminpassword by putting non-printing characters in it. Looks like a lamp for pickup, and a key/pawn in the HUD.

AdminKey will not respawn in a normal coopgame, nor in a jcoopgame even with bRespawnAll=True.

3.2.2
jBoots
jBoots have 33% more jump than normal jumpboots, and have no charge to run out. They also provide substantial increased air control. Looks like normal jumpboots as a pickup item, and in your HUD.

3.2.3
jScuba
jScuba is the Marine Scuba Gear extracted from UPak (from the Return To Na Pali game). Only the name has been changed. This scuba gear automatically recharges when the player comes up for air.

3.2.4
jSpeed
When activated, jSpeed will give a player a speed boost of 3.5 times normal speed. The speed boost can be changed by the player from 1 to 10. Use "speedup x" to change the speed boost. While in the increased speed mode, you can use crouch or walk (normally ctrl or shift) to reduce your speed, as well as provide safety near edges. Looks like an arrow as a pickup item, and a small stickman with arrow in the HUD.

3.2.5
DeathTentacle (by Maniac)
A very deadly tentacle. Quite fun, actually :) Good for making a coop game extra challenging. Shot kill with one hit, and have enough damage radius that near misses kill, too. Can easily get multiple kills if players are huddled together. Smarter, stronger, faster, more sensitive than normal tentacle, and harder to see in dark places.

3.2.6
DemonSkaarj (by Maniac)
A large, powerful skaarj. Also quite fun.

3.2.6
jCannon
jHugeCannon
jMiniGun
These are "stationary pawns" (yes, code borrowed from UT) that make nice hanging gun emplacements. These guns cannot be killed directly, but rather can be temporarily disabled. These automated guns can repair them selfs, but only a few times. After the gun has exhausted its ability to self-repair, it will self-destruct. Careful not to be too close when it destructs, or you will be hurt in the blast.

The number of disables necessary to permanently destroy varies for each instance of a gun. For jCannon and jMinigun it is 7 +/- 3 disables, while for jHugeCannon it is 3 +/- 1.

The guns will not take any further damage during their repair process.

3.2.7
princess
Miniature queen. Unlike the normal queen, this one doesn't get stuck in the silly teleport effect thing. Princess will teleport, and uses the levels navigation points to select for destinations.

3.2.8
tinytitan
A small but deadly version of the titan. When you use the psiMut, killing a titan or a stonetitan will spawn two of these for some extra fun.

------------------------------------------------------------------------
4.
Recommendations

4.1
adminpassword

As mentioned in 3.1.1 above, your adminpassword will be more secure if you have non-printing characters (NPCs) in it. Here is one technique for achieving that. In Windows, click Start button, Run... and type 'charmap' in the run box. When charmap runs, make sure you pick 'fixedsys' for the font. You can then pick characters into the clipboard and paste them into your Unreal.ini file.

You can use this same technique to set your name in user.ini. But, since the game overwrites user.ini every time it quits, you should set the write protect for user.ini to prohibit the game from losing your name characters (the game doesn't write out NPCs).

You could also make an exec file for changing your name to the name with NPCs.

------------------------------------------------------------------------
5.
Bugs/Feedback

5.1
Known Bugs
It seems that sometimes the jcannon/jhugecannon/jminigun get stuck and hang the game. Still don't have a good solution for this. Any ideas? Please email me.


5.2
Feedback
If you find bugs, problems, or have suggestions or comments for new features, please email me at j88oss@yahoo.com.

------------------------------------------------------------------------
6.
Thanks

Thanks to Maniac for his popular DeathTentacle and DemonSkaarj. These are fun to play (really tough) and make the Coop game challenging again.
Thanks to Maniac and Cherokee for their ideas and patience while testing.
Thanks to Koopa for idea leading to AdminKey (adminkey)

Original coding by Joss Liu, September/October 2002, May/June 2003
j88oss@yahoo.com
www.geocities.com/j88oss

------------------------------------------------------------------------
end
