
   _________                 ___                       ___
  /         \               |   |                     |   |
 /    ___    \              |   |                     |   |
 |   /   \    \             |   |                     |   |
 |   |   |____|             |   |                     |   |         
 |   |                      |   |    /\               |   |         
 |   \______                |   |   /  \              |   |         
 \          \    ________   |   |  /    |  ________   |   |______         __         ____  _____
  \______    \  /        \  |    \/    /  /        \  |          \       /  \       |    |/     \ 
         \   | /    __    \ |         /  /    __    \ |    ___    |     /    \      |            \
  ___    |   | |   |  |   | |   \    /   |   |  |   | |   |   |   |    /  /\  \     |     ____    |
 |   |   |   | |   |  |   | |   |\   \   |   |  |   | |   |   |   |   /   --   \    |    /    \   |
 \   \__/    / |   |__|   | |   | \   \  |   |__|   | |   |___|   |  /   ____   \   |    |    |   |
  \         /  \          / |   |  \   \ \          / |           / /   /    \   \  |    |    |   |
   \_______/    \________/  |___|   \___\ \________/  \__________/ /___/      \___\ |____|    |___|
					    			A  R  M  A  G  E  D  D  O  N
                                                                                          verze 1.1
						
                                                                           created by Forever games
                                                                             www.fgames.gamecode.cz   
===================================================================================================
=== = ==== === = === === = === === = === === = === === = === === = === === = === === = === === = ==
==== ==== = === === = === === = === === = === === = === === = === === = === === = === === = === ===
=== = ==== === = === === = === === = === === = === === = === === = === === = === === = === === = ==
===================================================================================================
 
Japonsk logick hra, kterou jist vichni znte. Clem hry je dotlait vechny bedniky na vyznaen
polka. Mete vak tlait pouze jednu a pouze dopedu. To znamen, e s bednikou v rohu ji
nepohnete a od stny j tak neodtlate. Na prvn pohled jednoduch hra, kterou kad pochop
za deset minut, je ve skutenosti pekeln tk hlavolam.

1) Zkladn informace o he
2) Nco k historii hry Sokoban
3) Autoi jednotlivch level
4) Jak nainstalovat hru
5) Systmov nroky
6) Ovldn hry
7) Objevila se ve he chyba?
8) Betatesting
9) Typy zvuk
10) Vloen vlastn hudby
11) Kontakt
12) Historie verz

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

1) Zkladn informace o he 
===========================

Jak jsem ji ekl, pravidla hry jsou velice jednoduch a kad je doke pochopit do 10-ti minut.
Hra se skld z jednotlivch level o maximln velikosti 20x17 polek. Nkter polka jsou
vyplnna zd, jin jsou voln. Podlaha nkterch z nich zelen svt, takto jsou oznaena zsuvn
polka. Dle je v levelu rozmstno stejn beden jako zsuvnch polek. Pokud je bedna natlaena
na zsuvnm polku, zelen se rozz. A vam clem je dostrkat vechny bedniky na zsuvn polka.
Skladnk vak me tlait pouze jednu bednu najednou a vdy pouze dopedu. Hra je vytvoena pes
DirectX (konkrtn DirectDraw) a funguje v rozlien 800x600. Hra obsahuje 250 level rozdlench
do 5 kampan s pznanmi nzvy Lehk, Stedn, Tk, Zvod s asem a Nehbej se! (levely s
pohybovmi omezenmi). Level je vykreslovn pomoc izometrie. Hra obsahuje tak komplexn level
editor a rozshl systm menu skldajc se bez mla z 30 obrazovek. Soust hry je kvalitn hudebn
doprovod ve formtu ogg vorbis. Grafika hry je situovna do starho skladit, jeho stny jsou msty
prorezl a nkter elektronick prvky nefunguj. A v tomto prosted mus pracovat skladnk, jeho
jedinou prac je perovnvat bedny s radioaktivnm odpadem. Prosted je doplnno adou pknch
grafickch prvk. V pravm dolnm rohu se to prorezl star vtrk, poblikvaj LED diody signalizujc
smr skladnkova pohybu. Jedna z nich nefunguje, z dry vyltvaj pouze jiskry. Avak tyto efekty
samozejm mou ruit, a proto je mon je kdykoliv vypnout. 

