IJA 2022/23: Projekt - Aplikace typu Pac-Man

Vedoucí

Jméno a příjmení: Šafář Vítězslav
Login: xsafar26

Člen týmu

Jméno a příjmení: Richard Kocián
Login: xkocia19

Překlad a spuštění programu

Pro přeložení a spuštění programu je použit příkaz:

mvn javafx:run

Programová dokumentace

Programová dokumentace lze vygenerovat pomocí:

mvn javadoc:javadoc

Tato dokumentace se nachází ve složce target/site a je zobrazitelná pomocí otevření souboru index.html v libovolném webovém prohlížeči.

Popis řešení

Aplikace byla vytvářena v jazyce Java SE 17 a pro grafické rozhraní bylo použito JavaFX. Struktura programu byla rozdělena do 5 balíčků common, game, gui, logging, view. Kde:

• common obsahuje všechny rozhraní tohoto programu
• game obsahuje třídy pro logiku a funkčnost aplikace
• gui obsahuje třídy pro grafické rozhraní
• logging obsahuje třídy použity pro vytváření i přehrávání logů
• view obsahuje třídy rozšiřující rozhraní Observer

Pro programování byla použita metoda párového programování.

Popis aplikace

Aplikace je kompatibilní a bylo testováno na operačním systémem MacOS a Ubuntu Linux.

Aplikaci lze ovládat pomocí klávesnice i myši. Pro ovládání přes myš byl použit algoritmus A* neboli A star. Obsahuje 6 různých map s různými velikostmi, počtem duchů a počtem klíčů. Hra skončí po ztrátě 3 životů nebo po posbírání všech klíčů a dojití na cílové políčko. Aplikace obsaju ukazatel aktuálního počtu srdíček a počet již sebraných a potřebných klíčů.

Každá odehraná hra vytvoří svůj logovací soubor ve složce log.
Logovací soubor obsahuje použitou mapu, následně pohyb všech objektů a eventy. Eventy mohou být: sebrání klíče, ztráta života, výhra/prohra.
Logovací soubor obsahuje ve svém názvu datum a čas chvíle, kdy byla hra započata.

Ovládání:

Hra:

• Pohyb Pacmana:
  • WASD, šipky
  • Levé tlačítko myši na místo, kam má Pacman dojít.
• Zpět do menu: ESCAPE

Přehrávání logu:

• Přepínání módu přehrávání (po krocích/časové): M
• Přesun na začátek logu: S, B, Z
• Přesun na konec logu: K, E, F
• Pauza: mezerník, ENTER
• Posun vpřed: šipka nahorů, šipka doprava, pravé tlačíko myši
• Posun vzad: šipka dolů, šipka doleva, levé tlačítko myši
• Zpět do menu: ESCAPE

Zdroje

Grafické objekty:

• pacman - https://giphy.com/stickers/-nofluffjobs-pacman-nofluffjobs-nfj-4T8gobqb8sEQ09B51V
• duchové - https://giphy.com/stickers/deviantart-pacman-iceman1199-RAGUpYLsOX2Pm
• klíč - Freepik - https://www.flaticon.com/free-icon/key_8033866?related_id=8033866
• target - Freepik - https://www.flaticon.com/free-icon/target_3207593?term=target&related_id=3207593
• křížek - Moqaccino Resources - https://www.flaticon.com/free-icon/button_5735775?term=exit&page=1&position=6&origin=search&related_id=5735775
• ovládací prvky:
  • šipky - Roundicons - https://www.flaticon.com/free-icon/right-arrow_271228?term=arrow&page=1&position=2&origin=search&related_id=271228
  • pause/play - Schmidsi - https://pixabay.com/vectors/play-break-button-play-button-2749271/

Zvuková media:

• intro - https://soundbible.com/1563-Pacman-Introduction-Music.html
• úmrtí - http://soundfxcenter.com/download-sound/pacman-dies-sound-effect/
• ztráta života - https://www.zedge.net/ringtone/a1bca0eb-0598-4c7e-8c47-4c7b7b4f0964
• Výhra a zvednutí klíče - https://mixkit.co/free-sound-effects/game/