################################IMPORTANT####################################
Metal Gear Solid, along with all related logos and characters are registered 
copyrights of Konami Computer Entertainment Japan, Inc. This little program is
only made as a tribute to one of the best videogame series of all times and
not for sale under any circumstances.
################################IMPORTANT####################################


Metal Gear Solid: VR Missions by Locke.

Installation:
=============

Put MGS.fxe and the MGS folder under GPMM on your GP32.

Controls:
=========

Up, down, left and right.- move Snake in 8-directional way. If you run into
    a wall, Snake will go automatically into wall-walking mode.
    Up and Down change options in the menus.
	
A.- Activate de first person view. Release it to return to the default view.
    Select options in the menus.

R and L.- While in wall-walking mode use this buttons to walk along the wall.
    If you are in a corner, Snake will look around it.

How to play:
============

**I recomend selecting 166Mhz to have a smoother gameplay**

The game is very simple. You must reach the exit of each level without being
detected by any guard. The exit is a red square in the floor, it's hard to
miss. ;-)

TIPS

Remember to use wall-walking mode and first person view to find the guards that
are hard to see with the default camera angle.

If you are looking around a corner in wall-walking mode and the screen turns black
is due to a wall between you and the camera. It happens when you are in a narrow
corridor. To avoid this try pressing R or L to move the camera to a better position.

Study carefully the guards' routes and find the right path to avoid them.

Remember: This is a sneaking game. It's better to spend 2 minutes spying the
soldiers than runing around madly and getting caught by them again and again.
If you want brutal action go play gpQuake. :-D

Mission Editing:
================

It's quite simple to create your own levels so you can replay the game without
getting bored. Just follow the next steps:

1.The levels are named level'x'.vrm, where 'x' is a number between 1 and 999.

2.These files are plain text (.txt) with changed extension. To edit one of them
   open it with your favourite text editor.
   
3.The maps are 20x20 and ONLY 20x20. That means 20 rows of 20 symbols each.If your
   map is smaller than that, fill it with blanks. If it is bigger, then reduce it. ;-)
   In case your map look weird on the screen, the problem is here.

4.The simbols are:
   # - Wall. Make the skeleton of your level with this.
  ' ' - Blank(space). Nothing here. Is the floor of your level.
   S - Snake's starting point. Don't place it near enemies or you will get auto-death.
   F - Finishing point. The place you have to reach to clear the level.
   E - Starting point of the enemies.
   
5.You can only place ONE 'S' and ONE 'F' for each level.
   
6.Just below the map you have to place the enemies routes. They use some different symbols:
   R - Right
   L - Left
   U - Up
   D - Down
   P - Pause
   
7.A route is a line with no limit of the number of simbols in it.

8.The routes are asigned to the enemies in the following order: The first line will correspond
   to the enemy in the highest line. If there are 2 or more enemies in the same line then the
   first line goes with leftmost enemy and so on.
   
9.The first symbol in the route is the initial facing of the enemy. This simbol is only readed
   ONCE (not included in the loop)
   
10.The rest of the route are the moves of the enemy. If the enemy is facing the direction
   corresponding to the next symbol, then the enemy will walk one position in that direction.
   Else, the enemy will rotate to face the new dir without changing its position. (I might seem
   difficult, but it isn't, just think of it a little. ;-) )
   
11.The route (except for the first symbol) is looped, so it must end in the initial position, and
   with the same facing. If you see your enemies walking through walls then the error is here :-D
   
12.Every enemy must have it's own route.

Finally, here is an example. It's the .vrm from the first level. If you want more, go to /gpmm/mgs.

       #####        
       #   #        
       # F #        
       #   #        
    ####   ####     
    #         #     
    #         #     
    #         #     
    #   ###   #     
    # E ###   #     
    #   ### E #     
    #   ###   #     
    #         #     
    #         #     
    #         #     
    ####   ####     
       #   #        
       # S #        
       #   #        
       #####        
DDDDDRPPRRRRRPLPRPRPUPUUUUUUUPDPLPLLLLLLRPLPDDDD
UUUUULPPLLLLLPRPLPLPDPDDDDDDDPUPRPRRRRRRLPRPUUUU

13.Soldiers vision field. I'will use examples to explain this. A 'E' is the position of the soldier (facing
    east in this case), '#' is a wall, 'x' represents the positions where you will be caught in each case,
    and '+' is where you can hide without being detected.
    
    xxxxx    ##xx#    xx+++    xxx++    xx#++    xxxxx    xxxxx    xxx#+    xxxxx
    Exxxx    Exxx#    E#+++    Ex#++    Exxxx    Exxxx    Exx#+    Exxxx    Exxxx
    xxxxx    ##xx#    xx+++    xxx++    xxxxx    xx#++    xxxxx    xxxxx    xxx#+
    
    I think that all are pretty simple except for the second. It only means that altough there are walls in
    the field of view of the enemy, you can't hide anywhere, so in all those cases you will be detected.
    
    The other cases are obtained combining the ones avobe, so the fifth and the last toghether will be like
    this:
    
    xx#++
    Exxxx
    xxx#+

I think that's all about level editing. C'mon, I want to see periodical releases of fan-made
level packs! :-)

About the game.
===============

This game have been made for the 16 days coding competition hosted by gbax.com and emuholic.com.
The objective is to show that the GP32 can move high quality 3D without a 3D procesor or a
floating point unit. This is not even near the maximum quality that can be handled by the GP32;
this whole game, including all the code, models, animations, textures and maps, was done from
scracth within 13 days, so with more time and effort (and a better coder xD ) I'm sure that this
handheld can handle better graphics quality than many of the first PSone games.

About the author.
=================

I'm a Spanish coder (thats the reason of my awfull english :p ). I'm 21 and I study Computer
Engineering. This is my third public project, after a MD2 model loader and a simple game called
PaperPlane, both of them for the GP32 (Paperplane is also available for windows and linux).
If you have any comments, questions, suggestions or just wanna contact me for some reason, write
to locke.cole_AT_gmail_DOT_com

Thanks.
=======

Maulo - For his WONDERFUL klimt port.
Mirko - Simple but complete SDK.
All the people that helped me with my silly questions about C basics (xD), especially TheNestruo,
   Mortimor and Nuak.
And my girlfriend, who supported me in my 12-hours-a-day-programming-oddisey. :*** :)
