Projekt: Hangman

Slides:

Ziele:

Programmiere das bekannte Hangman-Game als Konsolenapp.
Grösseres Programm schreiben (ca. $300$ Zeilen Code)
Lerne, wie man anhand des Programmierparadigmas Model vs. View Code sinnvoll strukturiert.
Scope von Variablen verstehen.
Unterschied Werttypen vs. Referenztypen verstehen.
Robusten Code schreiben, der für alle Eventualitäten gewappnet ist.

Auftrag:

Erstelle ein neues GitHub-Repo „HangMan“ und teile es mit den Lehrpersonen. Wähle beim erstellen private und Visual Studio für das GitIgnore-File. Klone das Repo auf deinen Computer und …
… erstelle darin ein neues C#-Konsolenprogramm mit Namen „HangMan“. Wichtig: Wähle beim Erstellen des Projekte „Erweitert: Keine Anweisungen der obersten Ebene verwenden“ (Engl.: etwas mit „Top-Level Statements“) aus.
Verwende das Template (siehe unten) und …
… Programmiere damit das Spiel Hangman. Schaue, dass alle Vorgaben unten erfüllt sind.
Teste dein Spiel ausgiebig: Falsche Eingaben machen, Spiel gewinnen, verlieren, …
Wenn du denkst dass du fertig bist: Gehe die Checkliste unten durch. Falls ein Punkt nicht erfüllt ist, verbessere diesen und hake diesen ab. Sobald alle Punkte erfüllt und abgehakt sind …
… Arbeit abgeben:
1. Nachricht an Lehrperson in Teams-Chat
2. inkl. Link zu GitHub-Repo
3. inkl. abgehakter und unterschriebener Checkliste

Zeit: Zwei EFIF-Nachmittage (6 Lektionen), Rest HA

Vorgaben:

Template verwenden und an dieses halten.
Code muss robust sein: Egal was Benutzer eingibt: Code muss damit klarkommen.
Von Player1 eingegebenes Wort (das, welches Player2 erraten muss) muss folgende Bedingung erfüllen:
- Mind. 3 Buchstsaben
- Nur ASCII-Grossbuchstaben: 'A', 'B', 'C', 'D', 'E', 'F', 'G', 'H', 'I', 'J', 'K', 'L', 'M', 'N', 'O', 'P', 'Q', 'R', 'S', 'T', 'U', 'V', 'W', 'X', 'Y', 'Z'
- also keine Umlaute (Ä,Ö,Ü) usw. (É,…), keine Leerschläge
- Bei unzulässiger Eingabe wird solange aufgefordert, neues einzugeben bis ok
Nur GROSSBUCHSTABEN. Player1 & 2 können Kleinbuchstaben eingeben, werden dann aber in Grossbuchstaben umgewandelt.
Erraten der Buchstaben (Player2):
- Wird bereits erratener Buchstabe erraten, zählt dies nicht als Fehlversuch. Player2 wird darauf hingewiesen und aufgefordert, andren Buchstaben einzugeben.
- Auch unzulässige Eingaben (Zahl, Umlaut, Sonderzeichen, …) zählen nicht als Fehlversuche.

Template

Template (ohne Top-Level Statements)

namespace HangMan; // here use name of your project
 
class Program
{
    // No variable declarations in this area!!
    static void Main(string[] args)
    {
        // Variable declarations allowed here
        while (true)                     // The game repeats until finished by player 1
        {
            // Variable declarations allowed here
            ReadSecretWord();            // Player 1: Enter the secret word to be guessed by player 2
            HangTheMan();                // Screen output for a good start
            while (true)                 // Player 2: Make your guesses
            {
                ReadOneChar();           // Handle input of one char. 
                EvaluateTheSituation();  // Game Logic goes here
                HangTheMan();            // Screen output goes here
            }
            QuitOrRestart(); // Ask if want to quit or start new game
        }
    }
 
    static void ReadSecretWord() // Modification of method declaration recommended: Add return value and parameters
                                 // If there are rules and constraints on allowed secrets (e.g. no digits), check them in here
    {
        // Variable declarations allowed here
        // Console.Write() etc. allowed here!
    }
 