2) Nco k historii hry Sokoban
==============================

Historie tto hry je velice zajmav. Prvn verze tohoto neobyejn komplikovanho hlavolamu pochz
z roku 1982. Vytvoil ho Hiroyuki Imabayashi, kter dajn publikoval prvn ideu hernho konceptu ji
v roce 1980. Ve mst Takarazuka v Japonsku vypsala jedna skladovac spolenost sout o potaovou
hru na tma skladovn. A Sokoban tuto sout vyhrl. Dky genilnmu nvrhu, jednoduchm pravidlm
a 50 legendrnm, vcelku dosti obtnm levelm dokzala pedhonit i jinak daleko oblbenj hern
nry jako akn nebo dobrodrun. Prv tchto 50 originlnch level dokzalo proslavit hru po celm
svt a v mm remaku Sokobana je naleznete samozejm tak. Jak jsem ji ekl, samotnou mylenku
hlavolamu objevil vak Hiroyuki Imabayashi ji v roce 1980 a publikoval ji prv v tto souti.
Sokoban se voln pekld jako skladnk nebo skladn inenr. Pesto znte spe prvn verzi
publikovanou mimo Japonsko spolenost Spectrum Holobyte z roku 1984 (svtle modr podlaha a
fialov cihlov zdi). Sokoban je jednou z nejhranjch her v historii, existuje cel ada jeho
remak snad na vechny platformy (od Windows pes Linux, Windows CE a mobiln telefony s Javou).
Na internetu jsou tisce level, z nich nkter jsou velice obtn. Jin jsou naopak ureny pro
dti, jsou podstatn jednodu a maj jim pomoci rozvjet sv logick mylen. Rd bych zde tak
vyzdvihl prci nkterch designr level, kte ve volnm ase vytv obrovsk databze obsahujc
stovky obtnch levelu na velmi malm prostoru mnohdy s jenom nkolika mlo bednami, navzjem si
je vylepuj a sna se najt nejkrat een. Mimochodem najt nejkrat een pomoc potae
nen vbec jednoduch, je to takzvan NP-pln problm. To znamen, e v ppad velikho levelu
s destkami beden by se mohlo hledn prothnout i na nkolik milin let :). Avak toto dl Sokobana
jet zajmavjm, nebo k nalezen sprvn cesty nesta pouze spustit program a chvilku pokat.
A vte, e vm nkter levely daj skuten zabrat.

3) Autoi jednotlivch level
=============================

Jak ji jsem ekl, hra obsahuje 250 level od nkolika autor. Tmto bych jim rd podkoval za
povolen pout jejich levely do m hry. Musm jim vyjdit svj obdiv, kolik asu he a vypilovan
svch level vnovali. A nyn ji nkolik informac o jednotlivch autorech: 

Hiroyuki Imabayashi - legendrn levely od tohoto genilnho autora Sokobana jsem prost nemohl
	vynechat. Jejich obtnost se pkn stupuje a jsou dobr, pokud se chcete nauit hrt Sokobana.
	Budou se vyskytovat v kampani Stedn. 

Frantiek Pokorn - tento esk autor m velice pkn mal levely, kter jsou vak as od asu
	dosti komplikovan. Budou proto ureny pevn pro kampan Zvod s asem a Nehbej se! Na jeho
	strnce www.kantorek.webzdarma.cz najdete vedle kreslench vtip Pavla Kantorka a pkn sbrky
	Murphyho zkon tak slunou hromdku level do Sokobana. Sesbral toti levely od jednotlivch
	level a velikost databze pesahuje nyn ji 3500, co je docela slun, e ano? 

Evgeny Grigoriev alias GRIGoRusha - levely od tohoto tvrce rusk nrodnosti pat k tomu
	nejobtnjmu, s m se ve he setkte. Pevn vtina z nich se bude tvoit kampa Tk.
	Jinak zde si mete prohldnout jeho vcelku pkn strnky: www.grigr.narod.ru 

