aboutsummaryrefslogtreecommitdiff
path: root/games/maelstrom/Maelstrom.6
blob: 8a2b5f1a35018b4b23da08a49bd9560a20cb24ce (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
.TH MAELSTROM "6" "April 2009" "Ambrosia Software" "Games"
.SH NAME
Maelstrom \- Enhanced Asteroids\-like game
.SH SYNOPSIS
.B Maelstrom
[\-netscores] \-printscores
.P
.B Maelstrom
[options]
.P
.B Maelstrom\-netd
.br
\fI(see NETWORKING, below, for a description of Maelstrom\-netd)\fR
.SH DESCRIPTION
Maelstrom is a game based on Asteroids, but with several gameplay enhancements:
.P
\- High\-resolution color graphics
.br
\- Digital audio
.br
\- Powerups
.br
\- Networked multiplayer/deathmatch mode (up to 3 players)
.br
\- World\-wide high score server
.P
Game storyline:
.br
You pilot your ship through the dreaded "Maelstrom" asteroid belt \-\-
suddenly your best friend thrusts towards you and fires, directly at your
cockpit. You raise your shields just in time, and the battle is joined.
.P
The deadliest stretch of space known to mankind has just gotten
deadlier. Everywhere massive asteroids jostle for a chance to crush your
ship, and deadly shinobi fighter patrols pursue you across the asteroid
belt. But the deadliest of them all is your sister ship, assigned to
you on patrol. The pilot, trained by your own Navy, battle hardened by
months in the Maelstrom, is equipped with a twin of your own ship and
intimate knowledge of your tactics.
.P
The lovely Stratocaster R&R facility never sounded so good, but as you
fire full thrusters to dodge the latest barrage you begin to think you'll
never get home...
.SH OPTIONS
.TP
\fB\-fullscreen\fR
Run Maelstrom in full\-screen mode. You may also press Alt\-Enter
while Maelstrom is running, to toggle full\-screen.
.TP
\fB\-windowed\fR
Run Maelstrom in windowed mode. Alt\-Enter toggles.
.TP
\fB\-gamma\fR [0\-8]
Set the gamma correction
.TP
\fB\-volume\fR [0\-8]
Set the sound volume
.TP
\fB\-netscores\fR
Use the world\-wide network score server
.TP
\fB\-player\fR N[@host][:port]
Designate player N (at host and/or port). N must be an integer, 1 to 3.
.TP
\fB\-server\fR N@host[:port]
Play with N players using server at host. N must be an integer, 1 to 3.
.TP
\fB\-deathmatch\fR [N]
Play deathmatch to N frags (default = 8)
.SH CONTROLS
The game may be played with either the keyboard or a joystick.
The game controls may be remapped by pressing C at the main menu. The
default keyboard controls are:
.TP
\fBTab\fR, \fBJoystick Button 1\fR
Fire
.TP
\fBUp Arrow\fR, \fBJoystick Up\fR
Thrust
.TP
\fBSpace\fR, \fBJoystick Button 2\fR
Shield
.TP
\fBRight Arrow\fR, \fBJoystick Right\fR
Turn Clockwise
.TP
\fBLeft Arrow\fR, \fBJoystick Left\fR
Turn Counter\-clockwise
.TP
\fBP\fR
Pause
.TP
\fBEscape\fR
Abort Game
.TP
\fBAlt\-Enter\fR
Toggle between fullscreen and windowed modes. This keystroke
may not be remapped.
.P
No special configuration must be done to play with a joystick, provided
the joystick is supported by the SDL library on your OS.
There is no way
to remap the joystick controls.
.SH NETWORKING
.SS Netplay Without a Server
Networking has been tested on Linux, SGI and DEC.  It is known to
work between SGI and DEC systems (cross\-platform), and between systems
of the same type.
.P
Up to three players can play, and the syntax is as follows:
.P
(On machine 1)
.br
.B
.nh
Maelstrom \-player 1 \-player 2@machine2 \-player 3@machine3
.hy
.P
(On machine 2)
.br
.B
.nh
Maelstrom \-player 1@machine1 \-player 2 \-player 3@machine3
.hy
.P
(On machine 3)
.br
.B
.nh
Maelstrom \-player 1@machine1 \-player 2@machine2 \-player 3
.hy
.SS Netplay With a Server
You can also use a network address server that handles the difficulties
of getting all the players and addresses right.  The address server is
installed as \fBMaelstrom\-netd\fR, and if run on say "servhost", the syntax
for a three player game would be:
.P
(On machine A)
.br
.B
.nh
Maelstrom \-player 1 \-server 3@servhost
.hy
.P
(On machine B)
.br
.B
.nh
Maelstrom \-player 2 \-server 3@servhost
.hy
.P
(On machine C)
.br
.B
.nh
Maelstrom \-player 3 \-server 3@servhost
.hy
.P
The address server will let players know if they have conflicting
player numbers, and will set up the proper addresses for all players.
It can field multiple games, and can be a "game hub" where a bunch
of players can get together for romping network games. :)
.P
.SS Network Ports
By default, Maelstrom uses UDP ports 44718 to 44720 for networked games,
where the port number is the player number plus 44717.
(these may be overridden with the \fI:port\fR syntax, above).
.P
\fBMaelstrom-netd\fR listens on TCP port 44717.
.P
The global
high\-score server listens on the host \fBdevolution.com\fR, TCP port 4444.
.SH ADD\-ONS
Maelstrom add\-ons consist of replacement sounds, replacement sprites,
or both. Typically, the add\-on content is distributed as a zip file.
.P
There is a collection of Maelstrom add\-on content at
.br
.nh
\fIhttps://www.libsdl.org/projects/Maelstrom/add\-ons.html\fR
.hy
.SS Automated Installation (Preferred)
Use \fBmaelstrom_addon_package.pl\fR to convert the zip
file to a Slackware package, then use \fBinstallpkg\fR to install the
add\-on. Run \fBmaelstrom_addon_package.pl \-\-help\fR for more information.
.SS Manual Installation
Look within the zip file for files named
\fI%Maelstrom_Sprites\fR and/or \fI%Maelstrom_Sounds\fR or similar
(the % may be missing, the _ may be a space, and/or the filenames
may end with .bin). Copy these files to
.P
.nh
\fB/usr/share/games/Maelstrom/%Maelstrom_Sprites\fR
.br
and/or
.br
\fB/usr/share/games/Maelstrom/%Maelstrom_Sounds\fR
.hy
.P
\fBNOTE\fR: \fIThe % is important!\fR
.SS Add\-On Limitations
There is no way to install more than one add\-on at a time, or to disable
the installed add\-on without uninstalling it. There is also no way to
install add\-ons in a user's home directory, or any other place than
the system\-wide game data directory.
.SH FILES
.TP
\fB/usr/share/games/Maelstrom/\fR
game data (images, music, sound)
.TP
\fB$HOME/.local/share/Ambrosia Software/Maelstrom\fR
per\-user settings and high\-score records
.SH AUTHORS
The original version of this game was written for the Macintosh by
Andrew Welch, of Ambrosia Software.  It was ported to Linux and then
to the Simple DirectMedia Layer library by Sam Lantinga.
.P
Man page created by B. Watson for SlackBuilds.org project (but others
are free to use it)
.SH COPYRIGHT
The source code to Maelstrom 3.0 and higher has been released under
the GNU General Public License which can be found in COPYING.GPL.
.P
The artwork and sounds used by Maelstrom are copyright Ambrosia Software
(http://www.ambrosiasw.com) and may not be redistributed separately from
the Maelstrom GPL source code.