    static void ReadOneChar() // Modification of method declaration recommended: Add return value and parameters
                              // If there are rules and constraints on allowed secrets (e.g. no digits), make sure the input is allowed
    {
        // Variable declarations allowed here
        // Console.Write() etc. allowed here!
    }
 
    static void EvaluateTheSituation() // Modification of method declaration recommended: Add return value and parameters
                                       // In here, evaluate the char entered: Is it part of the secret word?
                                       // Calculate and return the game status (Hit or missed? Where? List and number of missed chars?...)
    {
        // Variable declarations allowed here
        // NO Console.Write() etc. in here!
    }
 
    static void QuitOrRestart() // Modification of method declaration recommended: Add return value and parameters
                                // If there are rules and constraints on allowed secrets (e.g. no digits), check them in here
    {
        // Variable declarations allowed here
        // Console.Write() etc. allowed here!
    }
 
    static void HangTheMan() // Modification of method declaration recommended: Add return value and parameters
                             // In here, clear the screen and redraw everything reflecting the actual game status
    {
        // Variable declarations allowed here
        // all Console.Write() etc. go here
    }
}

NODISP:

Template (mit Top-Level Statements)

// TEMPLATE FOR TOP-LEVEL STATEMENTS
 
// Variable declarations allowed here
 
while (true)                     // The game repeats until finished by player 1
{
    // Variable declarations allowed here
    ReadSecretWord();            // Player 1: Enter the secret word to be guessed by player 2
    HangTheMan();                // Screen output for a good start
    while (true)                 // Player 2: Make your guesses
    {
        ReadOneChar();           // Handle input of one char. 
        EvaluateTheSituation();  // Game Logic goes here
        HangTheMan();            // Screen output goes here
    }
    QuitOrRestart();             // Ask if want to quit or start new game
}
 
void ReadSecretWord() // Modification of method declaration recommended: Add return value and parameters
                      // If there are rules and constraints on allowed secrets (e.g. no digits), check them in here
{
    // Variable declarations allowed here
    // Console.Write() etc. allowed here!
}
 
void ReadOneChar() // Modification of method declaration recommended: Add return value and parameters
                   // If there are rules and constraints on allowed secrets (e.g. no digits), make sure the input is allowed
{
    // Variable declarations allowed here
    // Console.Write() etc. allowed here!
}
 
void EvaluateTheSituation() // Modification of method declaration recommended: Add return value and parameters
                            // In here, evaluate the char entered: Is it part of the secret word?
                            // Calculate and return the game status (Hit or missed? Where? List and number of missed chars?...)
{
    // Variable declarations allowed here
    // NO Console.Write() etc. in here!
}
 
void QuitOrRestart() // Modification of method declaration recommended: Add return value and parameters
                     // If there are rules and constraints on allowed secrets (e.g. no digits), check them in here
{
    // Variable declarations allowed here
    // Console.Write() etc. allowed here!
}
 
void HangTheMan() // Modification of method declaration recommended: Add return value and parameters
                  // In here, clear the screen and redraw everything reflecting the actual game status
{
    // Variable declarations allowed here
    // all Console.Write() etc. go here
}

Checklist

Checklist Hangman

Mein Code beinhaltet keine globalen Variablen. Ich habe also keine Variablen ausserhalb der Main-Methode deklariert (dort wo steht 'No variable declarations in this area!!').
Model vs. View I: In meiner gesamten Main-Methode gibt es keinen einzigen Console-Befehl (Console.WriteLine(), Console.ReadLine(), Console.ReadKey(), ... diese gehören nur in die View-Funktionen).
Model vs. View II: Auch in der anderen Funktion, die zum Model gehört - EvaluateTheSituation() - gibt es keinen einzigen Console-Befehl.
In meinem Code gibt es keine unnötigen Abhängigkeiten: Alle Grössen, die mehrfach verwendet werden, werden genau 1x deklariert. Zum Beispiel wird das Array mit den erlaubten Buchstaben nur in Main() deklariert und dann den anderen Funktionen, falls benötigt, als Argument übergeben.
Funktionen sollen minimalen Zugriff auf Variablen haben: Funktionen sollen nur diejenigen Variablen übergeben werden, die sie auch tatsächlich benötigen. Zum Beispiel sollte der Funktion ReadOneChar(...) die Anzahl Fehlversuche oder verbleibende Leben nicht übergeben werden (falls man eine solche hat), da diese irrelevant für die Funktion ist.
Alle Variablen haben sinnvolle Variablennamen, unter denen man sich etwas vorstellen kann. Tipp: Kann eine Variable mit F2 einfach umbenennen.

