
   _________                 ___                       ___
  /         \               |   |                     |   |
 /    ___    \              |   |                     |   |
 |   /   \    \             |   |                     |   |
 |   |   |____|             |   |                     |   |         
 |   |                      |   |    /\               |   |         
 |   \______                |   |   /  \              |   |         
 \          \    ________   |   |  /    |  ________   |   |______         __         ____  _____
  \______    \  /        \  |    \/    /  /        \  |          \       /  \       |    |/     \ 
         \   | /    __    \ |         /  /    __    \ |    ___    |     /    \      |            \
  ___    |   | |   |  |   | |   \    /   |   |  |   | |   |   |   |    /  /\  \     |     ____    |
 |   |   |   | |   |  |   | |   |\   \   |   |  |   | |   |   |   |   /   --   \    |    /    \   |
 \   \__/    / |   |__|   | |   | \   \  |   |__|   | |   |___|   |  /   ____   \   |    |    |   |
  \         /  \          / |   |  \   \ \          / |           / /   /    \   \  |    |    |   |
   \_______/    \________/  |___|   \___\ \________/  \__________/ /___/      \___\ |____|    |___|
					    			A  R  M  A  G  E  D  D  O  N
                                                                                          verze 1.1
						
                                                                           created by Forever games
                                                                             www.fgames.gamecode.cz   
===================================================================================================
=== = ==== === = === === = === === = === === = === === = === === = === === = === === = === === = ==
==== ==== = === === = === === = === === = === === = === === = === === = === === = === === = === ===
=== = ==== === = === === = === === = === === = === === = === === = === === = === === = === === = ==
===================================================================================================


	==========================================================================
	!!! FOR ENGLISH LANGUAGE IN GAME RUN SETUP.EXE AND SELECT LOCALIZATION !!!
	==========================================================================
	
 
Japanese logical game that you surely know. Objective of game is bouncing every box marked fields.
However you can push only one box and only forward. It means that you shall never more move with
case in corner and you shall not move it from wall as well. On the first look easy game, that
everybody understand in ten minutes, is in fact really hellishly hard puzzle.


1) Basic information about game
2) Something about history of game Sokoban
3) Author of single levels
4) How install game
5) System requirements
6) Game control
7) Is there any bug in the game ?
8) Betatesting
9) Types of sounds
10) Inserting of own music
11) Contact
12) History of versions

===================================================================================================
===================================================================================================

1) Basic information about game
===============================

As I already said before, rules of game are very simple and everybody can understand it in 10 minutes.
Game is consisted of single levels with maximal size 20x17 fields. Some fields are filed with walls,
some are empty. Floor some of them shines green, so are marked plug-in fields. Next in levels are 
placed equal number of boxes as plug-in place. If case is pushed on plug-in field, it lights up green.
And your objective is bouncing every case on plug-in fields. However storeman can push only one box at
a time and ever only ahead. Game is created with DirectX (concretely DirectDraw) and it works in
resolution 800x600. Game is including 250 levels divided into 5 campaigns with characteristic names
Easy, Medium, Hard, Time run and Don't move (levels with moving limits). Levels are drawing with
isometry. Game also contains complex level editor and extensive menu system contained almost 30 screens.
Part of the game is as well high-quality music accompaniment in format ogg vorbis. Graphic of game is
situated into old warehouse, whose walls are here and there rusted and some electronic controls doesn't
work. And in this surround must work warehouser, whose only work is reordering cases with radioactive
waste. The surround is supplemented by a lot of nice graphic components. In the right corner is rotating
rushed old ventilator, LED diodes signalizing direction of storeman's moving are blinking. One of them
doesn't work, only sparks are flying from hole. However these efects can of course disturb, therefore
it's possible to shut down them all whenever. 


2) Something about history of game Sokoban
==========================================

