Quake for PSP v1.1
==================

Original Release:
Peter Mackay
5th Jan 2006

Adhoc Code v1.1:
Chris Swindle
29th Jan 2006

Here is the latest build of the multiplayer support version of Quake, in this build it has the following additions:
- Infrastructure mode added
- Adhoc & Infrastructure are now enabled via the network menu
- The access point for infrastructure mode setting is in setup in the network settings
- Hacks to speed up the FPS to enable network versions to have less lag
- Sound support in both adhoc & infrastructure

In order to change the access point that you want to use, just got to the network setup menu and press left or right on the access point box.

I will probably not be releasing the source for this version as it needs quite a tidy up, however as I have now added in turning on and off wifi I will probably be merging the code with Peter so that we only have one version going forwards (unless I fix a few bugs that people find before doing that).

Hope everyone enjoys.


Adhoc Code v1:
Chris Swindle
27th Jan 2006

I have added Adhoc support to Quake, I have however removed sound support in this release as I was doing it as a proof of concept to see how well the adhoc procedures work in a real game. Some of the code changes are probably not required in the source. Also please note that adhoc is enabled at startup so it is probably best not to use this version to play single player games. In order to play multiplayer, just start up a server on one PSP and search for hosts on the other PSP.

Please note that I have only been able to test this with 2 PSP's, so I am not sure how well it will work with more than two.


Here are the original release notes:

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

This is a port of id Software's Quake to the PSP. There's already an excellent port out there by PacManFan, but I wanted to code something for the PSP and it was a good project. I also wanted to port from the original id source, instead of the PocketQuake source.


Features
--------

The following is working fine:
- Software rendering.
- Sound.

Things missing:
- WLAN support for network play. Nobody I know has a PSP, so I can't implement this.
- Hardware rendering. I have no PSP GU experience, so it'll take a while to do.


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

This game is for PSPs with firmware versions 1.0 or 1.5. To get it running on other versions, you will need to up/downgrade your firmware appropriately. Unfortunately I don't have a v1.0 PSP, so I can only hope that it works on that version of the firmware.

It almost definitely won't work with a v2.00 EBOOT loader.

Installation instructions:
1. READ THE CONTROLS SECTION BELOW.
2. Firmware v1.0 users:
Copy the Quake folder from the 1.0 folder to the PSP/GAME folder on your PSP.
Firmware v1.5 users:
Copy the Quake and Quake% folders from the 1.5 folder to the PSP/GAME folder on your PSP.
3. Download the shareware version of Quake for the PC from here:
http://www.idsoftware.com/games/quake/quake/index.php?game_section=demo
4. Copy PC Quake's ID1 folder to your PSP/GAME/Quake folder.


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 Quake's options 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 / ENTER |
CROSS | CROSS | ENTER / ESCAPE |
SQUARE | SQUARE | |

For example, when you press CROSS, Quake 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.


Support
-------

I don't intend to provide personal email support for this game. I believe that I'd get a lot of useless mail if I were to publish my email address for this purpose.

If you can't get Quake running, try posting on a related PSP forum and hopefully someone can help you.

Known bugs:
- Fast key taps may go unnoticed when the frame rate is low. This is because I'm not sure how to get buffered input on the PSP. Does the PSPSDK support it?

If you've found a bug in the code, please post about it. I will probably read it and fix the bug if I can.


Thanks
------

Big thanks go out to:
- All the great guys on the PS2Dev forum for all your hard work on the PSPSDK, and your helpful replies on the forum.
- id Software, for supporting the game porting community by making their game sources GPL.
- Hazel, for putting up with the complete lack of attention from me while I was working on this.