# Podręcznik &ksokoban;

## Wprowadzenie

Pierwsza gra sokoban została stworzona w 1982 przez Hiroyuki Imabayashi w japońskiej firmie Thinking Rabiit, Inc. Sokoban to po japońsku magazynier. Wcielasz się w niej w postać magazyniera próbującego przepchnąć skrzynie do odpowiednich miejsc w magazynie.

Problem polega na tym, że nie możesz ciągnąć skrzyń czy przechodzić nad nimi. Jeśli nie jesteś ostrożny, niektóre skrzynie mogą utknąć w złych miejscach i/lub zablokować Ci drogę.

Samo rozwiązanie problemu może być trudne. Ale jeśli chcesz uczynić to jeszcze trudniejszym, możesz spróbować zminimalizować liczbę ruchów i/lub pchnięć użytych do przejścia poziomu.

Aby uczynić grę atrakcyjniejszą dla małych dzieci (poniżej 10 lat) niektóre kolekcje w &ksokoban; zawierają prostsze poziomy. W menu wyboru kolekcji są one zaznaczone jako (łatwe). Oczywiście poziomy te mogą być też rozrywką dla dorosłych, na przykład jeśli nie masz ochoty na zbyt dużo wysiłku umysłowego.

## Gra

Celem gry jest przesunąć wszystkie czerwone klejnoty do docelowych kwadratów zaznaczonych zielonymi, szklanymi okręgami.

Do przemieszczania się używaj kursorów. Jeśli przesuwasz się na pole zajęte przez klejnot używając klawisza kursora lub środkowego przycisku myszy i nic nie blokuje klejnotu z drugiej strony, to wykonasz pchnięcie klejnotu. Nie jest możliwe ciągnięcie klejnotów, więc jeśli przesuniesz klejnot do rogu, utknie tam. Nie możesz też przechodzić nad klejnotami, więc jest możliwe zablokowanie się w części labiryntu poprzez zastawienie wszystkich wyjść klejnotami. Zwróć uwagę, że nie można pchać naraz więcej niż jednego klejnotu.

Jeśli zauważysz, że przesunięto klejnoty tak, że poziomu nie da się już przejść, zawsze możesz użyć opcji cofnij, aby powrócić do momentu w którym popełniono błąd. Oczywiście możesz też zacząć poziom od samego początku.

### Sterowanie

Klawisz | Akcja
Kursory | Przesunięcie o jeden kwadrat w danym kierunku.
&Ctrl;Kursor | Przesunięcie w danym kierunku tak daleko jak to tylko możliwe bez pchania klejnotów
&Shift;Kursor | Przesunięcie w danym kierunku tak daleko jak to tylko możliwe, przesuwając każdy klejnot na drodze.
Lewy przycisk myszy | Przesunięcie w dowolne miejsce labiryntu, które może być osiągnięte bez przesuwania klejnotów
Środkowy przycisk myszy lub &Ctrl;Z | Cofnięcie ostatniego ruchu
Prawy przycisk myszy | Przesunięcie w górę/dół/lewo/prawo w prostej linii przesuwając każdy klejnot na drodze
Rolka myszy | Cofnięcie/przywrócenie ruchu z historii
&Ctrl;&Shift;Z | Powtórzenie ostatnio cofniętego ruchu.
N | Przejście do następnego magazynu w aktualnej kolekcji
P | Przejście do poprzedniego magazynu w aktualnej kolekcji
&Esc; | Powtórzenie aktualnego magazynu
&Ctrl;Q | Wyjście z gry

### Wczytywanie magazynów z pliku

&ksokoban; ma możliwość wczytywania zewnętrznych magazynów z plików tekstowych. Możesz to zrobić poprzez menu Gra Wczytaj magazyny... , lub przez wpisanie &URL;-a pliku jako argumentu w linii komend podczas włączania &ksokoban; przez konsolę.

