----------------------------------------------------------------------------
                           The Strogg War - Beta v0.30
                                     Manual
----------------------------------------------------------------------------
URL: www.planetquake.com/stroggwar
----------------------------------------------------------------------------

I   - Install the mod
II  - Run the mod
III - How to play

----------------------------------------------------------------------------


I - Install the mod
-------------------
Install Q2 v3.20
Extract the 0.30-TSW-version into your Quake2-folder, a TSW-subdirectory will be created.
If you have a recent version installed, overwrite existing files.


II - Run the mod
----------------
(1) start Quake2 with:
quake2 +set game tsw +set basedir <q2-path>

where <q2-path> is the full path (drive+directory) to your Quake2-directory (not the baseq2-dir!)

(2) now enter 'exec tsw.cfg' to use the default bindings going as follows:

o "cmd commprev"            - cycles one step backwards through the available commands that can be assigned to your selected units
p "cmd commnext"            - cycles one step forward through the available commands that can be assigned to your selected units
k "cmd unitprev"            - cycles one unit of your team (when you are in direct-control) or one team (when you are in supervisor-control) backwards
l "cmd unitnext"            - cycles one unit of your team (when you are in direct-control) or one team (when you are in supervisor-control) forward
SPACE "cmd commapply"       - assignes the current command to the current selected team-member or team
UPARROW "+forward"          - movement-keys
DOWNARROW "+back"
LEFTARROW "+moveleft"
RIGHTARROW "+moveright"
PGDN "+movedown"            - down & crouch
PGUP "+moveup"              - up & jump
set in_mouse "1"            - mouse-look
MOUSE1 "+attack"            - fire weapons, assign commands via point&click
MOUSE2 "+moveup"            - up & jump
TAB "cmd inven"             - show inventory, display menus to order buildings and troops
ENTER "cmd invuse"          - inventory use, confirms selected menu-item

(3) Set the timelimit to define the time *after* which the mod will check how many units and buildings are left for each player. If now there's only one player with units and/or buildings, he wins the match. So the match won't be over 'till the timelimit is hit. To set it to 10 mintes type 'set timelimit 10' at the console.
The mod will autorun in deathmatch, the default timelimit is 10.

Choose the fog-mode with the cvars 'opengl_fog' and 'glide2_fog'.
type: 'set opengl_fog 1' and 'set glide2_fog 0' to enable OpenGL-fog
type: 'set opengl_fog 0' and 'set glide2_fog 1' to enable Glide-fog
If you want to run a dedicated server please disable both fog-modes.

(4) Load the map with 'map <mapname>' where <mapname> may be:
-cc1
-canyon
or
-any mapname from the Qwar2-maps.

Read the readme for some more information.
I will explain the commands and the teams later on.

III - How to play
-----------------

