]> git.lizzy.rs Git - plan9front.git/blob - sys/man/1/games
games(1), nintendo(1): re-organize nintendo emulators into separate man page; add...
[plan9front.git] / sys / man / 1 / games
1 .TH GAMES 1
2 .SH NAME
3 4s, 5s, blabs, catclock, doom, festoon, geigerstats, glendy, juggle, life, mandel, mahjongg, memo, midi, mines, mole, packet, sokoban, sudoku \- time wasters
4 .SH SYNOPSIS
5 .B games/4s
6 .br
7 .B games/5s
8 .br
9 .B games/blabs
10 [
11 .B -i
12 ] [
13 .B -k
14 .I k-floor
15 ] [
16 .B -n
17 .I track-length
18 ] [
19 .B -w
20 .I track-width
21 ] [
22 .B -x
23 .I gravity-x
24 ] [
25 .B -y
26 .I gravity-y
27 ]
28 .br
29 .B games/catclock
30 .br
31 .B games/doom
32 .br
33 .B games/festoon
34 [
35 .B -pet
36 ] [
37 .I sentences
38 [
39 .I percent-invented-nouns
40 ] ]
41 .br
42 .B games/geigerstats
43 .br
44 .B games/glendy
45 .br
46 .B games/juggle
47 [
48 .B -d
49 .I delay
50 ] [
51 .B -h
52 .I hands
53 ] [
54 .I start
55 ]
56 .I pattern
57 .br
58 .B games/life
59 .I startfile
60 .br
61 .B games/mandel
62 .br
63 .B games/mahjongg
64 [
65 .B -c
66 ] [
67 .B -f
68 ] [
69 .B -b
70 .I background
71 ] [
72 .B -t 
73 .I tileset
74 ] [
75 .B -l
76 .I layout
77 ]
78 .br
79 .B games/memo
80 [
81 .B -h
82 ]
83 .br
84 .B games/midi
85 .I midifile
86 .br
87 .B games/mines
88 .br
89 .B games/mole
90 .br
91 .B games/packet
92 [
93 .B -n
94 .I nnode
95 ] [
96 .B -o
97 .I speed-offset
98 ] [
99 .B -d
100 .I decay
101 ] [
102 .B -b
103 .I speed-bonus
104 ] [
105 .B -r
106 .I regen-rate
107 ] [
108 .B -t
109 .I thick-factor
110 ] [
111 .B -T
112 .I display-threshold
113 ]
114 .br
115 .B games/sokoban
116 [
117 .I level
118 ]
119 .br
120 .B games/sudoku
121 .SH DESCRIPTION
122 There are a few games in
123 .BR /bin/games :
124 .TF mahjongg
125 .PD
126 .TP
127 .BR 4s , " 5s"
128 Try to fill complete rows using 4-square or 5-square tiles.
129 Move tiles left or right by moving the mouse.
130 Rotate tiles with buttons 1 and 3.
131 Drop tiles for more points with button 2 or the space bar.
132 Keys
133 .LR a
134 and 
135 .LR j
136 move left,
137 .LR s
138 and 
139 .LR k
140 rotate left,
141 .LR d
142 and 
143 .LR l
144 rotate right,
145 .LR f
146 and 
147 .LR ;
148 move right.
149 .LR z ,
150 .LR p
151 and
152 .LR Esc
153 toggle suspend/resume.
154 .LR q ,
155 .LR Del
156 and
157 .LR control-D
158 quit.
159 .TP
160 .B doom
161 This is a port of id Software's DOOM I and II engine.
162 In DOOM, players assume the role of a space marine, who became
163 popularly known as "Doomguy", fighting their way through hordes
164 of invading demons from Hell. Game data (WAD-files) for
165 .B doom
166 are not part of the distribution, but free WAD-files,
167 like the shareware version, can be obtained on the net.
168 .TP
169 .B festoon
170 Generate an official-looking but utterly nonsensical bureaucratic report as
171 .L "pic | eqn | tbl | troff -mm"
172 input.
173 Options
174 .BR -p ,
175 .B -e
176 and
177 .B -t
178 add gibberish diagrams, equations and tables.
179 .TP
180 .B glendy
181 Don't let the rabbit escape.
182 .TP
183 .B juggle
184 Display the juggling
185 .I pattern
186 using the optional initial
187 .I start
188 pattern.
189 The number of hands involved (default 2) can be specified with
190 .BR -h ,
191 and
192 .I delay
193 can be used to speed up or slow down the action (default is 20).
194 Try the pattern 333333441333333 or 333353505151512333333
195 or YWUSQOMKIGECA
196 (see
197 .BR http://seehuhn.de/jong/theory.html ).
198 .TP
199 .B life
200 Play the game of Life, given an initial position.
201 There is a library of interesting initial positions;
202 the library is consulted if
203 .I startfile
204 cannot be found.
205 .TP
206 .B mahjongg
207 Remove all tiles
208 from the board. Click on tiles with the same face that
209 are not blocked by others. A blocked tile is one that is partially or
210 fully covered on top or has neighbouring tiles to the left and right.
211 The game finishes when either all tiles are gone or there are no
212 more moves left. The arguments are for changing background
213 .RB (-b),
214 tile
215 .RB (-t)
216 and layout
217 .RB (-l)
218 images;
219 .RB -c
220 selects a true-color buffer image, for use with
221 drawterm or in case selecting a tile obscures it completely;
222 .RB -f
223 causes mahjongg to indicate non-blocked tiles on mouse-over.
224 The 
225 .LR N
226 key will generate a new level, 
227 .LR R
228 restarts the current one. 
229 .LR Q
230 and 
231 .LR Del
232 quit, 
233 .LR H
234 gives a hint, either trying to match the currently selected tile, or if no tile is
235 selected finding out the first available tile.
236 .LR U
237 and
238 .LR Bksp
239 undo the last move,
240 .LR C
241 tries to solve the level.
242 .TP
243 .B memo
244 Remove all tiles from the board.
245 At first, pictures of various Bell Labs employees, Lucent Technologies' logo, and Glenda will appear.
246 Memorize the sequence, then click to hide them and begin.
247 Use the mouse to select two tiles.
248 If they are the same, the tiles will disappear, otherwise the tiles will flip back and you will get a chance to try again.
249 Button 3 generates a memu allowing you to restart, switch between easy and hard modes, and exit.
250 The
251 .B -h
252 option sets the game to hard mode.
253 Once the game has been completed, a message pops up with how long it took to win.
254 Use the button 3 menu to choose a mode, or click to play again.
255 .TP
256 .B sokoban
257 Guide Glenda through a room full of walls, pebbles and holes to put
258 the pebbles in.  Your goal is to arrange all pebbles into holes by
259 pushing them around, but you can only push a pebble if there is no
260 wall or another pebble blocking the way.
261 Arrow keys move Glenda up-down-left-right.  
262 .LR N 
263 and 
264 .LR P 
265 keys switch between
266 the next and previous levels, 
267 .LR R
268 restarts the current level.  
269 .LR Del 
270 and
271 .LR Q
272 quit.  Button 3 invokes a menu to restart the current level, load different level sets, and en- and disable animation of multi-step moves.
273 Button 2 lets you change between levels. 
274 Button 1 lets you do multi-step moves and pushes,
275 by clicking it on the destination where you want Glenda to go.
276 Glenda will only move if it can reach the destination.
277 For a multi-step push the pebble must be next to Glenda,
278 the destination must be on the same row or column,
279 and there must be a free place next to the destination
280 where the pebble can be pushed to.
281 Otherwise, if possible, Glenda will walk to the destination without pushing the pebble.
282 .I Sokoban
283 accepts a level file as its argument.
284 .TP
285 .B sudoku
286 .I Sudoku
287 is a puzzle game from Japan.  The goal of the game is to
288 fill the numbers 1 to 9 in all squares of the 9x9 board following a
289 few simple rules: no digit should repeat on the same row and column,
290 and no digit should repeat in the same 3x3 boxes outlined with thicker
291 lines.  The board is initially filled with a partial solution which
292 can be used for inferring digits for the empty squares.  The top row
293 of the board contains the digits 1 through 9, clicking on one of those
294 digits selects that number for placement on the board, clicking it
295 again will deselect that digit.  Clicking on an empty square will then
296 affix the square with the selected digit or, if no digit is selected
297 empty the square.
298 .IP
299 Button 3 presents a menu with the following options:
300 .RS \w'\fLfireworksXX'u
301 .TP \w'\fLOffsetXX'u
302 .B New
303 autogenerate a new, random board
304 .TP
305 .B Check
306 mark in red any digits not placed according to the rules
307 .TP
308 .B Solve
309 present the board's solution
310 .TP
311 .B Clear
312 clear the board to its starting (or last loaded) state
313 .TP
314 .B Save
315 save the current board to
316 .B /tmp/sudoku-save
317 .TP
318 .B Load
319 load the last saved board from
320 .B /tmp/sudoku-save
321 .TP
322 .B Print
323 print the current board and solution in a format
324 suitable for addition in the
325 .I sudoku
326 library to
327 .B /tmp/sudoku-board
328 .TP
329 .B Offline
330 pretty-print the board for off-line solving to
331 .B /tmp/sudoku-print
332 .TP
333 .B Exit
334 quit the game
335 .RE
336 .IP
337 Button 2 presents a list of
338 .I sudoku
339 boards of varying degrees of difficulty from
340 .BR /sys/games/lib/sudoku/boards .
341 .IP
342 Pressing the
343 .B Q
344 key quits
345 .IR sudoku .
346 .SH FILES
347 .TF /sys/games/lib/mahjongg/*
348 .TP
349 .B /sys/games/lib/[45]scores
350 score files of
351 .I 4s
352 and
353 .I 5s
354 .TP
355 .B /sys/games/lib/life/*
356 interesting starting positions
357 .TP
358 .B /sys/games/lib/mahjongg/*
359 image sprites, levels and backgrounds used by
360 .I mahjongg
361 .TP
362 .B /lib/face/*
363 tiles for
364 .I memo
365 .TP
366 .B /sys/games/lib/sokoban/*
367 image sprites and levels used by
368 .I sokoban
369 .TP
370 .B /sys/games/lib/sudoku/*
371 images and boards used by
372 .I sudoku
373 .TP
374 .B $home/lib/doom/*
375 .TP
376 .B /sys/lib/doom/*
377 .TP
378 .B /sys/games/lib/doom/*
379 doom WAD-files.
380 .SH SOURCE
381 .B /sys/src/games
382 .SH BUGS
383 In
384 .I 4s
385 and
386 .IR 5s ,
387 mouse warping (when the game is resumed,
388 and when a new tile appears) does not happen when
389 the mouse cursor is outside the game window.
390 Those who prefer to use the keyboard without the mouse
391 cursor blocking the view (or being warped all the time)
392 may consider this a feature.
393 .SH HISTORY
394 .I Doom
395 first appeared in 9front (May, 2011).
396 .br
397 .I Packet
398 first appeared in 9front (August, 2011).