Skip to content

Commit 912d0bd

Browse files
authored
Quake: add more info and restrucre the page
* added Quake2 info (Yamagi Quake II) * added `ioquke3` as Q3 port * restructured the headings, so the TOC is correctly generated * re-worded some instructions * added info and link to `lr-tyrquake` gamepad controls * fixed the Quake pic.
1 parent 93dfa74 commit 912d0bd

File tree

1 file changed

+97
-40
lines changed

1 file changed

+97
-40
lines changed

docs/Quake.md

Lines changed: 97 additions & 40 deletions
Original file line numberDiff line numberDiff line change
@@ -2,100 +2,94 @@
22
***
33
_Quake was a First Person Shooter series originally developed for the PC by Id Software. It is a successor to the Doom Series._
44

5-
_There are 4 Quake games: Quake, Quake II, and Quake III Arena and Quake 4. RetroPie includes Quake, TyrQuake (an optimised build of the original Quake Engine), and Quake III Arena._
5+
_There are 4 Quake games: Quake, Quake II, and Quake III Arena and Quake 4. RetroPie includes ports for Quake, Quake II and Quake III Arena._
66

77
_The source code to the original Quake engine was released under the GPLv2 license on December 21st 1999. This has enabled a wide variety of source ports and improvements to be made and for the game to run on alternative operating systems and architectures._
88

