SOKOBAN GP2X (dingux version) 24/02/2010
----------------------------------------

What is it
----------
Sokoban GP2X is a remake of the classic sokoban game.
You as the player need to push boxes to specific locations
in the level. Once all boxes are pushed to the correct spots
the level is finished.

Sokoban GP2X is basically a sokoban engine, it contains all the
game rules and has the ability to use level packs. It's possible
to create the level packs directly on the GP2X using the built in
Level editor. Each level pack can also have customized graphics and
menu colors. The game engine also has an undo system up to 1000 moves,
and have custom 25 mod or ogg music files loaded up.

What's new from the previous version
------------------------------------
Nothing, just dingux specific changes to make it work.

How to play
-----------
A				: Menu Selections, Undo Move(s), place a part in the level editor
B				: Show statistics during a game. Hide the part position in the level editor
Y 				: In Level editor Mode, Create a new level when being in the level
				  selector. In the level editor itself erase all parts from the screen.
				  Inside the game itself restart the level
X				: In the level editor, center the level on screen
JOYSTICK 		: move main player.
SELECT			: Quit to title screen on the level selector, Quit to level selector in game
				  and level editor mode. Quit the game on the titlescreen.
L				: At the level Selector decrease selected level with 5, During game play select
				  previous music. In the level editor select previous part
R				: At the level Selector increase selected level with 5, During game play select
				  next music. In the level editor select next part.
START			: Test level when being in the level editor, go back to level editor after testing


If you are new to sokoban i suggest that you play the "pimpernel" or "shove it" level pack
since these are not so hard to solve. (you can change level packs by pushing the right direction
when being on the levelpack name io the name between the less than < and greater than > signs)

Sokoban GP2X Will start up at a main menu, here you can choose the level pack you wish to edit
or play. by using left an right when the level pack name is selected (it's between "<>" signs).
When a level pack is loaded either for game play or level editing, the level selector will show up.
Here you select what level you wish to edit or play, if it's been unlocked yet.
After you solved a level one extra level will be unlocked. you always have to solve to last unlocked
level in order to unlock the next one.

Sokoban GP2X Can play up to 25 music files you choose yourself. you just have to copy either a .mod or
.ogg file to the music directory and the game will use the music in the game. You can also delete or replace
the original music files except for title.mod this file is needed for the game.

Level Packs
-----------
If you wish to create levels yourself ,load up the level editor and create a new level pack. you choose
a name by using up down left right and confirm the name by using A. There is a space sign included decrease
the selected sign to go to it.

Once a new level pack has been created you can then load it, and you will be in the level selector. just
press Y and start creating your own levels. The level editor will know when a level has been changed, so it will
ask you, if you want to save whenever you quit back to the level selector (using select). The level editor will
also automatically choose a filename for the levels, you don't need to worry about this.

You can change the graphics used in your level pack by copying the files from the graphics folder to your level pack
folder in the levelpacks directory, and edit them to your liking. It's not necesary to copy over all graphics, if you
just wish to change the title screen, then make sure there only exists a titlescreen.png graphics file in your level pack directory.
Have a look at the included pimpernel, shove it and gameboy boxxle level pack folder if you don't know what i mean.

You can also customize the main menu colors by editing the colors.txt file using an editor that's capable of showing
linux text files. If you don't have this just use notepad but only edit the numbers. The numbers are saved in RGBA format
Red, Green, Blue values and the A is for alpha which is a value between 0 and 255, 0 will hide the menu completely whereas
255 will show it without transparency. test it out with a value of for example 100 to see the effects.

once your level pack is finished you can just zip your level pack directory and release it to the public. They will then
have to unzip your level pack in the levelpacks directory and it will be shown inside the game. It's as simple as that !


Notes: 
------			
Deleting a low number level (for example 5) in a big level pack (say 100 levels) will take some time
because all other levels have to be renamed and there's no way to speed this up just be patient. 


Credits
-------
Sokoban GP2X Is created by 
Willems Davy Aka Joyrider
Willems Soft 2006-2010

Music is taken from http://www.mirsoft.info/gmb 
Music Composers: Barry Leitch, David Whittaker, Brian Johnston, Raymond Usher.

SokHard and SokEvo Levels are created by Lee Haywood. http://fruise.googlepages.com/sokoban.html

Gameboy Boxxle Levels are taken from GP-YASC DR4 Created by Tommy Widenflycht

Microcosmos, Minicosmos, Nabokosmos, Picokosmos, Polycosmos Levels are created by Aymeric du Peloux
http://membres.lycos.fr/nabokos/  

Lomas Levels are created by different Authors here's the list :
Aymeric du Peloux, François Marques, David Skinner, Sven Egevad, Victor Kindermans
Michael Steins, Frantisek Pokorny, Arpad Fekete, Roger Delaporte 
More info about the Lomas Level pack can be found on Aymeric du Peloux's site :
http://membres.lycos.fr/nabokos/loma.html

Pimpernel levels are taken from http://www.pimpernel.com/sokoban/game.html

shove it level pack is created by Whiskthecat - whiskthecat@gmail.com

Sever Sokoban Levels are created by Erim Sever from turkey
http://www.geocities.com/erimsever/sokoban.htm

History
-------
*Sokoban GP2X 1.2*
  Removed the gp2xmenu restarting code and replaced it with a script to start the menu
  to make the game compatible with customn menu's and launchers like gmenu2x. You will 
  need to add the game manually to the customn menu's using the sokoban executable 
  and not sokoban.gpe. The last one is the script that will relaunch the official menu,
  the first one, is the main game executable which doesn't start any menu it just ends normally.
  Don't forget to turn on the wrapper in gmenu2x to let it restart the menu.
  For people using the normal menu nothing has changed, you can still run the game as normal.
  I also included an icon.

*Sokoban Gp2x 1.1*
- Changed the detection when a level is finished (part of the bug below)
- Changed the level editors rules so that u can't put less blocks than spots and that
  at least one empty spot has to be availible in order to play / save the level. U can
  have more blocks then spots now, this could generate some new style of puzzles.
- Added 183 new levels in the "Sever Sokoban" level pack with the levels from Erim Sever From Turkey
- Fixed the volume reseting bug that happend when a mod music restarted.

*Sokoban Gp2x 1.0*
- Fixed bug in the level unlocking mechanism, Current state wasn't correctly loaded
- Added Center level feature in the level editor
- Added microcosmos, minicosmos, nabokosmos, picokosmos, polycosmos, lomas, gameboy boxxle (1+2),
  sokevo and sokhard level packs ... 680 new levels !
- Changed level finding function, finds the total amount of levels much faster now
- Added volume controls and volume setting saving
*Initial preview release*

Questions & Support
-------------------
Http://www.willemssoft.be
Http://development.willemssoft.be
info@willemssoft.be
paypal: joyrider3774@hotmail.com