History of this game is very interesting. First version of this unusually complicated puzzle caome from
year 1982. It was created by Hiroyuki Imabayashi, that allegedly published first idea of game concept
already in year 1980. One storage company wrote competition for computer game for topic storing in the
city Takatazuka in Japan. And Sokoban won this competition. It manage to distance otherwise far more
favourite game genre as action or adventure for genious design, easy rules and 50 legendary and
altogether quite difficult levels. Just these 50 original levels manage to famous game all over the
world and you will of course find them in my remake as well. As I already said, alone idea of puzzle
discovered Hiroyuki Imabayashi already in year 1980 and he published it right in this competition.
Sokoban is freely translated as storeman or store engineer. But yet you rather know first version
published out of Japan by company Spectrum Holobyte in year 1984 (light blue floor and purple brick
walls). Sokoban is one of the most played games in history, whole group of its remake exists for maybe
each platform (from Windows to Linux, Windows CE and mobile phones with Java). There are thousands of
levels on the Internet, some of them are very difficult. On the contrary, other ones are for children,
they are markedly easier and they should help with expansion of logical meaning. I would like to speak
highly of work of some level designers here, that are creating huge databases in their free time
containing hunderts of difficult levels on very small area with often only a few cases, one another
upgrades them and they are trying to find shortest solution. By the way find the shortest solution
with using computer isn't easy at all, it is so-called NP-complex problem. That means, that it can
extend in case of huge level with tens of levels on a few milions of years :). However it's make
Sokoban more interesting, because it doesn't suffice to find right way only run program and wait a few
moments. And you can trust me, that some levels will consume you a lot of time. 

3) Authors of single levels
===========================

As I already said, game contains 250 levels from a few authors. I would like to thank them for permission
to use their levels through this. I must express admiration, how much time they gave to game and filing
their levels. And now a few information about single authors: 

Hiroyuki Imabayashi - legendary levels of genious author of Sokoban I couldn't simply cut out. Their
	difficulty is nice increasing and they are good, if you want to learn to play Sokoban. They will
	occur in campaign Medium. 

Frantiek Pokorn - this czech author has very nice small levels, that are however now and again very
	complicated. Therefore they will mainly be to determine for campaign Time run and Don't move! On
	his page www.kantorek.webzdarma.cz you shall find besides animated jokes of Paul Kantorek and a nice
	collecting of Murphy's Law, as well quite a lot of Sokoban levels. He collected levels from single
	authors and size of database exceed over 3500 items to date and it's nice, isn't is? 

Evgeny Grigoriev alias GRIGoRusha - levels of this creator Russian nationality belong to the most
	difficult things, what you can meet in game. Overwhelming majority of them will make campaign Hard.
	Otherwise here you can look on his very nice pages: www.grigr.narod.ru 

David W. Skinner - this American author created extensive series of particularly medium difficult levels.
	You shall find some of them (chiefly from group Microban - which mean very small levels) in campaign
	Easy. You can look through list of all levels here: http://users.bentonrea.com/~sasquatch/sokoban/ 

Aymeric du Peloux - Levels from this French designer are the most beatiful and also the most difficult in
	this game. They are really small and there aren't more than 8 boxes. His collections Minicosmos,
	Microcosmos, Nabokosmos and Picocosmos form, beside level of Frantiek Pokorn and a few of my
	pieces, campaignes Time run and Don't move! You can see his pages in French (importent thinks
	are as well in english) and play some levels online: http://membres.lycos.fr/nabokos/ 

In the end, I'd like to mention that you can find some levels that were creates by myself (Zlosynus).
They are quite difficult, I think.

4) How install game
===================

Sokoban doesn't need any install. Just unpack the files and execute the program. You cannot execute
the game from a CD or a disk, where you aren't authorized to write on. If this tzpe of tip-off
shows up after starting:

"Aplication could not run, because component XXXXXX.dll can't be found. You can probably remove
troubles with repeated instalation of aplication",

check at first, if it isn't one library from this list:

Common.dll
MFC71.dll
MFCO42D.DLL
msvcr71.dll
MSVCRTD.DLL
ogg.dll
OggCodec.dll
vorbis.dll
Zip.dll

If it is, you have archive with game injured or loose. Therefore download it from our web pages
www.fgames.gamecode.cz again. If it isn't, send us please its name on email fgames@gamecode.cz
and we will immediately send it you back.

5) System requirements
======================

Minimum : 300 MHz, 16 MB RAM, DirectX 8 or higher
Recommended : 500 MHz, 32 MB RAM, graphic card

6) Game control
===============