Zewnętrzne magazyny muszą być zdefiniowane za pomocą standardowych symboli z tabeli poniżej. Jeśli plik zawiera więcej niż jeden magazyn, powinny być one oddzielone pustymi liniami. Pomiędzy magazynami można też zawrzeć tekst.

Symbol | Znaczenie
`#` | Ściana
(spacja) | Pusty kwadrat
`.` | Kwadrat docelowy
`$` | Objekt na pustym kwadracie
`*` | Objekt na docelowym kwadracie
`@` | Pozycja startowa na pustym kwadracie
`+` | Pozycja startowa na docelowym kwadracie

Jako przykład, poniżej jest tekst przedstawiający pierwszy magazyn w kolekcji Microban:

    ####
    # .#
    #  ###
    #*@  #
    #  $ #
    #  ###
    ####

## Opis menu

Oto kompletny przewodnik po menu &ksokoban;

### Menu Gra

Gra Wczytaj magazyny...

- Wczytanie magazynów z pliku. Zobacz sekcję Wczytywanie magazynów z pliku, aby uzyskać więcej informacji.

N Gra Następny magazyn

- Wczytanie następnego magazynu.

P Gra Poprzedni magazyn

- Wczytanie poprzedniego magazynu.

&Esc; Gra Powtórz magazyn

- Przywraca początkowy stan aktualnego magazynu.

Gra Kolekcja magazynów

- Zmiana kolekcji magazynów. &ksokoban; od początku zawiera kilka kolekcji magazynów, więcej możesz znaleźć w Internecie.

&Ctrl;Z Gra Cofnij

- Cofnięcie poprzedniego ruchu

&Ctrl;&Shift;Z Gra Przywróć

- Przywrócenie ostatniego ruchu, który cofnięto używając elementu menu powyżej.

&Ctrl;Q Gra Zakończ

- Wyjście z &ksokoban;.

### Menu Animacja

Menu Animacja pozwala określić szybkość z jaką pokazywane są animacje.

Animacja Powoli

- Pokazuje animacje powoli.

Animacja Średnia

- Jest to domyślne ustawienie i pokazuje animacje nieco szybciej.

Animacja Szybko

- Pokazuje animacje najszybciej.

Animacja Wyłącz

- Nie animuje ruchów.

### Menu Zakładki

Zakładki Dodaj zakładkę

- &ksokoban; pozwala Ci dodać zakładki z magazynem w dowolnym stanie. Możesz użyć tego do oszczędzenia sobie powtarzania tych samych początkowych ruchów w magazynie.

  Możesz mieć naraz do dziesięciu zakładek i otwierać je za pomocą skrótu klawiszowego &Ctrl;`X`, gdzie `X` jest cyfrą pomiędzy 0 i 9.

Zakładki Użyj zakładki

- Przejście do stanu, który zapisano w zakładce.

### Menu Pomoc

&help.menu.documentation;

## Zasługi i licencje

Prawa autorskie do programu &ksokoban; : copyright © 1998-2000 &Anders.Widell; &Anders.Widell.mail;. Jeśli chcesz być na bieżąco z &ksokoban;, zobacz stronę domową &ksokoban; pod adresem http://hem.passagen.se/awl/ksokoban/.

Grafika tła pole gwiezdne pochodzi z programu Gimp. Autorem pozostałej grafiki jest &Anders.Widell; &Anders.Widell.mail;, została ona stworzona za pomocą programu Povray.

Wszystkie dołączone magazyny zostały stworzone przez Davida W. Skinnera sasquatch@bentonrea.com. Zobacz jego stronę o grze sokoban pod adresem http://users.bentonrea.com/~sasquatch/sokoban/.

Polskie tłumaczenie dokumentacji: Paweł Stankowskiak_ambi@op.pl

&underFDL; &underGPL;

## Instalacja

&install.intro.documentation; &install.compile.documentation;
&documentation.index;