99
***
10-
# Quake
11-
![](http://www.gameranx.com/images/updates/1294053269_quake_fps.jpg)
10+
## Quake
11+
![](https://cdn.cloudflare.steamstatic.com/steam/apps/2310/header.jpg)
1212

1313
***
1414
_The RetroPie Setup Script automatically installs the Quake 1 shareware game data._
1515

16-
***
17-
## Emulator
16+
### Ports
1817

1918
* [libretro-tyrquake](https://github.com/libretro/tyrquake) (recommended)
2019
* [tyrquake](https://github.com/RetroPie/tyrquake)
2120
* [Darkplaces Quake](https://github.com/autonomous1/darkplacesrpi)
2221

23-
## Controls
24-
25-
`libretro-tyrquake` utilises Retroarch configurations and is the recommended port.
26-
27-
Add custom RetroArch controls to the `retroarch.cfg` file in
22+
### Controls
2823

29-
```shell
30-
/opt/retropie/configs/quake/retroarch.cfg
31-
```
32-
For more information on custom RetroArch controls see: [RetroArch Configuration](RetroArch-Configuration)
24+
`libretro-tyrquake` utilises Retroarch configurations and is the recommended port, since it supports a joystick/gamepad to play. See [here](https://docs.libretro.com/library/tyrquake/#joypad) for how the inputs are mapped to the Quake's keyboard.
25+
You can also switch to a mouse/keyboard combination by changing the the _Device Type_ of the Player 1 connected controller to _Keyboard + Mouse_.
3326

34-
`tyrquake` does not support joystick/gamepad input, so is suitable only for those with a keyboard and mouse.
27+
The other ports use the keyboard and mouse for controls.
3528

36-
## Upgrading Shareware to Registered
29+
### Upgrading Shareware version to Registered
3730

3831
During installation of the port, the setup script places the shareware version of the Quake data files at:
3932

4033
~~~
4134
/home/pi/RetroPie/roms/ports/quake/id1/pak0.pak
4235
~~~
4336

44-
If you own the registered version, you may add the registered version data file at:
37+
If you own the registered version, you may add the `id1` folder files from the installation of the registered version to:
4538

4639
~~~
47-
/home/pi/RetroPie/roms/ports/quake/id1/pak1.pak
40+
/home/pi/RetroPie/roms/ports/quake/id1/
4841
~~~
4942

5043
The shareware version is Quake v1.06. It is recommended your registered data file be from v1.06 or v1.08 versions of the game, earlier versions may not be compatible.
5144

5245
There is no difference between the data files of v1.06 and v1.08, this was an update to the game engine only, not the data files.
5346

54-
## Quake Mission Packs
47+
### Quake Mission Packs
5548

5649
In addition to many community maps, Quake had some commercial add-ons which are considered "official".
5750

58-
### Mission Pack 1: Scourge of Armagon
51+
#### Scourge of Armagon
5952

60-
Scourge of Armagon (aka `hipnotic`) was the first official Quake Mission Pack, sold by Hipnotic Interactive in 1997.
53+
Scourge of Armagon (aka `hipnotic`) was the first official Quake Mission Pack, developed by Hipnotic Interactive and released in 1997.
6154

62-
Place the data file at:
55+
Place the `hipnotic/pak0.pak` file from your registered installation at:
6356

6457
~~~
6558
/home/pi/RetroPie/roms/ports/quake/hipnotic/pak0.pak
6659
~~~
6760

68-
Reinstall the Quake port from the Setup Script, and a new option **Quake Mission Pack 1 (hipnotic)** will be created.
61+
Reinstall the Quake port from the Setup Script and a **Quake Mission Pack 1 (hipnotic)** launcher will be added in _Ports_.
6962

70-
### Mission Pack 2 - Dissolution of Eternity
63+
#### Dissolution of Eternity
7164

72-
Dissolution of Eternity (aka `rogue`) is the second official Quake Mission Pack, sold by Rogue Entertainment in 1997.
65+
Dissolution of Eternity (aka `rogue`) is the second official Quake Mission Pack, developed by Rogue Entertainment and released in 1997.
7366

74-
Place the data file at:
67+
Place he `rogue/pak0.pak` file from your registered installation at:
7568

7669
~~~
7770
/home/pi/RetroPie/roms/ports/quake/rogue/pak0.pak
7871
~~~
7972

80-
Reinstall the Quake port from the Setup Script, and a new option **Quake Mission Pack 2 (rogue)** will be created.
73+
Reinstall the Quake port from the Setup Script, and a new entry - **Quake Mission Pack 2 (rogue)** - will be created in _Ports_.
8174

82-
### Episode 5 - Dimension of the Past
75+
#### Episode 5 - Dimension of the Past
8376

84-
To celebrate Quake's 20th anniversary, MachineGames (developer of Wolfenstein: The New Order) created a new 10-level pack named *Episode 5 - Dimension of the Past* and released it for free at https://cdn.bethsoft.com/quake/dopa.rar
77+
To celebrate Quake's 20th anniversary, MachineGames (developer of Wolfenstein: The New Order) created a new 10-level pack named *Episode 5 - Dimension of the Past* and released it for free at <https://cdn.bethsoft.com/quake/dopa.rar>.
8578

8679
To get DOPA working in the RetroPie Quake ports, create a directory at:
8780

8881
~~~
8982
/home/pi/RetroPie/roms/ports/quake/dopa/
9083
~~~
9184

92-
Place the data file at:
85+
Place the `pak0.pak` file from the DOPA archive file at:
9386

9487
~~~
9588
/home/pi/RetroPie/roms/ports/quake/dopa/pak0.pak
9689
~~~
9790

98-
Reinstall the Quake port from the Setup Script, and a new option **Quake Episode 5 (dopa)** will be created.
91+
Reinstall the Quake port from the Setup Script, and a new entry - **Quake Episode 5 (dopa)** - will be created in _Ports_.
92+
9993

10094
### Soundtrack Files
10195

@@ -105,7 +99,7 @@ CD audio should be ripped into OGG format files, and placed into a subfolder nam
10599

106100
For more information refer to [this guide](https://steamcommunity.com/sharedfiles/filedetails/?id=119489135) and the directory structure below.
107101

108-
### Directory structure, an overview
102+
### Directory structure - overview
109103

110104
The files `s0.sav` up to `s11.sav` represents structure of savegames.
111105

@@ -144,12 +138,72 @@ dopa/
144138
└── s1.sav
145139
~~~
146140

147-
## References
141+
### References
142+
143+
* <https://retropie.org.uk/forum/topic/2431/solved-partly-issue-with-joypad-control-how-to-start-doom-doom2-heretic-and-all-episodes-of-quake-dopa-rogue-hipnotic>
144+
* <https://twitter.com/machinegames/status/746363189768650752>
145+
* <https://retropie.org.uk/forum/topic/11508/launching-quake-and-it-s-extras-1-year-anniversary-release>
146+
147+
148+
## Quake II
149+
150+
![](https://cdn.cloudflare.steamstatic.com/steam/apps/2320/header.jpg)
151+
152+
***
153+
154+
_Quake II is the 2nd game in the Quake Series, though not a sequel to the first installment._
155+
156+
***
157+
_The RetroPie installation script downloads and configured the Q2 Shareware/Demo (v3.14)._
158+
159+
The Quake II port installed is [Yamagi Quake II](https://github.com/yquake2/yquake2).
160+
161+
### Controls
162+
163+
Yamagi Quake II supports gamepad controls, they can be customized from the in-game menu.
164+
165+
### Upgrading Shareware version to Registered
166+
167+
During installation of the port, the setup script places the shareware version of the Quake II data files at:
168+
169+
```
170+
/home/pi/RetroPie/roms/ports/quake2/baseq2/pak0.pak
171+
```
148172

149-
* https://retropie.org.uk/forum/topic/2431/solved-partly-issue-with-joypad-control-how-to-start-doom-doom2-heretic-and-all-episodes-of-quake-dopa-rogue-hipnotic
150-
* https://twitter.com/machinegames/status/746363189768650752
151-
* https://retropie.org.uk/forum/topic/11508/launching-quake-and-it-s-extras-1-year-anniversary-release
152-
# Quake III Arena
173+
If you own the registered version, you may add the `baseq2` folder files from the installation of the registered version to:
174+
175+
```
176+
/home/pi/RetroPie/roms/ports/quake2/baseq2
177+
```
178+
179+
### Mission Packs
180+
181+
#### The Reckoning
182+
183+
Quake II Mission Pack: The Reckoning (aka `xatrix`) is the first official Quake II Mission Pack, developed by Xatrix Entertainment and released in 1998.
184+
185+
Copy the `xatrix` folder contents from your mission pack installation at:
186+
187+
~~~
188+
/home/pi/RetroPie/roms/ports/quake2/xatrix
189+
~~~
190+
191+
Reinstall the Quake II port from the Setup Script, and a new entry - **Quake II - The Reckoning** - will be created in _Ports_.
192+
193+
#### Ground Zero
194+
195+
Quake II Mission Pack: Ground Zero (aka `rogue`) is the second official Quake II Mission Pack, developed by Rogue Entertainment and released in 1998.
196+
197+
Copy the `rogue` folder contents from your mission pack installation at:
198+
199+
~~~
200+
/home/pi/RetroPie/roms/ports/quake2/rogue
201+
~~~
202+
203+
Reinstall the Quake II port from the Setup Script, and a new entry - **Quake II - Ground Zero** - will be created in _Ports_.
204+
205+
206+
## Quake III Arena
153207

154208
![](http://cdn.akamai.steamstatic.com/steam/apps/2200/header.jpg?t=1343157282)
155209

@@ -158,9 +212,12 @@ dopa/
158212
_Quake III Arena is the 3rd game in the Quake Series. It differs from the others in the sense that it is all multiplayer._
159213

160214
***
161-
## Port: [ioQuake3](https://github.com/raspberrypi/quake3)
215+
### Ports
216+
* an [ioQuake3](https://github.com/raspberrypi/quake3) Raspberry PI optimized build, useful for Pi3/Pi2.
217+
* the official [ioQuake3][https://github.com/ioquake/ioq3] engine, for PC and more powerful SBC (Pi4/Odroid) systems.
218+
219+
### Controls
162220

163-
## Controls:
164221
Key | Action
165222
--- | ---
166223
Ctrl or Left Mouse Click | Attack
@@ -183,4 +240,4 @@ C | Crouch
183240
TAB | Stats
184241
T | Chat
185242
F11 | Take Screenshot
186-
ESC | Menu
243+
ESC | Menu

0 commit comments

Comments
 (0)