Hexen II for PSP

Hexen II for PSP
General
Author	Juraj Styk
Type	Shooter
Version	1.1
License	GPL-2.0
Last Updated	2007/08/29
Links
Download
Website
Source

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

• 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 (through command line params).
• User-made maps loading (from console or command line params).
• Demo recording and playback (from console).
• On-Screen Keyboard (available from console and text input boxes in Multiplayer menus).
• Support for suspending and resuming game.
• Music playback through MP3 implemented with MAD audio library.
• Optimized sky drawing (original, optimised, single color).

Installation

Copy the Hexen2 folder to the /PSP/GAME/ folder on your PSP.

Hexen II:

• Install retail version of Hexen II on your PC.
• 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).
• Go to the directory where you installed PC version of Hexen II.
• 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.)

Hexen II: Portal of Praevus:

• Install the retail version of Hexen II: Portal of Praevus on your PC.
• 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).
• Go to directory where you installed PC version of Hexen II.
• 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.)

(Optional) To use music playback in Hexen II:

• Create a subdirectory named MP3 in the Hexen2 directory.
• Put files named 01.mp3 to 12.mp3 into this directory.
• (Any mp3 should work / tested with mp3 with a constant bitrate of 96 and 192 kbps and sampling rate of 22khz and 44khz)

User guide

Starting the game

Go to PSP and start PSP Hexen II.

Bring up the menu (Start) and select 'Single Player' (Cross):

• Select 'New Mission' (if you want to play 'Portal of Praevus' levels).
• Select 'Old Mission' (if you want to play original levels).
• Select Player class and Difficulty.
• (if you don't see 'Old Mission' option then press Select to go to console and type 'm_oldmission 1').

Analog control

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.

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.

Controls

The PSP buttons are connected to the following keys during the game and when the menu is shown, you will need to set to your desired action in the game options screen.

Select - Toggle console

Start - Show menu

Up/Down - Move forward/backward

Left/Right - Turn left/right

On screen keyboard:

Square - Activate OSK, finish typing and return to console

D-Pad - Select character

Cross - Type

Triangle - Erase last typed character

Circle - Cancel output and return to console

To input 'space', move cursor to empty space and press Cross (cursor will change to 'X')

Console:

Cross - Execute command

Right - Auto complete

L/R - Scroll console output up/down

Up/Down - Browser through previously entered console commands

Screenshots

Changelog

v1.1 2007/08/29

Fixed:

• Rendering errors that could be observed at some places. Two kind of errors are fixed:
  • Problem with surfaces not being drawn sometimes (visible at village2 map at room with hidden portal).
  • 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 through 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).

Credits

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.

External links

• Author's website - http://jurajstyk.host.sk/download.htm (archived)
• DCEmu - https://www.dcemu.co.uk/vbulletin/threads/72460-Hexen-II-for-PSP-v-1-1