David W. Skinner - tento americk autor vytvoil rozshl srie zejmna stedn obtnch level.
	Nkter z nich (zejmna ze skupiny Microban - co znamen hodn mal levely) najdete v kampani Lehk.
	Seznam vech level si mete prohldnout zde: http://users.bentonrea.com/~sasquatch/sokoban/ 

Aymeric du Peloux - levely tohoto francouzskho designera pat k tm nejlepm, nejhezm
	a nejobtnjm. Pesto jsou velmi mal a poet beden v nich nikdy nepeshne osm kus. Jeho kolekce
	Minicosmos, Microcosmos, Nabokosmos a Picocosmos tvo vedle levelu Frantika Pokornho a nkolika
	mch kousk kampan Zvod s asem a Nehbej se! Mete si prohldnout je strnky ve francoutin
	(dleit vci jsou t v angliin) a zahrt si nkter levely online:
	http://membres.lycos.fr/nabokos/ 

A zvrem bych tak rd ekl, e v Sokobanovi najdete i nkolik mch vcelku dost obtnch level.

4) Jak nainstalovat hru
=======================

Sokoban nepotebuje dn install. Sta pouze rozbalit vechny soubory nkam na pevn disk.
Kvli sprvnmu chodu hry nelze poutt hru z CD nebo z disku, kde nem uivatel oprvnn
zapisovat data. Pokud se vm pi sputn objev hlka typu:

"Aplikace nemohla bt sputna, protoe soust XXXXXX.dll nelze najt. Pote pravdpodobn
odstrante optovnou instalac aplikace",

zkontolujte nejprve, jestli to nen jedna knihovna z tohoto seznamu:

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

Pokud je, mte archv se hrou pokozen nebo nedotaen. Sthnte si ho proto znovu z naich
webovch strnek www.fgames.gamecode.cz. Pokud ne, polete nm prosm jej jmno na mail
fgames@gamecode.cz a obratem vm ji zaleme.

5) Systmov nroky
===================

Minimln konfigurace je: 300 MHz, 16 MB RAM, DirectX 8 nebo vy
Doporuen konfigurace je: 500 MHz, 32 MB RAM, grafick karta

6) Ovldn hry
===============

hra:
->, v, <-, ^ (kurzorov ipky)     pohyb Sokobana
P                                  zapauzovat / odpauzovat hru
R                                  restartovat level
ESCAPE                             pepnout do hernho menu (u testovn levelu konec do editoru)

menu:
ENTER                              potvrdit volbu
ESCAPE                             stornovat volbu nebo se vrtit se na pedchoz obrazovku

editor:
ALT								   zobrazit tabulku s klvesovmi zkratkami

Jednotliv klvesov zkratky pro vechny funkce naleznete v popisu funkce v hranatch zvorkch.

Pi prci s hlkou lze oblasti pidvat (pokud drte klvesu SHIFT) nebo odebrat (pokud drte
klvesu ALT).

Pokud budete mt njak otzky k editoru nebo neporozumte nkter jeho funkci, napite nm na mail
fgames@gamecode.cz. Pokud vytvote njak levely a budete je chtt zveejnit, mete nm je poslat
a my to udlme na naich strnkch.

7) Objevila se ve he chyba?
============================

Pestoe ji dal dobu probh betatesting, vdycky s me njak ta chybka objevit. Proto
pokud vm hra spadne nebo nebude pracovat korektn, polete nm na mail informaci o chyb
(kdy se to stalo, vai konfiguraci, ...), ppadn zkuste vyzkoumat, jestli je tato chyba
pravideln nebo se jedn pouze o mimodnou udlost.

Pokud se vm hru vbec nepodailo spustit, zkontrolujte, zda jste si sthli vechny soubory:

v adresi se hrou:
Common.dll
MFC71.dll
MFCO42D.DLL
msvcr71.dll
MSVCRTD.DLL
ogg.dll
OggCodec.dll
setup.exe
sokoban.exe
vorbis.dll
Zip.dll

v adresi source:
czech.txt
dontmove.llb
easy.llb
english.txt
hard.llb
medium.llb
timerun.llb