game:
->, v, <-, ^ (cursor arrows)       moving of Sokoban
P                                  pause / unpause game
R                                  restart a level
ESCAPE                             switch into game menu (in level testing end into editor)

menu:
ENTER                              select your choice
ESCAPE                             cancel your choice or go back to previous screen

editor:
ALT								   show tabel with hotkeys

You can find single hotkeys for all functions in description of function square brackets.

During working with wand you can add areas (if you're holding key SHIFT) or remove them (if you're
holding key ALT)

If you have any questions to editor or you don't understand some function well, just let
us know on fgames@gamecode.cz. If you will create some levels and you will want to publish
them, you can send us them and we will do it on our pages.

7) Is there any bug in the game ?
=================================

Although betatesting is in progress longer time, some error can always show up. Therefore
if game fall or doesn't work correctly, send us mail with information about error
(when it happend, your configuration), possibly try to discover, if this error is regular
or if it's only extra event.

If you didn't manage to run game at all, check, if you downloaded all files:

in directory with game:
Common.dll
MFC71.dll
MFCO42D.DLL
msvcr71.dll
MSVCRTD.DLL
ogg.dll
OggCodec.dll
setup.exe
sokoban.exe
vorbis.dll
Zip.dll

in directory source:
czech.txt
dontmove.llb
easy.llb
english.txt
hard.llb
medium.llb
timerun.llb

in directory source\graphic:
button.bmp
cursor.bmp
fglogo.bmp
gametype.bmp
checkbox.bmp
icons.bmp
imagebutton.bmp
infobox.bmp
lights.bmp
listbox.bmp
loading.bmp
menuhelp.bmp
menutitle.bmp
okraje.bmp
picturebutton.bmp
pozadi.bmp
preview.bmp
sblogo.bmp
sokoban.bmp
stats.bmp
table1.bmp
table2.bmp
table3.bmp
table4.bmp
table5.bmp
table6.bmp
teren.bmp
textbox.bmp
ventilator.bmp

in directory source\music:
beep.ogg
click.ogg
correct.ogg
credits.ogg
delete.ogg
error.ogg
failed.ogg
fgames.ogg
music.ogg
sblogo.ogg
sokoban.ogg
spark01.ogg
spark02.ogg
spark03.ogg
start.ogg
step1.ogg
step2.ogg
step3.ogg
up.ogg
win.ogg
write.ogg

in directory source\fonts:
CourierB.ddf
CourierG.ddf
CourierMenu.ddf
CourierS.ddf
VerdanaB.ddf
VerdanaS.ddf
VerdanaSM.ddf

If some of these files missing, download please from pages www.fgames.gamecode.cz packed file
with game again. If this will not help either, contact authors on mail fgames@gamecode.cz.
Anyway, if all files are there.

8) Betatesting
==============

Team Forever games is looking for other people for betatesting for this and future projects.
Do you have enough free time and would you like to participate on game creation, although
you are neither programmer nor graphic designer. So you can become our betatester. You will
be first, who catch sight on out games and your name will be state in credits. If you have
interest in betatesting, write us on adress fgames@gamecode.cz.

9) Types of sounds
==================

It's possible to load sounds two ways in Sokoban. Stream sound isn't going to load whole
into memory, it is progressively loaded by small parts from disk during playing. It's a bit
slower, however loading of game is quicker and it doesn't take big area in memory. Stream
sounds are used for music, possibly dialogs. Second option is decomprimate sound and save
them directly into memory. Loading of these sounds is markedly slower and one such file is
going to alocate sizeable memory, however their playing is a bit quicker and you can play
one moretimes at one jump.

You can set type of playing for each sound in file setup.exe. There is possibility to turn
off each sound. However this setting is only for advanced users.

10) Inserting of own music
==========================

It's possible to insert own music into game Sokoban: Armageddon. Create file with music in arbitrary
formt (MP3, OGG, WMA, ...), then copy this file into directory source/music with name music.ogg
(independent on file type). After next start will be in game your own music.

11) Contact
===========

URL: www.fgames.gamecode.cz
Email: fgames@gamecode.cz

Dal kontakty (ICQ, ...) naleznete na naich strnkch v sekci O tmu.

12) Historie verz
==================

