Make sure codec directory exists before creating link file.
[kugel-rb.git] / manual / plugins / sokoban.tex
blobf6874a80f35435f555091686c83aadc0579165af
1 \subsection{Sokoban}
2 \screenshot{plugins/images/ss-sokoban}{Sokoban}{fig:sokoban}
4 The object of the game is to push boxes into their correct position in a
5 crowded warehouse with a minimal number of pushes and moves. The boxes
6 can only be pushed, never pulled, and only one can be pushed at a time.
8 Sokoban may be used as a viewer for viewing saved solutions and playing
9 external level sets with the \fname{.sok} extension. Level sets should be in
10 the standard Sokoban text format or RLE (Run Length Encoded). For more
11 information about the level format, see
12 \url{http://sokobano.de/wiki/index.php?title=Level_format}
14 \begin{table}
15 \begin{btnmap}{}{}
16 \multicolumn{2}{c}{\textbf{In game}} \\
17 \hline
18 \opt{RECORDER_PAD,ARCHOS_AV300_PAD,ONDIO_PAD,IRIVER_H100_PAD,IRIVER_H300_PAD,IAUDIO_X5_PAD,GIGABEAT_PAD,MROBE100_PAD,SANSA_E200_PAD,SANSA_C200_PAD}
19 {\ButtonUp, \ButtonDown, }%
20 \opt{IPOD_4G_PAD,IPOD_3G_PAD}{\ButtonMenu, \ButtonPlay, }%
21 \opt{IRIVER_H10_PAD}{\ButtonScrollUp, \ButtonScrollDown, }%
22 \ButtonLeft, \ButtonRight
23 & Move the ``sokoban'' up, down, left, or right\\
24 \opt{RECORDER_PAD,ARCHOS_AV300_PAD,ONDIO_PAD,IRIVER_H100_PAD,IRIVER_H300_PAD}{\ButtonOff}
25 \opt{IPOD_4G_PAD,IPOD_3G_PAD}{\ButtonSelect+\ButtonMenu}
26 \opt{IAUDIO_X5_PAD,IRIVER_H10_PAD,GIGABEAT_PAD,MROBE100_PAD,SANSA_E200_PAD,SANSA_C200_PAD}{\ButtonPower}
27 & Menu \\
28 \nopt{IAUDIO_X5_PAD}{
29 \opt{RECORDER_PAD,ARCHOS_AV300_PAD}{\ButtonFOne}
30 \opt{ONDIO_PAD}{\ButtonMenu+\ButtonLeft}
31 \opt{IRIVER_H100_PAD,IRIVER_H300_PAD}{\ButtonOn+\ButtonDown}
32 \opt{IPOD_4G_PAD,IPOD_3G_PAD}{\ButtonSelect+\ButtonLeft}
33 \opt{IRIVER_H10_PAD}{\ButtonPlay+\ButtonScrollDown}
34 \opt{GIGABEAT_PAD,SANSA_C200_PAD}{\ButtonVolDown}
35 \opt{MROBE10_PAD}{\ButtonDisplay}
36 \opt{SANSA_E200_PAD}{\ButtonSelect+\ButtonDown}
37 & Back to previous level \\
39 \nopt{IPOD_4G_PAD,IPOD_3G_PAD}{
40 \opt{RECORDER_PAD,ARCHOS_AV300_PAD}{\ButtonFTwo}
41 \opt{ONDIO_PAD}{\ButtonMenu+\ButtonUp}
42 \opt{IRIVER_H100_PAD,IRIVER_H300_PAD}{\ButtonOn}
43 \opt{IAUDIO_X5_PAD}{\ButtonRec}
44 \opt{IRIVER_H10_PAD}{\ButtonPlay+\ButtonRight}
45 \opt{GIGABEAT_PAD,MROBE100_PAD}{\ButtonMenu}
46 \opt{SANSA_E200_PAD,SANSA_C200_PAD}{\ButtonSelect+\ButtonRight}
47 & Restart level \\
49 \nopt{IAUDIO_X5_PAD}{
50 \opt{RECORDER_PAD,ARCHOS_AV300_PAD}{\ButtonFThree}
51 \opt{ONDIO_PAD}{\ButtonMenu+\ButtonRight}
52 \opt{IRIVER_H100_PAD,IRIVER_H300_PAD}{\ButtonOn+\ButtonUp}
53 \opt{IPOD_4G_PAD,IPOD_3G_PAD}{\ButtonSelect+\ButtonRight}
54 \opt{IRIVER_H10_PAD}{\ButtonPlay+\ButtonScrollUp}
55 \opt{GIGABEAT_PAD,SANSA_C200_PAD}{\ButtonVolUp}
56 \opt{MROBE100_PAD}{\ButtonPlay}
57 \opt{SANSA_E200_PAD}{\ButtonSelect+\ButtonUp}
58 & Go to next level \\
60 \opt{RECORDER_PAD,ARCHOS_AV300_PAD}{\ButtonOn}
61 \opt{ONDIO_PAD}{\ButtonMenu}
62 \opt{IRIVER_H100_PAD,IRIVER_H300_PAD}{\ButtonRec}
63 \opt{IPOD_4G_PAD,IPOD_3G_PAD,IAUDIO_X5_PAD,GIGABEAT_PAD,MROBE100_PAD,SANSA_E200_PAD,SANSA_C200_PAD}{\ButtonSelect}
64 \opt{IRIVER_H10_PAD}{\ButtonRew}
65 & Undo last movement \\
66 \opt{RECORDER_PAD,ARCHOS_AV300_PAD,IAUDIO_X5_PAD}{\ButtonPlay}
67 \opt{ONDIO_PAD}{\ButtonMenu+\ButtonDown}
68 \opt{IRIVER_H100_PAD,IRIVER_H300_PAD}{\ButtonMode}
69 \opt{IPOD_4G_PAD,IPOD_3G_PAD}{\ButtonSelect+\ButtonPlay}
70 \opt{IRIVER_H10_PAD}{\ButtonFF}
71 \opt{GIGABEAT_PAD}{\ButtonA}
72 \opt{MROBE100_PAD}{\ButtonDisplay}
73 \opt{SANSA_E200_PAD,SANSA_C200_PAD}{\ButtonRec}
74 & Redo previously undone move \\
75 \hline
76 \multicolumn{2}{c}{\textbf{Solution playback}} \\
77 \hline
78 \opt{RECORDER_PAD,ARCHOS_AV300_PAD,IAUDIO_X5_PAD,IRIVER_H10_PAD}{\ButtonPlay}
79 \opt{ONDIO_PAD}{\ButtonMenu}
80 \opt{IRIVER_H100_PAD,IRIVER_H300_PAD}{\ButtonOn}
81 \opt{IPOD_4G_PAD,IPOD_3G_PAD,GIGABEAT_PAD,MROBE100_PAD,SANSA_E200_PAD,SANSA_C200_PAD}{\ButtonSelect}
82 & Pause/resume \\
83 \opt{RECORDER_PAD,ARCHOS_AV300_PAD,ONDIO_PAD,IRIVER_H100_PAD,IRIVER_H300_PAD,IAUDIO_X5_PAD,GIGABEAT_PAD,MROBE100_PAD,SANSA_E200_PAD,SANSA_C200_PAD}
84 {\ButtonUp/\ButtonDown}
85 \opt{IPOD_4G_PAD,IPOD_3G_PAD}{\ButtonMenu/\ButtonPlay}
86 \opt{IRIVER_H10_PAD}{\ButtonScrollUp/\ButtonScrollDown}
87 & Increase/decrease playback speed \\
88 \ButtonLeft/\ButtonRight
89 & Go backward/forward (while paused) \\
90 \opt{RECORDER_PAD,ARCHOS_AV300_PAD,ONDIO_PAD,IRIVER_H100_PAD,IRIVER_H300_PAD}{\ButtonOff}
91 \opt{IPOD_4G_PAD,IPOD_3G_PAD}{\ButtonSelect+\ButtonMenu}
92 \opt{IAUDIO_X5_PAD,IRIVER_H10_PAD,GIGABEAT_PAD,MROBE100_PAD,SANSA_E200_PAD,SANSA_C200_PAD}{\ButtonPower}
93 & Quit \\
94 \end{btnmap}
95 \end{table}
97 Some places where can you can find level sets:
98 \begin{itemize}
99 \item \url{http://www.sourcecode.se/sokoban/levels.php}
100 \item \url{http://sokobano.de/en/levels.php}
101 \end{itemize}
102 Note that some level sets may contain levels that are too large for this
103 version of Sokoban and are unplayable as a result.