Skip to content

User manual

Tomáš Mlynář edited this page Feb 3, 2023 · 1 revision

Vítejte v uživatelském manuálu Space Exploration Engine!

header image

Na této stránce naleznete informace o tom, jak si můžete nakonfigurovat vlastní level, a také informace o samotné hře, způsobech jak se ovládá a jak vypadá základní rozložení prvků na obrazovce.

Nastavení nové hry

V této části naleznete informace jak si pomocí editoru a uživatelsky modifikovatelných souborů level.yaml a player.yaml můžete upravit jednotlivé aspekty a vlastnosti hry k vytvoření vlastního levelu.

Konfigurace levelu

Level editor

Přehled položek upravitelných editorem

Pomocí editoru můžete upravit rozmístění následujících prvků ve hře:

  • rozmístění překážek (OBSTACLE) (zapsáno pomocí souřadnic X,Y - později také upravitelné přímo v souboru.)
  • rozmístění nepřátel (ENEMY) (zapsáno pomocí souřadnic X,Y - později také upravitelné přímo v souboru.)
  • rozmístění paliva (FUEL) (zapsáno pomocí souřadnic X,Y - později také upravitelné přímo v souboru.)
  • rozmístění přidavačů života (LIFE) (zapsáno pomocí souřadnic X,Y - později také upravitelné přímo v souboru.)
  • rozmístění přidavačů levelu (LEVEL) (zapsáno pomocí souřadnic X,Y - později také upravitelné přímo v souboru.)
Popis editoru

Po zapnutí editoru se objeví dvě samostatná okna. První je okno s tlačítky, které slouží k výběru předmětu (názvy viz výše), který chcete přidat, a tlačítkem SAVE pro uložení konfigurace. Druhé okno poté ilustruje plochu hry. Kliknutím myší na místo na tomto okně dojde k přidání právě vybraného předmětu (POZOR při zapnutí není vybrán ani jeden). V případě opuštění editoru pomocí křížku na okně nedojde k uložení chtěné konfigurace, to lze provést pouze tlačítkem SAVE

Ruční úprava

Všechny atributy lze také upravit ručně v čitelném souboru "level.yaml". Zde je také nutné upravit textové a číselné atributy, pro které není grafický editor určen.

Zde se dají změnit následující atributy:

  • gravitace (gravity) (na škále 0-100)
  • vzhled pozadí (backgroundImagePath) (název obrázku ve formátu image.png)
  • vzhled vaší lodi (shipImagePath) (název obrázku ve formátu image.png)
  • vzhled vaší lodi se zapnutými motory (shipImageEnginesOnPath) (název obrázku ve formátu image.png)
  • síla nepřátelských lodí při nárazu (enemyStrength) (na škále 0-10)
  • síla projektilů nepřátelských lodí (enemyProjectileStrength) na škále (1-100)
  • život nepřátelských lodí (enemyLife) (na škále 1-100)
  • rozmístění a počet překážek (obstaclesPositions) (pomocí pole souřadnic X, Y)
  • rozmístění a počet nepřátelských lodí (enemiesPositions) (pomocí pole souřadnic X, Y)
  • rozmístění a počet paliva (fuelBarrelsPositions) (pomocí pole souřadnic X, Y)
  • rozmístění a počet přidavačů levelu (levelEnhancersPositions) (pomocí pole souřadnic X, Y)
  • rozmístění a počet přidavačů života (lifeAddersPositions) (pomocí pole souřadnic X, Y)

Konfigurace hráče

Hra bude také načítat soubor "player.yaml". Zde budou uloženy atributy/předměty hráče, které hra při stisknutí volby Exit and Save uloží zpět do tohoto souboru.

  • počáteční level vaší lodi (na škále 1-10)
  • počáteční život vaší lodi (na škále 1-100)
  • počáteční množství paliva vaší lodi (na škále 1-100)
  • spotřeba paliva (na škále 0-10)

Hra

Zde jsou uvedené jednotlivé vlastnosti hry a také způsob ovládání.

Úvodní obrazovka

V dolní části úvodní obrazovky se nacházejí následující tlačítka:

  • Play pro spuštění předem nakonfigurované hry
  • Help pro zobrazení krátké nápovědy
  • Exit pro opuštění hry
  • Exit and Save pro ukončení a uložení aktuálního stavu hráče do souboru

Vzhled levelu

Po spuštění hry tlačítkem Play se objeví nakonfigurovaný level. V levém horním rohu obrazovky jsou umístěny 2 ukazatele stavu: pro život a palivo, a také číslo udávající aktuální level vaší lodi (který zároveň udává jak velké poškození způsobí hráčem vystřelené projektily). V levé spodní části se nachází loď hráče ve výchozí pozici a v pravé spodní části se nachází cílová oblast. V ostatních částech obrazovky se nacházejí předem nakonfigurované předměty (jejich rozmístění je náhodné) a také překážky jejichž rozmístěné je dáno konfiguračním souborem.

Cíl hry

Cílem hry je proletět skrze mapu a přistát v cílové oblasti. Během této cesty je potřeba sbírat jednotlivé předměty, které vám usnadní průchod hrou.

  • Palivo vám umožní doplnit jeho stav o 30 %. (+30)
  • Level up předmět zvyšuje aktuální sílu lodi, která zvyšuje účinnost projektilů (projektil způsobí větší snížení života protivníka). (level +1)
  • Život může doplnit ztracený život o 30 %. (+30)

Pokud váš život klesne na nulu hra končí a navrátí vás na úvodní obrazovku.

Průlet herní oblastí je ztížen pohyblivými nepřáteli (pohybují se na dané "trase" seshora dolů, pokud do nich narazíte odebere se vám život stejně jako při nárazu do překážky), kteří po vás střílejí projektily (střílejí přímo vodorovně vlevo). Tyto nepřátele je nutné vystřelením adekvátního počtu střel zabít (snížit jejich život na 0). Každý projektil má danou svou účinnost v závislosti na levelu lodě (level 1 - účinnost 50) Po dosednutí do cílové oblasti se hra ukončí a vrátí na úvodní obrazovku.

Ovládání hry

Let vzhůru je ovládán šipkou vzhůru. Při nestisknutí poté bude loď sama pomalu klesat v závislosti na dané gravitaci. Směr letu se poté ovládá šipkami vpravo a vlevo. Alternativou k šipkám mohou být také klávesy WAD. Vystřelení projektilu se vykoná stisknutím mezerníku (projektil poletí vodorovně směrem vpravo z lodi. Sběr objektů z herního světa probíhá automaticky při dostatečném přiblížení. Pokud budete chtít level ukončit v jeho průběhu, můžete stisknout klávesu escape, která vás navrátí bez uložení na úvodní obrazovku.