Grafische Darstellung

Die Anzahl Versuche soll durch den hänging Man graphisch dargestellt werden. Achtung: Falls dir das zu makaber ist, kannst du auch eine fröhlichere Zeichnung anfertigen. Mögliche Alternativen:

Schneemann
Rackete
Blume

HangMan:

Definiere dazu eine Funktion, die die Anzahl Versuche entgegen nimmt und die zugehörige Grafik in die Konsole schreibt:
1. 0 - nur Galgen
2. 1 - Kopf
3. 2 - Kopf, Oberkörper
4. 3 - Kopf, Oberkörper, ein Bein
5. 4 - Kopf, Oberkörper, beide Beine
6. 5 - Kopf, Oberkörper, beide Beine, ein Arm
7. 6 - HangMan
Verbessere und fine-tune nun dein Spiel so, dass es gut funktioniert und hübsch aussieht.

NODISP

ALTE VERSION

Version 1: Basics

Eine Person soll das Wort, welches der Spieler erraten soll, eingeben. Natürlich soll dieses in einer Variablen gespeichert werden.
Zeige nun mithilfe von Underlines _ an, aus wie vielen Buchstaben das gesuchte Wort besteht.
Der Spieler soll nun Buchstaben raten und eingeben. Kommt ein Buchstabe im gesuchten Wort vor, so wird der entsprechende Underline ersetzt. Tipp: Verwende char c = Console.ReadKey().KeyChar; um einzelne Buchstaben einzugeben, ohne Enter drücken zu müssen.
Gross- und Kleinschreibweise soll keine Rolle spielen.
Sobald das gesamte Wort erraten wurde, wird dem Spieler gratuliert.

Version 2: Gameplay

Zähle mit, wie viele Versuche der Spieler braucht. Teile dem Spieler am Schluss die Anzahl Versuche mit.
Lege eine maximale Anzahl versuche fest. Benötigt der Spieler zu viele Versuche, soll Game Over ausgegeben werden.
Gibt der Spieler einen Buchstaben erneut ein, soll der Versuch ignoriert werden und nicht als Fehlversuch zählen.

Version 3: Grafische Darstellung

Ziel ist nun, dass die Anzahl Versuche durch den hänging Man graphisch dargestellt werden.

Definiere dazu eine Funktion, die die Anzahl Versuche entgegen nimmt und die zugehörige Grafik in die Konsole schreibt:
1. 0 - nur Galgen
2. 1 - Kopf
3. 2 - Kopf, Oberkörper
4. 3 - Kopf, Oberkörper, ein Bein
5. 4 - Kopf, Oberkörper, beide Beine
6. 5 - Kopf, Oberkörper, beide Beine, ein Arm
7. 6 - HangMan
Verbessere und fine-tune nun dein Spiel so, dass es gut funktioniert und hübsch aussieht.

(optional) Version 4: OOP

Nur für Fortgeschrittene mit Vorwissen in OOP

Programmiere Hangman mit OOP.
Implementiere mindestens zwei Klassen:
- Spielelogik
- Ausgabe
Schreibe nach jeder Runde für die Ausgabe nicht den ganzen Bildschirm neu, sondern immer nur die Zeichen, die sich tatsächlich ändern.
Der letzte angefügte Körperteile soll jeweils in einer anderen Farbe angezeigt werden.
Die Klassen dürfen statisch sein.
Eingabe und Programmfluss können direkt in Main() liegen.