Filetrip Logo


Hexen II (1.5 and 3.xx User Mode) 1.1



Introduction
------------

This is a port of Raven Software's Hexen II to the PSP.
Based on PSP Quake port by Peter Mackay and original Hexen II
source code released under GNU GPL License.
Compiled and linked with PSPDev Environment for Win32.

Features
--------

Working:
- Software rendering.
- Single player game and Portal of Praevus single player game
- Sound
- Save/Load
- Console commands
- Command line commands (through 'hexen2.cmdline' file)
- Multiple screen resolutions (trough command line params)
- User made maps loading (from console or command line params)
- Demo recording and playback (from console)
- On Screen Keyboard

Missing:
- Music playback
(disabled)

Untested:
- Multi player
(creating multi player game works)

Known issues:
- No progress bar displayed when starting/loading/saving game
(disabled because of stability problems)
- Restart or reload of a current map necessary if value of console variable
'r_transwater' is changed (otherwise water surfaces will not be rendered correctly)
- User made mods with modified progs.dat files will not work
- Sprite models with width or height that is not multiple of 4 can cause game to crash
- Some weird graphical artifacts can be observed sometimes


Installation
------------

This game is for PSPs with firmware versions 1.5 or for custom firmwares.
If you want to try to make it running on other versions, you will need to
download source code and recompile it yourself. Developed and tested on PSP
with firmware version '3.03 OE-C' in 1.5 kernel mode.

Installation instructions:
1. Unzip the package

1.5 firmware users:
Copy the Hexen2 and Hexen2% folders to the PSP/GAME folder on your PSP.

Custom firmware users:
Copy the Hexen2 and Hexen2% folders to the PSP/GAME150 folder on your PSP.

2. Install retail version of Hexen II on your PC

4. Download and install 'ph2v111.exe' to patch Hexen II to version 1.11
( you can get it from Raven Software official Hexen II home page at
http://hexen2.ravengames.com/raven-downloads.php )

5. Go to directory where you installed PC version of Hexen II

6. Copy DATA1 folder from this directory to Hexen2 directory on your PSP.

( Now you can go to PSP and start Hexen II or continue installing Hexen II mission pack)

7. Install retail version of Hexen II: Portal of Praevus on your PC

8. Download and install 'H2MP_Patch_v112a.exe' to patch Hexen II to version 1.12
( you can get it from Raven Software official Hexen II home page at
http://hexen2.ravengames.com/pop_patches.php )

9. Go to directory where you installed PC version of Hexen II

10. Copy portals folder from this directory to Hexen2 folder on your PSP.
( some files ( pak3.pak ) already in portals directory on PSP will be overwritten -
those files are necessary to make Hexen II work if mission pack is not installed )

( Now you can go to PSP and start Hexen II)

Starting game
-------------
Go to PSP and start PSP Hexen II
Press 'start' to bring up menu select 'Single Player' and press 'CROSS'
Select 'New Mission' (if you want to play 'Portal of Praevus' levels) or
select 'Old Mission' (if you want to play original levels) and press 'CROSS'
Select Player class and Dificulty
(if you dont see 'Old Mission' option then press 'select' to go to console and
type 'm_oldmission 1';)

Controls
--------

Regarding the buttons:

The PSP buttons are connected to the following keys during the game and when the menu
is shown. You will need to go into options menu and configure the keys you want to use.

PSP | Game key | Menu key | Default game function
---------+------------+------------+----------------------
SELECT | ~ | ~ | Toggle console
START | ESCAPE | ESCAPE | Show menu
LTRIGGER | LTRIGGER | |
RTRIGGER | RTRIGGER | |
UP | UPARROW | UPARROW | Move forward
RIGHT | RIGHTARROW | RIGHTARROW | Turn right
DOWN | DOWNARROW | DOWNARROW | Move backwards
LEFT | LEFTARROW | LEFTARROW | Turn left
TRIANGLE | TRIANGLE | |
CIRCLE | CIRCLE | ESCAPE |
CROSS | CROSS | ENTER |
SQUARE | SQUARE | |

For example, when you press CROSS, game gets a CROSS key press, which you will
need to set to your desired action in the game options screen.

Regarding the analog nub:

If mouselook is turned on, then the analog nub is used to look around.
You'll need to allocate other buttons for movement. If mouselook is turned off,
which is the default, then the analog nub is used for movement.


On screen keyboard (OSK)
-----------------------
Available from console and from text input boxes in Multiplayer menus.

Press SQUARE to activate the OSK.

Is OSK use arrows to select character and press CROSS to type it. To input 'space'
move cursor to empty space (cursor will change to 'X';) and press CROSS.
Press TRIANGLE to erase last typed character. Press SQUARE to finish typing and
return to console. Press CIRCLE to cancel input and return to console.

When back in console execute command by pressing CROSS.
Press RIGHT ARROW to use auto complete feature. L/R Buttons scroll console output up and down.
UP/DOWND ARROW browse trough previously entered console commands.

Command line options
--------------------
If you want to start Hexen II with some specific command line options create file named
'hexen2.cmdline' in Hexen directory (the same directory that contains eboot.pbp) and put
command line option here

example:
-condebug -rwidth 368 -rheight 272 -swidth 368 -sheight 272 +map demo3

(will start Hexen II in map demo3 with console logging and with render and screen resolution
set both to 368 x 272)

PSP specific command line options
---------------------------------
-rwidth
-rheight
-swidth
-sheight

'-rwidth' and '-rheight' set resolution at which is game rendered internally
( default: 320x200 )
'-swidth' and '-sheight' set resolution at which is internally rendered image displayed
( default: 480x272 )

Any resolution between 320x200 and 480x272 will work as long both width and height is multiple of 8

Thanks
------

Big thanks go out to:
- Raven Software, for releasing Hexen II source code .
- Peter Mackay, for creating PSP Quake port which made porting Hexen II to PSP very easy.
- Underbit Technologies for MAD audio library and John_K for porting it to PSP.
- Makers of PSPDev Environment for Win32.

Change log (1.1):
Fixed:
- Rendering errors that could be observed at some places
Two kind of errors are fixed :
1. Problem with surfaces not being drawn sometimes (visible at village2 map at room with hidden portal )
2. Problem with rendering beyong the edge of surface (visible at demo3 map at section with bell and uderground passage)
- Switching between transparent and opaque water no longer requires map reloading
- Some fixes related to model transparency rendering

New Features:
- Support for suspending and resuming game
- Music playback trough MP3 implemented with MAD audio library
(can be switched on/off from options menu or from console)
- Optimised sky drawing
(three modes are available now : original, optimised , single color)

Untested:
- Multi player
(creating multi player game works)

Known issues:
- No progress bar displayed when starting/loading/saving game
(disabled because of stability problems)
- User made mods with modified progs.dat files will not work
- Sprite models with width or height that is not multiple of 4 can cause game to crash

New console variables:
- r_sky_style - for switching bethend sky rendering modes
(default: 1 range: 0-2)
- r_sky_color - defines which color to use in single color sky rendering mode
(default: 0 range 0 - 255)

If you want to use music playback in Hexen II:
1. Create a subdirectory named MP3 in the Hexen2 directory
2. Put files named 01.mp3 to 12.mp3 into this directory
(any mp3 should work / tested with mp3 with constant bitrate of 96 and 192 kbps
and samplind rate of 22khz and 44khz)
comments powered by Disqus