==========================================================================
!!!PLEASE READ THE CONTENTS OF THIS FILE COMPLETELY BEFORE DOING ANY FURTHER STEPS!!!
==========================================================================
A first reminder: PLEASE DON'T MESS WITH THE CFG (CONFIG) FILES AND GAME FOLDERS - everything is set up in order to run smooth from the beginning
A second reminder: If the PS Vita would have TV out via HDMI or similar, i would also have linked a video showing you how this game looks like / is running.
I'm proud to present - once released in 2007 by kgsws, now updated by me (nitr8)...
ENHANCED PSP Hexen v2.01 (Special PS Vita MOD v0.1)
---------------------------------------------------------------------
I made several changes upon the last source port by kgsws (v2.01). Here are the changes:
- added MP3 music support
- fixed bug: rapid fire on automap button
- fixed bug: rapid fire on inventory left button
- fixed bug: rapid fire on inventory right button
- fixed bug: main menu entry "INFO" displaying graphical glitch upon entering
- fixed bug: intermission screen displaying graphical glitch
- fixed bug: automap & status bar overlay displaying graphical glitch
- fixed bug: automap background not moving like it does on the PC version
- fixed bug: graphical glitch when displaying first victory screen (hall)
- fixed bug: graphical glitch when displaying second victory screen (orb)
- fixed bug: graphical glitch when displaying third victory screen (chess)
- moved option "END GAME" from "OPTIONS" menu to "GAME FILES" menu
- moved "CHEATS" menu from "OPTIONS" menu to "GAME FILES" menu
- renamed cheat option "WEAPONS" to "GIVE WEAPONS"
- renamed cheat option "ITEMS" to "GIVE ITEMS"
- added "GIVE KEYS" option to "CHEATS" menu
- added "AUTOMAP" option to "CHEATS" menu
- created category "MORE CHEATS..." within "CHEATS" menu
- added "KILL ENEMIES" option to category "MORE CHEATS..." of "CHEATS" menu
- added "CHOOSE MAP" option to category "MORE CHEATS..." of "CHEATS" menu
- created category "SCREEN SETTINGS" within "OPTIONS" menu
- moved "SCREEN SIZE" setting from "OPTIONS"->"MORE..." menu to "OPTIONS"->"SCREEN SETTINGS" menu
- created option to change brightness from within "OPTIONS"->"SCREEN SETTINGS" menu
- created category "CONTROL SETTINGS" within "OPTIONS" menu
- moved "MOUSE SENSITIVITY" setting from "OPTIONS" menu to "OPTIONS"->"CONTROL SETTINGS" menu
- created category "SOUND SETTINGS" within "OPTIONS" menu
- created option "SFX VOLUME" within "SOUND SETTINGS" menu
- created option "MUSIC VOLUME" within "SOUND SETTINGS" menu
- created option "CHOOSE TRACK" within "SOUND SETTINGS" menu
- created category "SYSTEM SETTINGS" within "OPTIONS" menu
- moved "CPU" setting from "OPTIONS" menu to "OPTIONS"->"SYSTEM SETTINGS" menu
- renamed "CPU" setting to "CPU SPEED :"
- created category "GAME SETTINGS" within "OPTIONS" menu
- moved "MESSAGES" setting from "OPTIONS" menu to "OPTIONS"->"GAME SETTINGS" menu
- added separate config files for HEXEN and DEATHKINGS to use separate savegame folders
- customized "HEXEN.CFG" and "DKING.CFG" for better controls (both analog sticks can be used now for perfect movement)
- HARD CODE change for PSVita's left analog stick (was moving and turning - now is moving and strafing)
- code additions for memory / palette cleanup after the game is being ended by using the game's main menu option "QUIT GAME"
- finally some "end of modification" code optimizations
CONTROLS:
-----------------
- TRIANGLE: show / hide automap
- SQUARE: inventory left
- CROSS: JUMP / FLY UP
- CIRCLE: inventory right
- LEFT ANALOG STICK: move forwards & backwards / strafe left & right
- RIGHT ANALOG STICK: turn left & right
- SELECT: open main menu
- START: use selected inventory object
- CURSOR UP: previous weapon
- CURSOR DOWN: next weapon
- CURSOR LEFT / RIGHT: (due to the PSP emulator it's the same as the right analog stick: turn left & right)
- LEFT TRIGGER: open doors / use switches
- RIGHT TRIGGER: fire
- please remember that you have to enable CURSOR LEFT and CURSOR RIGHT within the PSP emulator in order to map the right stick to the functions "TURN LEFT" and "TURN RIGHT"
TODO / WHAT IS STILL MISSING:
-----------------------------------------
- Sound effects in the main menu directly after starting the port from XMB (currently only music is enabled)
KNOWN POSSIBLE BUGS & OTHER ISSUES:
----------------------------------------------------
ISSUE: - sometimes there may be random graphical glitches and some of the game's letters (menu items / pick up text messages) disappear unexpectedly
WORKAROUND: For a temporary solution, restart the game.
I believe that this issue is caused by a memory allocation error.
This error usually doesn't appear twice the time once the game is restarted.
ISSUE: - sometimes the game may be hanging at start or while in game it throws an error that sounds like "...Bad V_DrawPatch..."
WORKAROUND: As said above: this might be caused by a memory allocation error.
Just restart the game and it should work.
ISSUE: - sometimes within the game and at a random time the game may be throwing the error "R_DrawSpriteRange: bad texturecolumn"
WORKAROUND: As said above: this might be caused by a memory allocation error.
Just restart the game and it should work.
ISSUE: - sometimes the game may be hanging at "Entering graphics mode" when trying to run it from XMB
WORKAROUND: As said above: this might be caused by a memory allocation error.
It's possible that you might need to try and run the game several times until it works.
I'm sorry for that but i can't really fix that memory issue. :-(
Sometimes it works instantly and sometimes it needs to be started several times until it will finally run.
If it still won't run, try hard resetting the Vita by holding down the power button until it resets itself.
Then just "RESTART" the PS Vita system when prompted.
ISSUE: - if you obtained the "FLYING" artifact and press the "JUMP" button (CROSS) you will most likely be automatically flying until the artifact's lifetime is drained.
WORKAROUND: I may be looking into this situation but please don't expect to see any new release very soon.
ISSUE: - there is no button to "FLY DOWN"
WORKAROUND: I know of that situation.
The only current workaround for this is approaching a wall: you will automatically "FLY DOWN".
All of these known situations / bugs are not appearing that often. Usually you can play the game for hours until one of the errors mentioned here suddenly appears.
WAD INSTALLATION INFORMATION:
--------------------------------------------
Place the file HEXEN.WAD in the main folder.
Place the file HEXDD.WAD in the main folder (only if you want to play the addon - it's not needed to run the main game "HEXEN").
MP3 SONGLIST INFORMATION:
--------------------------------------
In order to get the original game soundtrack to work in the correct order, you have to download the MIDI music already converted to MP3 format from here...:
https://www.rapidshare.com/files/373017 ... IC_MP3.pk3
...or convert it by yourself (i won't be writing a tutorial for that case since this README is almost long enough).
For the case that you downloaded the PK3 file, you can simply rename the file to ZIP and unpack the MP3 files afterwards.
The really important thing is that you have to rename the songs from the archive in the following order to get the music working in the corresponding order to the original game (lowercase just to be sure):
WINNOWR.MP3 = SONG1.MP3
JACHR.MP3 = SONG2.MP3
SIMONR.MP3 = SONG3.MP3
WUTZITR.MP3 = SONG4.MP3
FALCONR.MP3 = SONG5.MP3
LEVELR.MP3 = SONG6.MP3
CRYPTR.MP3 = SONG7.MP3
SWAMPR.MP3 = SONG8.MP3
DEEPR.MP3 = SONG9.MP3
FUBASR.MP3 = SONG10.MP3
GROVER.MP3 = SONG11.MP3
FORTR.MP3 = SONG12.MP3
VOIDR.MP3 = SONG13.MP3
CHAP_1R.MP3 = SONG14.MP3
SECRETR.MP3 = SONG15.MP3
CHAP_3R.MP3 = SONG16.MP3
CHAP_4R.MP3 = SONG17.MP3
CHIPPYR.MP3 = SONG18.MP3
PERCR.MP3 = SONG19.MP3
FOOJAR.MP3 = SONG20.MP3
SIXATER.MP3 = SONG21.MP3
WOBABYR.MP3 = SONG22.MP3
FANTAR.MP3 = SONG23.MP3
BLECHR.MP3 = SONG24.MP3
BONESR.MP3 = SONG25.MP3
OCTOR.MP3 = SONG26.MP3
RITHMR.MP3 = SONG27.MP3
STALKR.MP3 = SONG28.MP3
BORKR.MP3 = SONG29.MP3
CRUCIBR.MP3 = SONG30.MP3
HEXEN.MP3 = SONG31.MP3
HUB.MP3 = SONG32.MP3
HALL.MP3 = SONG33.MP3
ORB.MP3 = SONG34.MP3
CHESS.MP3 = SONG35.MP3
CHAP_2R.MP3 = SONG36.MP3
You can either do that by using the file "RENAME.BAT" which i provided for Windows users or do it manually by yourself.
If you're done with renaming, you can securely delete the last remaining file which is not used by "HEXEN" neither the addon "DEATHKINGS OF THE DARK CITADEL":
CHARTR.MP3
Finally, place the other renamed 36 MP3 files into the "MUSIC" folder within the "PSP HEXEN"'s directory and you're done.
TESTING AND COMPILING ENVIRONMENT:
---------------------------------------------------
- Ubuntu 13.10 Saucy Salamander 32Bit Desktop
- PSP-SDK with GCC v4.1.0 by ZX-81
- PPSSPP v0.9.6-20-g409098d (SDL release)
- PSP HEXEN v2.01 by kgsws
- HEXEN's main IWAD file "HEXEN.WAD" v1.1
- HEXEN - Deathkings of the Dark Citadel's main PWAD file "HEXDD.WAD" v1.1
- PS Vita with Firmware v3.01
- NUMBLAST EU (working)
- PERSONA 2 EU (working)
- KING OF POOL EU (working)
- TN-V8 eCFW
CREDITS FLY OUT TO:
-----------------------------
- ZX-81 for the required PSP-SDK
- The Doom Legacy Team
- kgsws for his original PSP-Hexen port
- TotalNoob for his TN-V eCFW
- Duke for the MP3 engine
ADDITIONAL INFORMATION:
------------------------------------
- a last reminder: PLEASE DON'T MESS WITH THE CFG (CONFIG) FILES AND GAME FOLDERS - everything is set up in order to run smooth from the beginning
- i did not test HEXEN's v1.0 IWAD: you WON'T be able to warp to map 41 which is part of HEXEN's v1.0 IWAD
- i even didn't test v1.0 of HEXEN's addon "DEATHKINGS OF THE DARK CITADEL" so please don't expect too much
- i'm mostly done with this port and i DON'T believe that i'll do anything more than i have already done to it
- i made changes to this port because it didn't (like other ports) have music support and that once was my only intention
- PSP Legacy v4 supports DOOM, DOOM II, FINAL DOOM (both episodes TNT & EVILUTION) and HERETIC and MP3 music as well for all of those games, but it only lacks HEXEN and STRIFE game support
- this is the reason why i wanted a working HEXEN port for the PS Vita's PSP emulator with music support
- when the source code of the DOOM engine was released, it lacked the source code of the DMX engine by Paul Radek which manages the MIDI music (license issues)
- that's how it all started and when besides the music support also other modifications by myself came in
P.S.:
--------
I did not upload the MP3 files at RAPIDSHARE so please don't blame me for that if you need to.
All the rest i can say is:
Have fun with this port. I think you won't find a similar PSP Hexen port out there that nearly supports all of the features that this port got now.
!!!PLEASE READ THE CONTENTS OF THIS FILE COMPLETELY BEFORE DOING ANY FURTHER STEPS!!!
==========================================================================
A first reminder: PLEASE DON'T MESS WITH THE CFG (CONFIG) FILES AND GAME FOLDERS - everything is set up in order to run smooth from the beginning
A second reminder: If the PS Vita would have TV out via HDMI or similar, i would also have linked a video showing you how this game looks like / is running.
I'm proud to present - once released in 2007 by kgsws, now updated by me (nitr8)...
ENHANCED PSP Hexen v2.01 (Special PS Vita MOD v0.1)
---------------------------------------------------------------------
I made several changes upon the last source port by kgsws (v2.01). Here are the changes:
- added MP3 music support
- fixed bug: rapid fire on automap button
- fixed bug: rapid fire on inventory left button
- fixed bug: rapid fire on inventory right button
- fixed bug: main menu entry "INFO" displaying graphical glitch upon entering
- fixed bug: intermission screen displaying graphical glitch
- fixed bug: automap & status bar overlay displaying graphical glitch
- fixed bug: automap background not moving like it does on the PC version
- fixed bug: graphical glitch when displaying first victory screen (hall)
- fixed bug: graphical glitch when displaying second victory screen (orb)
- fixed bug: graphical glitch when displaying third victory screen (chess)
- moved option "END GAME" from "OPTIONS" menu to "GAME FILES" menu
- moved "CHEATS" menu from "OPTIONS" menu to "GAME FILES" menu
- renamed cheat option "WEAPONS" to "GIVE WEAPONS"
- renamed cheat option "ITEMS" to "GIVE ITEMS"
- added "GIVE KEYS" option to "CHEATS" menu
- added "AUTOMAP" option to "CHEATS" menu
- created category "MORE CHEATS..." within "CHEATS" menu
- added "KILL ENEMIES" option to category "MORE CHEATS..." of "CHEATS" menu
- added "CHOOSE MAP" option to category "MORE CHEATS..." of "CHEATS" menu
- created category "SCREEN SETTINGS" within "OPTIONS" menu
- moved "SCREEN SIZE" setting from "OPTIONS"->"MORE..." menu to "OPTIONS"->"SCREEN SETTINGS" menu
- created option to change brightness from within "OPTIONS"->"SCREEN SETTINGS" menu
- created category "CONTROL SETTINGS" within "OPTIONS" menu
- moved "MOUSE SENSITIVITY" setting from "OPTIONS" menu to "OPTIONS"->"CONTROL SETTINGS" menu
- created category "SOUND SETTINGS" within "OPTIONS" menu
- created option "SFX VOLUME" within "SOUND SETTINGS" menu
- created option "MUSIC VOLUME" within "SOUND SETTINGS" menu
- created option "CHOOSE TRACK" within "SOUND SETTINGS" menu
- created category "SYSTEM SETTINGS" within "OPTIONS" menu
- moved "CPU" setting from "OPTIONS" menu to "OPTIONS"->"SYSTEM SETTINGS" menu
- renamed "CPU" setting to "CPU SPEED :"
- created category "GAME SETTINGS" within "OPTIONS" menu
- moved "MESSAGES" setting from "OPTIONS" menu to "OPTIONS"->"GAME SETTINGS" menu
- added separate config files for HEXEN and DEATHKINGS to use separate savegame folders
- customized "HEXEN.CFG" and "DKING.CFG" for better controls (both analog sticks can be used now for perfect movement)
- HARD CODE change for PSVita's left analog stick (was moving and turning - now is moving and strafing)
- code additions for memory / palette cleanup after the game is being ended by using the game's main menu option "QUIT GAME"
- finally some "end of modification" code optimizations
CONTROLS:
-----------------
- TRIANGLE: show / hide automap
- SQUARE: inventory left
- CROSS: JUMP / FLY UP
- CIRCLE: inventory right
- LEFT ANALOG STICK: move forwards & backwards / strafe left & right
- RIGHT ANALOG STICK: turn left & right
- SELECT: open main menu
- START: use selected inventory object
- CURSOR UP: previous weapon
- CURSOR DOWN: next weapon
- CURSOR LEFT / RIGHT: (due to the PSP emulator it's the same as the right analog stick: turn left & right)
- LEFT TRIGGER: open doors / use switches
- RIGHT TRIGGER: fire
- please remember that you have to enable CURSOR LEFT and CURSOR RIGHT within the PSP emulator in order to map the right stick to the functions "TURN LEFT" and "TURN RIGHT"
TODO / WHAT IS STILL MISSING:
-----------------------------------------
- Sound effects in the main menu directly after starting the port from XMB (currently only music is enabled)
KNOWN POSSIBLE BUGS & OTHER ISSUES:
----------------------------------------------------
ISSUE: - sometimes there may be random graphical glitches and some of the game's letters (menu items / pick up text messages) disappear unexpectedly
WORKAROUND: For a temporary solution, restart the game.
I believe that this issue is caused by a memory allocation error.
This error usually doesn't appear twice the time once the game is restarted.
ISSUE: - sometimes the game may be hanging at start or while in game it throws an error that sounds like "...Bad V_DrawPatch..."
WORKAROUND: As said above: this might be caused by a memory allocation error.
Just restart the game and it should work.
ISSUE: - sometimes within the game and at a random time the game may be throwing the error "R_DrawSpriteRange: bad texturecolumn"
WORKAROUND: As said above: this might be caused by a memory allocation error.
Just restart the game and it should work.
ISSUE: - sometimes the game may be hanging at "Entering graphics mode" when trying to run it from XMB
WORKAROUND: As said above: this might be caused by a memory allocation error.
It's possible that you might need to try and run the game several times until it works.
I'm sorry for that but i can't really fix that memory issue. :-(
Sometimes it works instantly and sometimes it needs to be started several times until it will finally run.
If it still won't run, try hard resetting the Vita by holding down the power button until it resets itself.
Then just "RESTART" the PS Vita system when prompted.
ISSUE: - if you obtained the "FLYING" artifact and press the "JUMP" button (CROSS) you will most likely be automatically flying until the artifact's lifetime is drained.
WORKAROUND: I may be looking into this situation but please don't expect to see any new release very soon.
ISSUE: - there is no button to "FLY DOWN"
WORKAROUND: I know of that situation.
The only current workaround for this is approaching a wall: you will automatically "FLY DOWN".
All of these known situations / bugs are not appearing that often. Usually you can play the game for hours until one of the errors mentioned here suddenly appears.
WAD INSTALLATION INFORMATION:
--------------------------------------------
Place the file HEXEN.WAD in the main folder.
Place the file HEXDD.WAD in the main folder (only if you want to play the addon - it's not needed to run the main game "HEXEN").
MP3 SONGLIST INFORMATION:
--------------------------------------
In order to get the original game soundtrack to work in the correct order, you have to download the MIDI music already converted to MP3 format from here...:
https://www.rapidshare.com/files/373017 ... IC_MP3.pk3
...or convert it by yourself (i won't be writing a tutorial for that case since this README is almost long enough).
For the case that you downloaded the PK3 file, you can simply rename the file to ZIP and unpack the MP3 files afterwards.
The really important thing is that you have to rename the songs from the archive in the following order to get the music working in the corresponding order to the original game (lowercase just to be sure):
WINNOWR.MP3 = SONG1.MP3
JACHR.MP3 = SONG2.MP3
SIMONR.MP3 = SONG3.MP3
WUTZITR.MP3 = SONG4.MP3
FALCONR.MP3 = SONG5.MP3
LEVELR.MP3 = SONG6.MP3
CRYPTR.MP3 = SONG7.MP3
SWAMPR.MP3 = SONG8.MP3
DEEPR.MP3 = SONG9.MP3
FUBASR.MP3 = SONG10.MP3
GROVER.MP3 = SONG11.MP3
FORTR.MP3 = SONG12.MP3
VOIDR.MP3 = SONG13.MP3
CHAP_1R.MP3 = SONG14.MP3
SECRETR.MP3 = SONG15.MP3
CHAP_3R.MP3 = SONG16.MP3
CHAP_4R.MP3 = SONG17.MP3
CHIPPYR.MP3 = SONG18.MP3
PERCR.MP3 = SONG19.MP3
FOOJAR.MP3 = SONG20.MP3
SIXATER.MP3 = SONG21.MP3
WOBABYR.MP3 = SONG22.MP3
FANTAR.MP3 = SONG23.MP3
BLECHR.MP3 = SONG24.MP3
BONESR.MP3 = SONG25.MP3
OCTOR.MP3 = SONG26.MP3
RITHMR.MP3 = SONG27.MP3
STALKR.MP3 = SONG28.MP3
BORKR.MP3 = SONG29.MP3
CRUCIBR.MP3 = SONG30.MP3
HEXEN.MP3 = SONG31.MP3
HUB.MP3 = SONG32.MP3
HALL.MP3 = SONG33.MP3
ORB.MP3 = SONG34.MP3
CHESS.MP3 = SONG35.MP3
CHAP_2R.MP3 = SONG36.MP3
You can either do that by using the file "RENAME.BAT" which i provided for Windows users or do it manually by yourself.
If you're done with renaming, you can securely delete the last remaining file which is not used by "HEXEN" neither the addon "DEATHKINGS OF THE DARK CITADEL":
CHARTR.MP3
Finally, place the other renamed 36 MP3 files into the "MUSIC" folder within the "PSP HEXEN"'s directory and you're done.
TESTING AND COMPILING ENVIRONMENT:
---------------------------------------------------
- Ubuntu 13.10 Saucy Salamander 32Bit Desktop
- PSP-SDK with GCC v4.1.0 by ZX-81
- PPSSPP v0.9.6-20-g409098d (SDL release)
- PSP HEXEN v2.01 by kgsws
- HEXEN's main IWAD file "HEXEN.WAD" v1.1
- HEXEN - Deathkings of the Dark Citadel's main PWAD file "HEXDD.WAD" v1.1
- PS Vita with Firmware v3.01
- NUMBLAST EU (working)
- PERSONA 2 EU (working)
- KING OF POOL EU (working)
- TN-V8 eCFW
CREDITS FLY OUT TO:
-----------------------------
- ZX-81 for the required PSP-SDK
- The Doom Legacy Team
- kgsws for his original PSP-Hexen port
- TotalNoob for his TN-V eCFW
- Duke for the MP3 engine
ADDITIONAL INFORMATION:
------------------------------------
- a last reminder: PLEASE DON'T MESS WITH THE CFG (CONFIG) FILES AND GAME FOLDERS - everything is set up in order to run smooth from the beginning
- i did not test HEXEN's v1.0 IWAD: you WON'T be able to warp to map 41 which is part of HEXEN's v1.0 IWAD
- i even didn't test v1.0 of HEXEN's addon "DEATHKINGS OF THE DARK CITADEL" so please don't expect too much
- i'm mostly done with this port and i DON'T believe that i'll do anything more than i have already done to it
- i made changes to this port because it didn't (like other ports) have music support and that once was my only intention
- PSP Legacy v4 supports DOOM, DOOM II, FINAL DOOM (both episodes TNT & EVILUTION) and HERETIC and MP3 music as well for all of those games, but it only lacks HEXEN and STRIFE game support
- this is the reason why i wanted a working HEXEN port for the PS Vita's PSP emulator with music support
- when the source code of the DOOM engine was released, it lacked the source code of the DMX engine by Paul Radek which manages the MIDI music (license issues)
- that's how it all started and when besides the music support also other modifications by myself came in
P.S.:
--------
I did not upload the MP3 files at RAPIDSHARE so please don't blame me for that if you need to.
All the rest i can say is:
Have fun with this port. I think you won't find a similar PSP Hexen port out there that nearly supports all of the features that this port got now.
