SoQLoban.


This is a Sokoban clone.

The purpose  of the game is to move  boxes around the screen so as
to put all boxes on target spots, one box per target spot.

Right-click or hit ENTER when the mouse pointer is over the window
with the puzzle, to play the puzzle. You are then in play mode and
there is no mouse pointer, just the game cursor, which is moved by
the cursor keys. Hit ESC to get the normal mouse pointer back.

On the screen you can see:

The target spots - they are the red triangles.
The boxes - they are the white and black squares.
Your  cursor -   this is  the red  cross. You  move it  around the
screen with the cursor keys.
The playing area - filled with green tiles.
The walls : ther are grey tiles.

You  move the boxes  by pushing them  around. This can  be only be
done by moving the cursor next to a box and then moving "into" the
box. This will push the box one tile towards that direction. Tiles
can only  be pushed  onto free  spaces of  the playing  area, i.e.
green tiles,  or onto target spots. You  cannot push more than one
box at a time. You cannot pull a box. You cannot push a box onto a
space already occupied by a box.

Your cursor  cannot move over a  box, it has to  go around it. The
cursor  can move left/right/up/down but not diagonally. I can move
onto an unoccupied target spot.

The  walls are the limts  of the playing area  and you cannot move
into/beyond them.

The first  level is VERY  easy and just  there to get  used to the
game controls.

The games comes with nine puzzles built in.

I  have packaged a few extra levels  files in the zip file, whiich
you can  import into the program. These  are the files ending with
"_slc". Please  note that  I am  NOT the  author of  these levels,
their authors  are mentioned  in the  files themselves.  The level
files  are simple text files, you can have a look at them with any
text   editor.   You   can   get   more   of   these   levels   at
https://sokoban-game.com/packs

Importing these files isn't perfect. The window size is relatively
small (so that it can be used on a normal QL) which means that the
maximum size of  puzzles is 13 x  30 (H x W).  If a puzzle doesn't
fit in one dimension the program tries to rotate it to see whether
it would fit  then (i.e.  a puzzle  that's too  high might  fit if
rotated 90 degrees). The program  only  shows  hose  puzzles  that
would actually fit in the screen at the time the file is imported.
It is ths  possible that  the same  file, imported  with different
screen sizes, will yield a different number of playable levels.

You import these  files into  the game  via the  F3 -  import file
menu.


The F3 menu  can be  reached during  game play  and also  when the
mouse pointer is visible. It allows you to 

* Quit the game
* Go to a new level
* Retry the same level
* Undo the last move WHERE YOU PUSHED A BOX (you can undo this one
move only!!!).
* Import an slc file.


The  game shows you what  level you're on and  the number of moves
you  made. The "number of moves" is  the number of moves where you
actually pushed a  box, not the  number of moves  when just moving
the cursor around.

And last but  not least,  you can  configure the  usual colourways
with the usual Menuconfig program.


Have fun

Wolfgang

Credits:

The sprites used in j=highet colour modes are taken from:
https://github.com/borgar/sokoban-skins. They  are  copyright  (c)
Borgar  Porsteinsson were modified by me  to makes them into SMSQE
sprites and are distributed here  under  the  CC  Commans  licence
included in the package.
