CIiP-WiSe-2021-Projektarbeit-Mensch_Aerger_Dich_Nicht/README.md

# Mensch ärgere Dich nicht (Continuous Integration in der Praxis WiSe 2021/2022)
by Jonas Wagner und Felix Krull

## Projektbeschreibung

Unser Ziel war ein funktionierendes "Mensch ärgere Dich nicht"-Spiel zu erstellen unter Verwendung der Methoden, die
wir im Modul Continuous Integration in der Praxis gelernt haben. Aktuell läuft das Spiel bereits auf der Konsole.
Wir haben die Programmiersprache Java, das Build-Tool Maven und Jenkins verwendet. Des Weiteren wurde das Projekt
Test-Driven entwickelt, daher haben wir eine sehr große Testabdeckung für unseren Code. 

### Für die Zukunft haben wir noch einige Erweiterungen geplant:

- GUI für das Spielbrett + Steuerung
- Würfel animieren
- Computergegner implementieren
- Online spielen

## Inhaltsverzeichnis

- [Voraussetzungen](#voraussetzungen)
- [Installation](#installation)
- [Aufbau](#aufbau)
  - [Bedienung](#bedienung)
- [Autoren](#autoren)

## Voraussetzungen

- [Java 1.15+](https://www.java.com/de/)

### Dependencies für Maven

- JUnit Jupiter 5.8.2
- JUnit Platform 1.8.1
- AssertJ 3.21.0

## Installation

#### 1. Spiel herunterladen

[Herunterladen](https://gogs.informatik.hs-fulda.de/FelixKrull/CIiP-WiSe-2021-Projektarbeit-Mensch_Aerger_Dich_Nicht)

#### 2. Game.java Datei kompilieren

Kompilieren Sie Game.java mit der Java-Version, die in den [Voraussetzungen](#Voraussetzungen) definiert wurden.

## Aufbau

Wenn Sie das Spiel ausführen, startet das Spiel direkt. Es gelten die typischen "Mensch ärgere Dich nicht" - Regeln:

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 3x würfeln.
2. Wenn Sie eine 6 würfeln, dürfen Sie noch einmal würfeln.
3. Wer an der Reihe ist, würfelt und darf seine Figur entsprechend dem Würfelergebnis setzen.
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.

Die Reihenfolge der Spieler ist wie folgt: Rot → Blau → Gelb → Grün

Am Anfang wird direkt automatisch gewürfelt. Wenn Sie eine oder mehrere Figuren setzen können haben Sie nach dem
Würfel die Wahl welche Figur Sie setzen möchten.

Diese Aktionen werden so lange wiederholt bis ein Spieler alle Figuren in seinem Haus/Ziel hat.

### Bedienung

Die Bedienung läuft aktuell nur über die Konsole. Sie geben auf die Konsole ein, welche Figur Sie setzen möchten.

Die möglichen Eingaben sind: 0 (erste Figur), 1 (zweite Figur), 2 (dritte Figur), 3 (vierte Figur)

## Autoren

- [Felix Krull](https://gogs.informatik.hs-fulda.de/FelixKrull)
- [Jonas Wagner](https://gogs.informatik.hs-fulda.de/Choan312)