
                               IGOR'S NEST
                        
                                  v1.0
                    
                  being a VRML/Javascript ministrategy game 
                      featuring Robots and Destruction 
                    
                            by Teuvo Tursas/RRR                 
                
                  Released under GNU General Public License 
                

1. Story
--------
Once there was one man and his droids. The man climbed
up a lone mountainside and the droids followed, and
the man in his ears and the droids in their sensors
heard a voice giving out orders, to "destroy him, my robots."
But through the laser bullets and metal onslaught the man 
and his droids persevered, and at last were able to vanguish 
the robot tyrant and his metallic hordes. On that day the one 
man took upon himself the name Igor and recognized the
power of robots over mere droids in his cause for justice. 
Thus he built a splendid palace upon the old ruins on 
the top of the mountain and it was there he constructed 
his robot legions and their power was awesome and unsurpassed.

Rule of Igor went unchallenged for years, though people
suffered and there was no bread for children, because instead 
of plows only robots and horrible cannons were built. In turns
resistance grew and was squashed, until only you remain. And it 
is you, with your few remaining droids, who must put stop to 
Igors terror! But what can just one man do, against the robot
hordes? And while you near the Igor's Nest, you can already 
hear him barking orders to his robots, to destroy you...


2. Requirements and usage
-------------------------
You need a webbrowser with VRML plugin and Javascript-support.
(e.g. IE with Blaxxun Contact 3D 4.10A)

Usage: use this URL in your browser

file://path/to/local/dir/nest.wrl

You can also provide this game from your webserver to remote
users if you like. They need just a browser and the plugin.


3. How to play
--------------
The player controls the red army and the computer plays with the blue
hordes (as Igor). You can use two types of robots: tanks and artillery. 
The artillery can fire long range, but not close, and it moves only 
a little. The tanks shoot close range but can move more. In each turn, 
every unit can move and shoot once. To win, destroy Igor's Nest or 
all his evil blue robots!

Available Command Buttons:

Move - Choose unit move mode. Putting the pointer over an unit
       shows all squares where the unit can move. To move unit,
       click on it.
Fire - Choose shoot mode! Putting the pointer over an unit
       the system shows all squares which you can devastate with
       your firepower! To fire, click on an unit...
View - Choose viewing mode. Clicking any object on the map 
       (units, bases, countryside) the player is moved near
       the clicked object.
Info - Shows/hides the unit energy readings. You can examine
       the readings by moving the pointer over them.

End turn - Its computers turn now!


4. For developers
-----------------
This game was done using Win98 (because I could get no good 
VRML player for Linux). The following software was used:

* Adobe Photoshop 6.0 (textures)
* Blaxxun Contact 3D 4.10A (VRML-plugin)
* Internet Explorer 5.5
* MilkShape 3D 1.5.9 (3D-objects)
* UltraEdit-32 (VRML & Javascript)

The code should be environment independent. It shouldn't contain
any blaxxun vrml add-ons or ie-specific javascript.

IGOR'S NEST is open source, and its probably NOT our intention
to develop this game further. If you wish to enhance this game
and develop it, you can adopt it, that is, we give it over to you. 
Remember that any derivation must be GPL'd open source too. If
you're interested, send mail.


4.1. Internal details
---------------------
The game is mostly javascript, except the pregenerated objects
and sounds. Its javascript so that full java-support is not
required from the browser.

In the javascript-code (nest.wrl file) theres some variables
worth mentioning:

* terrain_complexity - 0=low poly, 1=high poly (default)
     use terrainmodels from terrain/simples or terrain/complex.
* movement_cost[]
     the cost to move in a terrain type
* unit_move[], unit_damage[]
     how much the units can move and do damage
* units[]
     the units in the game.
* map[]
     the map of the game.

The map is dynamically generated based on map-array. With a 
little work the game can be enhanced to have many scenarios.
The same is true with units and the AI could be enhanced
to "different personalities" by tweaking weights and scores
and replacing static numbers with variables.

All animations are done in real-time with javascript and vrml.

There is only one predefined viewpoint, its located over the
board. In Blaxxun VRML-player buttons "page up" and "page down"
take player there. If the player wants to, after each turn,
get into this viewpoint, check // VIEWPOINT!!! in nest.wrl.


5. Contact
----------
You can send fan mail to the highly secretive Teuvo Tursas 
through RRR Sorority Division project co-ordination, 

email: <iwronsky(at)yahoo(dot)com>

Your email will be forwarded with utmost confidence.




