You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

89 lines
3.0 KiB

  1. # Mensch ärgere Dich nicht (Continuous Integration in der Praxis WiSe 2021/2022)
  2. by Jonas Wagner und Felix Krull
  3. ## Projektbeschreibung
  4. Unser Ziel war ein funktionierendes "Mensch ärgere Dich nicht"-Spiel zu erstellen unter Verwendung der Methoden, die
  5. wir im Modul Continuous Integration in der Praxis gelernt haben. Aktuell läuft das Spiel bereits auf der Konsole.
  6. Wir haben die Programmiersprache Java, das Build-Tool Maven und Jenkins verwendet. Des Weiteren wurde das Projekt
  7. Test-Driven entwickelt, daher haben wir eine sehr große Testabdeckung für unseren Code.
  8. ### Für die Zukunft haben wir noch einige Erweiterungen geplant:
  9. - GUI für das Spielbrett + Steuerung
  10. - Würfel animieren
  11. - Computergegner implementieren
  12. - Online spielen
  13. ## Inhaltsverzeichnis
  14. - [Voraussetzungen](#Voraussetzungen)
  15. - [Installation](#Installation)
  16. - [Aufbau](#Aufbau)
  17. - [Bedienung](#Bedienung)
  18. - [Struktur Code](#Struktur-Code)
  19. - [Tests](#Tests)
  20. - [Autoren](#Autoren)
  21. ## Voraussetzungen
  22. - [Java 1.15](https://www.java.com/de/) (sollte aber auch mit fast allen weiteren Versionen funktionieren)
  23. ### Dependencies für Maven
  24. - JUnit Jupiter 5.8.2
  25. - JUnit Platform 1.8.1
  26. - AssertJ 3.21.0
  27. ## Installation
  28. #### 1. Spiel herunterladen
  29. [Herunterladen](https://gogs.informatik.hs-fulda.de/FelixKrull/CIiP-WiSe-2021-Projektarbeit-Mensch_Aerger_Dich_Nicht)
  30. #### 2. Game.java Datei kompilieren
  31. Kompilieren Sie Game.java mit der Java-Version, die in den [Voraussetzungen](#Voraussetzungen) definiert wurden.
  32. ## Aufbau
  33. Wenn Sie das Spiel ausführen, startet das Spiel direkt. Es gelten die typischen "Mensch ärgere Dich nicht" - Regeln:
  34. 1. Wenn alle Figuren noch nicht auf dem Spielfeld sind, benötigt man eine 6, um eine Figur auf die Startposition der Farbe zu setzen. Hier darf man bis zu 6x würfeln.
  35. 2. Wenn Sie eine 6 würfeln, dürfen Sie noch einmal würfeln.
  36. 3. Wer an der Reihe ist, würfelt und darf seine Figur entsprechend dem Würfelergebnis setzen.
  37. 4. Sollte eine Figur von Spieler 1 auf ein Feld kommen, wo eine Figur von Spieler 2 steht, wird die Figur von Spieler 2 geschmissen und kehrt zurück in die Basis.
  38. 5. In dem Haus/Ziel dürfen keine Figuren übersprungen werden
  39. 6. Im Haus/Ziel muss man die genaue Zahl würfeln, um zu setzen. Man kann sich überwerfen.
  40. Die Reihenfolge der Spieler ist wie folgt: Rot → Blau → Gelb → Grün
  41. Am Anfang wird direkt automatisch gewürfelt. Wenn Sie eine oder mehrere Figuren setzen können haben Sie nach dem
  42. Würfel die Wahl welche Figur Sie setzen möchten.
  43. Diese Aktionen werden so lange wiederholt bis ein Spieler alle Figuren in seinem Haus/Ziel hat.
  44. ### Bedienung
  45. Die Bedienung läuft aktuell nur über die Konsole. Sie geben auf die Konsole ein, welche Figur Sie setzen möchten.
  46. Die möglichen Eingaben sind: 0 (erste Figur), 1 (zweite Figur), 2 (dritte Figur), 3 (vierte Figur)
  47. ## Struktur Code
  48. ### Game.java
  49. ### Player.java
  50. #### Figur.java
  51. ### Gameboard.java
  52. ## Tests
  53. ## Autoren
  54. - [Felix Krull](https://gogs.informatik.hs-fulda.de/FelixKrull)
  55. - [Jonas Wagner](https://gogs.informatik.hs-fulda.de/Choan312)