v adresi 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

v adresi 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

v adresi source\fonts:
CourierB.ddf
CourierG.ddf
CourierMenu.ddf
CourierS.ddf
VerdanaB.ddf
VerdanaS.ddf
VerdanaSM.ddf
   
Pokud nkter z tchto soubor chyb, sthnte si ze strnky www.fgames.gamecode.cz zabalen soubor
se hrou znovu. Pokud ani toto nepome, kontaktujte autory na mail fgames@gamecode.cz. Podobn,
pokud jsou vechny soubory na svm mst.

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

Tm Forever games shn dal lidi pro betatesting tohoto i budoucch projekt. Mte dost volnho
asu a rdi byste se podleli na tvorb her, pestoe nejste ani programtor, ani grafik. Pak se
mete stt nam betatestrem. Budete tak prvn, kdo spat nae hry a vae jmno bude uvedeno v titulkch.
Pokud mte zjem o betatesting, napit nm na adresu fgames@gamecode.cz.

9) Typy zvuk
=============

V Sokobanovi se mono nast zvuky dvma zpsoby. Streamov zvuky se do pamti nenatou cel, pi pehrvn se
postupn po malch stech z disku. Je trochu pomalej, avak natn hry je rychlej a nezabr velk msto
v pamti. Streamov zvuky se pouvaj pro hudbu, ppadn dialogy. Druhou monost je zvuky dekomprimovat a
uloit pmo do pamti. Natn tchto zvuku je vrazn pomalej a jeden takov soubor si alokuje znanou
pam, avak jejich pehrvn je trochu rychlej a lze je pehrvat vcekrt najednou.

U kadho zvuku si mete v souboru setup.exe nastavit typ pehrvn. Kad zvuk je mon tak vypnout. Toto
nastaven je vak pouze pro pokroil uivatele.

10) Vloen vlastn hudby
=========================

Do hry Sokoban: Armageddon je mon vloit vlastn hudbu. Vytvote si soubor s hudbou v libovolnm formtu (MP3, OGG, WMA, ...),
pot tento soubor zkoprujte do adrese source/music pod nzvem music.ogg (nezvisle na typu souboru). Pi dalm sputn
ji bude hrt vae vlastn hudba.

11) Kontakt
===========

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

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

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

ZMNY VE VERZI 1.1
------------------

