In diesem Kapitel wirst du deine Fähigkeiten in der Entwicklung von Konsolenanwendungen erweitern, indem wir gemeinsam eine spannende Zahlenraten-Spiel-App erstellen. Dieses interaktive Spiel fordert die Spieler heraus, ihre Intuition zu nutzen, indem sie eine zufällig generierte Zahl innerhalb eines vorgegebenen Bereichs erraten. Dabei werden wir grundlegende Konzepte wie

• Zufallszahlengenerierung,
• Eingabevalidierung,
• Benutzerinteraktion,
• sowie das Speichern von Spielergebnissen in einer Datei kennenlernen.

Herausforderung

Stell dir vor, du tauchst in eine App ein, die Spannung und Neugier verspricht. Die Spieler sind eingeladen, eine geheimnisvoll ausgewählte Zahl innerhalb eines vorgegebenen Bereichs zu erraten. Die App gibt sofortiges Feedback zu jedem Versuch und führt eine genaue Zählung der abgegebenen Tipps.

Dieses praxisnahe Beispiel bietet die Möglichkeit, die Fähigkeiten im Bau von CLI-Apps zu verfeinern und zeigt, wie interaktive Programme gestaltet werden können.

Ergebnis-App

Erlebe die Anwendung in Aktion! Unten findest du ein GIF, das die spannende Zahlenraten-Spiel-App zeigt, die du erstellen wirst:

Entwicklung einer Konsolenanwendung für ein Ratespiel

Es stehen zwei Wege zur Auswahl. Die erste Option lädt dazu ein, die Reise ohne Unterstützung zu beginnen, während die zweite einen hilfreichen Leitfaden bietet, um den Erfolg sicherzustellen. Egal, ob du mutig eintauchst oder dem strukturierten Leitfaden folgst, erwartet dich ein faszinierendes Erlebnis, das mit einer funktionalen und fesselnden Konsolenanwendung endet.

Masterplan

• Schritt 1: Einrichtung und Initialisierungen;
• Schritt 2: Definition der Spielparameter;
• Schritt 3: Definition von Hilfsfunktionen;
• Schritt 4: Spiellogik;
• Schritt 5: Speichern des Spielergebnisses;
• Schritt 6: Spielstart;
• Fazit;
• Vollständiger App-Code.

Schritt 1: Einrichtung und Initialisierungen

Bereite die Arbeitsumgebung vor, indem du ein neues Verzeichnis und eine Datei namens app.js erstellst. In dieser Datei binden wir die benötigten Module ein:

const readline = require('readline');
const fs = require('fs').promises;

Erstellen einer Readline-Schnittstelle:

const rl = readline.createInterface({
  input: process.stdin,
  output: process.stdout
});

Erläuterung: Die erforderlichen Module werden importiert: readline für die Benutzerinteraktion und fs.promises für Dateioperationen. Anschließend wird eine Readline-Schnittstelle mit dem Namen rl erstellt, um Eingaben und Ausgaben zu verwalten.

Schritt 2: Spielparameter festlegen

Festlegen der minimalen und maximalen Zahlen:

const minNumber = 1;
const maxNumber = 100;

Das Geheimzahl generieren:

const secretNumber =
  Math.floor(Math.random() * (maxNumber - minNumber + 1)) + minNumber;

Initialisierung des Versuchszählers:

let attempts = 0;

Erläuterung: Der Zahlenbereich (minNumber und maxNumber), in dem die geheime Zahl generiert wird, wird definiert. Die geheime Zahl wird zufällig mit Math.random() erzeugt und der Variable secretNumber zugewiesen. Die Variable attempts wird initialisiert, um die Versuche des Benutzers zu zählen.

Schritt 3: Hilfsfunktionen definieren

Ausstattung mit einer Hilfsfunktion für eine einwandfreie Validierung:

function isValidGuess(guess) {
  return !isNaN(guess)
    && guess >= minNumber
    && guess <= maxNumber;
}

Erläuterung: Die Funktion isValidGuess prüft, ob die Eingabe des Benutzers eine gültige Zahl innerhalb des angegebenen Bereichs (minNumber bis maxNumber) ist.

Schritt 4: Spiellogik

Die Kernmechanik des Spiels über die Funktion playGame:

function playGame() {
  rl.question(`Guess a number between ${minNumber} and ${maxNumber}: `, guess => {
    if (isValidGuess(guess)) {
      attempts++;
      const guessNumber = parseInt(guess);

      if (guessNumber === secretNumber) {
        console.log(`Congratulations! You guessed the number in ${attempts} attempts.`);
        saveGameResult(`Player won in ${attempts} attempts.`);
        rl.close();
      } else if (guessNumber < secretNumber) {
        console.log('Try higher.');
        playGame();
      } else {
        console.log('Try lower.');
        playGame();
      }
    } else {
      console.log('Please enter a valid number within the specified range.');
      playGame();
    }
  });
}

Erläuterung: Die Funktion playGame bildet die zentrale Spielschleife. Sie verwendet rl.question, um den Benutzer nach einer Schätzung zu fragen. Ist die Eingabe gültig, prüft die Funktion, ob die Schätzung mit der geheimen Zahl übereinstimmt. Andernfalls gibt sie dem Benutzer eine Rückmeldung und setzt die Spielschleife rekursiv fort.

Schritt 5: Spielergebnis speichern

Implementierung der Logik zum Speichern der Spielerfolge des Benutzers in der Datei game_results.txt.

async function saveGameResult(result) {
  try {
    await fs.appendFile('game_results.txt', `${result}\n`);
    console.log('Game result saved.');
  } catch (err) {
    console.log('Failed to save game result.');
  }
}

Erläuterung: Die Funktion saveGameResult verwendet fs.promises, um das Spielergebnis an eine Datei namens game_results.txt anzuhängen. Sie gibt eine Rückmeldung über den Erfolg oder Misserfolg beim Speichern des Ergebnisses.

Schritt 6: Spiel starten

Begrüßungsnachricht erstellen und das Spiel starten:

console.log('Welcome to the Guess the Number game!');
playGame();

Erläuterung: Es wird eine Begrüßungsnachricht angezeigt und die Spielschleife durch Aufruf der Funktion playGame gestartet.

Vollständiger App-Code

const readline = require("readline");
const fs = require("fs").promises;

const rl = readline.createInterface({
  input: process.stdin,
  output: process.stdout,
});

const minNumber = 1;
const maxNumber = 100;

const secretNumber =
  Math.floor(Math.random() * (maxNumber - minNumber + 1)) + minNumber;
let attempts = 0;

function isValidGuess(guess) {
  return !isNaN(guess) && guess >= minNumber && guess <= maxNumber;
}

function playGame() {
  rl.question(
    `Guess a number between ${minNumber} and ${maxNumber}: `,
    (guess) => {
      if (isValidGuess(guess)) {
        attempts++;
        const guessNumber = parseInt(guess);

        if (guessNumber === secretNumber) {
          console.log(
            `Congratulations! You guessed the number in ${attempts} attempts.`
          );
          saveGameResult(`Player won in ${attempts} attempts.`);
          rl.close();
        } else if (guessNumber < secretNumber) {
          console.log("Try higher.");
          playGame();
        } else {
          console.log("Try lower.");
          playGame();
        }
      } else {
        console.log("Please enter a valid number within the specified range.");
        playGame();
      }
    }
  );
}

async function saveGameResult(result) {
  try {
    await fs.appendFile("game_results.txt", `${result}\n`);
    console.log("Game result saved.");
  } catch (err) {
    console.log("Failed to save game result.");
  }
}

console.log("Welcome to the Guess the Number game!");
playGame();