CHANGES IN VERSION 1.1
----------------------

CHANGES:
	- Library for working with sound was changed. Commercial library FMOD (http://fmod.org) was used.
	- Loading was inserted into a thread, its drawing was changed.
	- Settings of the game were enlarged, it's now possible to stream single sounds, save them into memory
	  or don't load and use them at all. If you want to learn, what difference is between stream sounds
	  and sounds in memory, vide supra (part 9).

ERRORS:
	- Critical error, that cause falling of game, was removed! (I informed about it short time ago on pages)
	- Sound clicking in credits was removed.

CHANGES IN VERSION 1.0b
-----------------------

ERRORS:
	- Error, that cause no showing of previews and information about level, was removed.
	- Problem with tables of best players was solved. Came up to bad loading, that sequel
	  was jumble up single tables.

CHANGES IN VERSION 1.0
----------------------

There are huge flock of changes, these are at least some of them.

CHANGES:
	- English localization was added, system of game was complex changed.
	- Penetrative change of graphic came, isometry was added.
	- Some sounds were changed.
	- Logo of company Forever games a and logo of game Sokoban was changed.
	- Name of game was changed on Sokoban: Armageddon.
	- Some graphic elements supplementing game borders were added.
	- Game settings were changed.
	- External settings in file setup.exe was created.
	- Levels in game were reorganized into five campaigns, each consists of 50 levels.
	- Level editor was repaired and enlarged.
	- Game music was changed.
	- Credits in game were reprogrammed and enlarged.
	- Waiting animations and rotation of Sokoban were removed.
	- Moving of Sokoban was markedly accelerated.
	- There are last five sekund counted with clink in time-limited levels.
	
ERRORS:
	- Error with inaccessibility of buttons in level moving was repaired.
	- Grid in level editor didn't show (at all). This error was removed.
	- A few mistakes with inaccessibility of buttons in library editor and in level inserting
	  into library in level editor were removed.
	- Insidious error, that cause fall of game by repeated openning same library, was repaired.
	- Error, that allow push box throught right border away from game floor by certain condition,
	  was removed.
	- Critical error, that cause overflowing of memory and game fall, was removed.
	- Error, that give up all graphic data in memory, was removed.
	- Tracing of unnoun error into file error.txt was added.
	- Error by loading of level, that cause fall of game, was repaired. It happend, when user
	  tried close open library by specific conditions.
	
CHANGES IN VERSION BETA 2
-------------------------

CHANGES:
	- Number of levels in all modes was enlarged.
	- Gray grid and button for its showing was added into editor (it's placed under buttons for
	  undo and redo).
	- Graphic coat of game was completly changed.
	- Moving of all pages and menu tables was markedable accelerated.
	
ERRORS:
	- Error, that by stopping of custom map wasn't able to continue in game (button Return to game
	  disappeared), was repaired.
	- If you deleted all library by choosing in level editor by inserting level or in library editor,
	  you could press button Delete library again, although there was noone more. It caused fall of
	  programm. This error was repaired.
	- Pause of game was improved. Sokoban will stop now immediately and after unpausing is
	  everything going to move again.
	- Speed of lowering and pulling out is now depended on settings in menu.
	- Wrong lavel in settings was repaired - speed of menu can't be set on 12 times quicker more,
	  but only 6 time quicker. However speed of screens didn't change.
	- If game is now unpaused, time is increased by sekund. It's kind of recourse for pause and it
	  make impossible to use pause to quick completing of level.
	- Error, that allow to use hotkeys of editor, when table with question of saving changed level was
	  showed, was repaired.
	- Wave algorith in editor, that is used with staff selecting and in test of accessibility single
	  fields and their followend divide into green, yellow and red ones, was remaked and accelerated.
	- A few small errors in engine of game, that cause memory loosing and they could fall program at all,
	  were removed (I focused on them, when game falled several times a second before completing of levels :S).
	- Some menu screens were little changed, especially buttons were removed.
	- Missing label in settings menu by button Default settings was repaired.
	- Error, that caused by repeated pausing and running game with key P, that sound of rooling cycled,
	  was repaired.
	- Error in editor, that cause writed text in level saving after closing of window, was repaired.