ZMNY:
	- Byla zmnna knihovna pro prci se zvukem. Byla pouita komern knihovna FMOD (http://fmod.org).
	- Natn bylo vloeno do vlkna, bylo upraveno jeho vykreslovn.
	- Bylo rozeno nastaven hry, nyn je mon jednotliv zvuky streamovat, uloit do pamti, nebo
	  nenatat a pouvt vbec. Pokud se chcete dozvdt, jak je rozdl mezi streamovmi zvuky a
	  zvuky v pamti, viz ve (st 9)

CHYBY:
	- Byla odstranna kritick chyba, kter zpsobovala padn hry! (informoval jsem o n ped asem na strnkch)
	- Bylo odstranno cvkn zvuku v kreditech.

ZMNY VE VERZI 1.0b
-------------------

CHYBY:
	- Byla odstranna chyba, kter zpsobovala nezobrazovn nhled a informac o levelu.
	- Byl vyeen problm s tabulkami nejlepch hr. Dochzelo ke patnmu natn, co
	  v dsledku promchalo jednotliv tabulky.


ZMNY VE VERZI 1.0
------------------

Je jich ohromn spousta, tohle jsou alespo nkter z nich.

ZMNY:
	- Byla pidna anglick lokalizace, byl kompletn zmnn systm hry
	- Dolo k razantn zmn grafiky, byla pidna isometrie
	- Byly zmnny nkter zvuky
	- Bylo zmnno logo spolenosti Forever games a logo hry Sokoban
	- Byl zmnn nzev hry na Sokoban: Armageddon
	- Byly pidny nkter grafick prvky doplujc hern okraje
	- Bylo zmneno nastaven hry
	- Bylo vytvoeno extern nastaven v souboru setup.exe
	- Levely ve he byli peorganizovny do 5 kampan, kad sestv z 50 level
	- Byl opraven a rozen level editor
	- Byla zmnna hern hudba
	- Titulky ve he byli peprogramovny a rozeny
	- Byly odstranni animace pi ekn a rotace Sokobana
	- Pohyb Sokobana byl vrazn zrychlen
	- U asov omezench level se poslednch pt sekund odpotv cinknutm
	
CHYBY:
	- Byla opravena chyba s nepstupnost tlatek u posouvn levelu
	- Mka v editoru se nezobrazovala (vbec). Tato chyba byla odstranna.
	- Bylo odstranno nkolik chyb s pstupnost tlatek v editoru knihoven a
	  ve vkldn level do knihovny v level editoru.
	- Byla opravena zken chyba, kter zpsobovala pd hry pi opakovanm otvrn
	  te knihovny.
	- Byla odstranna chyba, kter umoovala za uritch podmnek vytlait bednu
	  pravm okrajem pry z hern plochy.
	- Byla odstranna kritick chyba, kter zpsobovala peteen pamti a pd hry.
	- Byla odstranna chyba, kter zanechvala v pamti vechna grafick data.
	- Bylo pidno vypisovn neznmch chyb do souboru error.txt.
	- Byla opravena chyba pi natn levelu, kter zpsobovala pd hry. Nastala, pokud
	  uivatel pokusil za uritch podmnek zavt otevenou knihovnu.
	
ZMNY VE VERZI BETA 2
---------------------

ZMNY:
	- Byl zvten poet level ve vech hernch mdech.
	- V editoru byla pidna ed mka a tlatko pro jej zobrazen (nachz se pod tlatky
	  pro undo a redo).
	- Byla kompletn zmnn grafick kabt hry.
	- Byl vrazn zrychlen pohyb vech strnek a tabulek menu.
	
CHYBY:
	- Byla opravena chyba, kdy po pozastaven hran vlastn mapy nebylo mon ve he pokraovat (zmizelo
	  tlatko Nvrat ke he)
	- Pokud jste v editoru level pi vkldn level nebo v editoru knihoven vymazali pi vbru vechny
	  knihovny, mohli jste stisknout tlatko Smazat knihovnu dl, pestoe tam ji dn nezbyla. Jeho
	  stisk zpsobil pd programu. Tato chyba byla opravena.
	- Byla vylepena pauza hry. Sokoban se nyn okamit zastav a po odpauzovn se opt rozhbe.
	- Rychlost spoutn a vytahovn pauzovac roletky nyn zvis na nastaven v menu.
	- Byl opraven chybn popisek v nastaven - rychlost menu nelze ji pepnout na 12x rychlej, ale 
	  pouze na 6x rychlej. Rychlost obrazovek se vak nezmnila.
	- Pokud je hra nyn odpauzovna, je zvten as o 1 sekundu. To je jaksi postih za pauzu a znemouje
	  vyuvn pauzy k rychlejmu dohrt kola.
	- Byla opravena chyba, kter umoovala pout hotkeye editoru, kdy byla zobrazena tabulku, zda chcete
	  uloit zmny proveden v levelu.
	- Byl pedln a zrychlen vlnov algoritmus v editoru, kter se pouv pi oznaovn hlkou a pi testu
	  pstupnosti jednotlivch polek a jejich nslednho rozdlen na zelen, lut a erven.
	- Bylo opraveno nkolik drobnch chybek v enginu hry, kvli kterm dochzelo ke ztrtm pamti a mohli dokonce
	  vst k pdu programu (zaostil jsem si na n, po tom, co m to nkolikrt po sob spadlo tsn ped dohrtm
	  levelu :S).
	- Bylo trochu pozmnny nkter obrazovky menu, hlavn pemstn tlatek.
	- Byl opraven chybejc popis v menu nastaven u tlatka Vchoz nastaven.
	- Byla opravena chyba, kter pi opakovanm pozastavovn a poutn hry pomoc klvesy P zpsobila, e zvuk
	  rolovn se zacyklil.
	- V editoru level byla odstranna chyba, pi kter zstval pi ukldn levelu napsan text i po zaven okna.