Portal Adventure - The hunt for Dr. Freak
2nd PGD Challenge: The Journey


This is the entry of "Jimmy Valavanis" for the "2nd PGD Challenge: The Journey"
E-Mail: jvalavanis@gmail.com

----------
DISCLAIMER
----------
DISTRUBUTION: I agree to allow the current and any future 'PGD Annual Committee' and PGD Community website organizers 
the ability to freely distribute my game. This permission also includes the distribution of my entry on the competition website it self. 
It can be used to promote PGD and it's community and not for commercial gain. 

MEDIA DEPICTION & USAGE: The 'PGD Annual Committee' and PGD Community website has full rights to use my entered game 
for advertising purposes of any future PGD Challenge or PGD Annual events.


-----------
DESCRIPTION
-----------
You are an agent of "Portal HeadQuorters" trying to retrieve the keys stolen by Dr. Freak and eliminate him.
WARNING: This game contains interactive graphic violence, it's not suitable for young children.

-------------------
SYSTEM REQUIREMENTS
-------------------
OS: Windows XP (SP2), Vista or 7 (32/64 bit)

Hardware: 
CPU:    1 GHz or higher. The game will take advantage of a dual core CPU system. 
RAM:    512 MB 
VIDEO:  A video card with 128 MB VRAM, supporting 3D textures (GL_TEXTURE3D) and multitexturing. 800x600 display, 1366x768 or higher recommended.
DISK:   70MB Hard Disk space for binary and data, 6MB for source code, 2MB for saved games. Additional space required for screenshots.
SOUND:  Sound Card with directsound support.

NOTES:  The game must be installed in a directory with full read/write permissions. 
        The game will only write data to disk in the \bin folder. Will also create subfolders inside the \bin folder.
        It is reccomended to close all other applications while running the game. Running simultaneously other applications may affect performace. 
 

-------
TESTING
-------
Succesfully tested with the following systems:
-CPU Intel Core i5 2.6GHz, GPU NVidia G-Force 540M, OS Windows 7 64 bit
-CPU AMD Sempron 1.8GHz, GPU ATI X700 Mobility, OS Windows XP SP2 32 bit


--------
CONTROLS
--------

IN GAME CONTROLS:
--------------+--------------------------------
Action        | Control                       
--------------+--------------------------------
MOVE FORWARD  | up arrow, "W", hold pressed middle mouse button
ATTACK        | CTRL, left mouse button
STRAFE        | ALT ( + left/right arrow), "A", "D"
JUMP          | "Q", "Z", right mouse button
USE/INTERACT  | "SPACE", double click middle mouse button
RUN           | Hold <SHIFT>
LOOK LEFT     | Home
LOOK RIGHT    | PgUp
MENU          | ESC
SCREENSHOT    | PrtScn 
HELP          | F1
--------------+--------------------------------

NOTE: Look left/Right and jump are not always available. This is not a bug, these features are sometimes (very rare) restricted deliberately by the game AI.


MENU CONTROLS:
-------+--------------------------------+
Action | Control                        |
-------+--------------------------------+
CLOSE  | ESC, right mouse button        |
SELECT | ENTER, left mouse button       |
MOVE   | up/down arrows, mouse move     |
-------+--------------------------------+


--------------------------
NOTES FOR PLAYING THE GAME
--------------------------
Health  : Keep in mind the health indicator, when you're attacked by an enemy you will lose health. 
          Health automatically restores to 100% when you are not attacking. Health restore is faster when you are standing still, rather than moving.

Power   : Power gives you the ability to run (when holding the <shift> key). When power is 0% you will not be able to run. 
          Power automatically restores when you are not moving. When power is 0% normal movement(i.e. not running) is a bit slower.

Saving  : Remember to save frequently while playing, otherwise you must start from the beggining. 

Revisit : You are able to revisit all different places you have already visit but it is not necessary to revisit all places to win the game. 

Attack  : You have unlimited ammo.

If you have trouble playing the game you can select the DEMO option from the menu. This will start a 25 minutes autoplay demo which reveals almost all the secrets of the game.
The final level is not included in the autoplay demo (the demo was intentionally made this way).

-------------------------------------------
[SPOILERS - SPOILERS - SPOILERS - SPOILERS]
-------------------------------------------

[The following section(s) may contail SPOILERS]

When obtaining an item the corresponding icon appears in the main HUD (down/left). Some times you will have to give/exchange this item to continue the gameplay.
In other occasions you must obtain an item to procced to a specific part of the game. 
Some items are just "pickable" (run over them to obtain them), some others are interactive (you must interact with them using <space> to obtain them)


----------------
COLOR INDICATORS
----------------
Green:  Interactive object
White:  Pickable object
Yellow: Pushable object
Red:    Enemy object


-----------
PROGRAMMING
-----------
The game uses as a base a modified version of the DelphiDoom engine - version 1.1.3.510 beta - opengl mode (unofficial beta release). 
To make this game the following additions were implemented to the engine: 
-Interactive objects
-Pushable oblects
-Comic bubbles
-Sloped surfaces
-3D mesh map enhancements
-Hub level progression
-Procedural generated content (scenery)
-Both procedural(pascal compiled code) and scripted AI (DelphiDoom pseudo-scipt language)
-Object indicators (friendly/interactive/pushable/enemy)
-Clevel chase camera (AI controled)
-AI controled fog
-Underwater player control (swimming)
-Earthquake effect
-AI controled movement restriction rules(eg direction turn)

Source code is available in \src directory.


---------
RESOURCES
---------
The game uses resources from the following sources:

-DelphiDoom (base source code, sprites) -> http://sourceforge.net/projects/delphidoom/
-http://www.sulaco.co.za/opengl_project_racing_tunnel.htm (base source for tunnel effect)
-http://www.md2.sitters-electronics.nl/index.htm (models, models skins) -> See docs/CC_attribution_licence.txt and docs/GNU_licence.txt
-FREEDOOM (sounds, sprites), see credits/readme at http://www.nongnu.org/freedoom/index.html
-http://forum.realm667.com/viewforum.php?f=1 (the "bat" sprites, AI scripting ported to meet DelphiDoom engine specs)
-http://planetquake.gamespy.com/ (additional models)

--------------------
ADDITIONAL RESOURCES
--------------------

Music
http://incompetech.com/m/c/royalty-free/

Message bubbles
http://www.vector-finder.com/free-vector.asp 
http://www.psdgraphics.com/psd/speech-bubbles-psd/

Sound Effects 
http://www.partnersinrhyme.com/pir/PIRsfx.shtml
http://www.soundjay.com

Textures 
http://ftextures.com/
http://filmowe.deviantart.com/art/Water-surface-textures-no-1-37175001
http://designinstruct.com/free-resources/textures/lava-rock-texture-pack/
http://psd.tutsplus.com/articles/web/more-than-350-free-and-premium-wood-textures/
http://www.katsbits.com/download/textures/
http://opengameart.org/content/shipping-container-texture-pack
http://pajunen.deviantart.com
http://3dmodelsheets.com/home_3.html

Also some textures are from real world photos I've taken myself.

----------
FINAL NOTE
----------
I hope you'll enjoy playing this game as much I enjoyed making it!