You start in supervisor-mode with the team-selection-menu. Choose your preferred team that hasn't been selected yet. You can't choose all teams on all maps because each time has it's own start-point. Right now you can play only the humans.
When you are done with this, you spawn in supervisor-mode at your base-area. You may move freely through the entire level, even to the enemy's base. You won't be able to do this in the final-version :-P
Now press the the inventory-key. You get the construction-sidebar and these five coloured balls on the ground. They show you how big the building will be that you have selected. As long as there's any ball red, you can't build, so move your view and the balls will move. Rotate yourself and the balls will rotate as well. When you've found an adequate place, press the inventory-use-key. You see a black-transparent preview of it. Wait some time until a viper-arrives to drop the real-building. It will deploy and is now existent. Some buildings consist of two or more parts, they will arrive one after the other.
To build another building use the inventory-cycle-key ( usually [ and ] ) to move the cursor in the menu. To quit this menu press ESC.
To order a unit press the inventory-key again. Now you see the unit-menu. Select the units like the buildings and press enter to call 'em. They will arrive after some time with the viper as well. But they are all unequipped. Build a weapons-factory. Now it will produce all weapons and items that are required for the unit-types automatically. The marines will pick them up. If they are out of ammo, move them back the the factory so they can recollect some more ammo. Press ESC or the inventory-keay to close the menu.
For the next passage I assume that you have built a 'Light Grunt'. Wait and watch how we's collecting his items. When he's finsished we want to move him. There are three ways to do so:
(1) Click on him ('attack'). Now he's selected, you can't see this on him, but you can see an icon and a number that have appeared at the lower right corner due to this action. Now rotate and move yourself and the point to an empty space. Click. The grunt will start to move 'till this point and stop. You've assigned the order via 'point & click'.
(2) Press the 'unitnext' key. A number in the lower right corner of the hud will appear, you've selected the grount. Now press the 'commnext' key to cycle through the orders. Colored icons will appear beside that number, they represent the orders. A long arrow on blue background pointing to a black point is the symbol for the move-command. Now move and rotate yourself and press 'commapply'. The guy will move.
(3) Select the marine with method (1) or (2). Double-click on him or cycle the orders until a green icon with a black arrow pointing from up(map) to down(guy) appears and apply this command. Both methods made you switch into the guy. Now move to the destiantion. Now use the command-cycle-keys until you get the inversed icon (arrow pointing up from guy to map) and apply this command. You are in supervisor-mode again, this is the only way to perform this action.
Try all three methods. (3) describes the way how to switch between the direct-control-mode and the supervisor-mode, keep it always in mind!
You may create waypoints by clicking/applying the corners of the path one after the other in the correct order. The unit will follow this path, walking from corner (where you've clicked) to corner.

To attack an enemy you have the three methods again: Select the unit.
(1) Click on the enemy and your unit will attack.
(2) Cycle the commands unitl you get an icon looking like the move-icon with a red crosshair at the destination of the arrow. Now point at your enemy and apply the order.
(3) Switch into the guy and move towards the enemy. Go forth and kick ass soldier!

If the current order shall be aborted, for the case the guy got stuck or shall flee, you have again three ways: Select him.
(1) Double click on an empty space he can reach directly and he will move there deleting all other assigned orders, including a walk-path.
(2) Cycle the order until you get the strange icon on blue-background showing a half crosshair and a black circle with red filling(half of goggles), this is the normal-mode icon. Apply the order, the unit will stand still unless he's attacked.
(3) Jump in him and get out of him.

Now build two other units, while your first unit stands near the landing platform. The next passage assumes this state.
When you now move your first unit, the other two will follow him and group around. All units that are built will form teams with up to four members automatically. The leader is the first unit in that team, assigning an order to him means assigning an order to the team, selecting a team-member means selecting the team-leader means selecting the team.
You may split that team if you want. Select the team. Cycle the order keys until you get a green icon with a horizontal arrow pointing away from a group of three points. This is the 'split-icon'. Point at the unit you want to remove from the team. Apply the command. This unit is now it's own team.
But you can join teams (and single units) as well. Select the team you want to add. Cycle the orders until you get the similar looking icon (an arrow pointing from a single point to a group of points). Now point at the target team(any member of this team) where the selected team should be added to. Apply the order. The last member of the team is removed from the selected team and added to the point team. If there's only one unit left, the old team is no longer existent. So to add a whole team you have to repeat the whole procedure as long as there's a guy in the selected team.
I know that this sounds a bit complicated right now, but it isn't and it will be made easier with drag&drop later on.

Now let's work a bit with our team when we are in direct-control-mode. Jump into any member. You will become him, not important which number he had before, you are the leader. The next passage assumes that there is no number standing beside the icon, of there is one, cycle the numbers with the known keys until it disappears. The commands are a bit different because it's another way of commanding. The team-members will follow your movement, if they don't do, you may call them: cycle the orders until you get a yellow icon with a center-dot and four arrows pointing at him. Apply the command and the units will come to you.
If they shall stand still and look for enemies, cycle the orders until you get the goggles on the yellow background (black circles with red filling). Apply the order, the units will be on the lookout and turn around to scan the area. If they've found a unit they will call you (text message at the top of the screen) and you may have to look for it.
To attack the enemy you have two possible attack commands (single-direct-attack: icon with one big crosshair and multi-choice-attack: icon with several blue crosshairs and one red crosshair). Point at your enemy. Single-direct-attack means the units will attack your point-target until it dies and return to normal mode. Multi-choice-attack means that each team-member takes one target around the point-target that can be seen by him and fires. When it's killed he takes the next enemy. When all enemies in the area are dead, the team-members will return to normal mode. It may happen that the multi-attack-mode doesn't work, sorry.
When you cycle the numbers, you select one team-member after the other. Assigning a command now mean assigning this command only to the selected unit (logical, uh?).

Now get out of our team again. If you have created several teams (if not do so, by splitting or ordering), you can use the number-cycle-keys to cycle through the teams to select them. You can select only one team at a time, no number means definately 'no team selected',

This control sounds complex, but you will get used to it when you've trained a bit.
The units will autoreturn fire when they are under attack. A team will attack the enemy as soon as it's leader has found one or it's memebers have reported the enemy to the leader.
Each unit chooses always the best weapon for the current battle-situation calculating distance, distance of friendly units to the enemy (weapon-spread) and effectivity of weapon.

contact:
If you have further questions for control refer the readme-files first, to contact me: gpig@planetquake.com
For bug-reports and any other comments mail to gpig@planetquake.com as well.

And please remeber it's a beta, so don't expect too much of it, espcecially that there's no path-finding in it!
