git commit -m "Implement Hangman game using Java and file input"

Author: Dhruv-Cmds

games/HangMan/Main.java

@@ -0,0 +1,149 @@
+package HangMan;
+
+import java.io.BufferedReader;
+import java.io.FileNotFoundException;
+import java.io.FileReader;
+import java.io.IOException;
+import java.util.ArrayList;
+import java.util.Random;
+import java.util.Scanner;
+
+public class Main {
+
+    public static void main(String[] args) {
+
+                // HANG-MAN GAME
+
+        String filePath = "HangMan/words.txt";
+        
+        ArrayList<String> words = new ArrayList<>();
+
+        try(BufferedReader reader = new BufferedReader(new FileReader(filePath))){
+            String line;
+
+            while ((line = reader.readLine()) != null) {
+                words.add(line.trim());
+            }
+        }
+
+        catch(FileNotFoundException e){
+            System.out.println("Could not find file.");
+        }
+
+        catch(IOException e){
+            System.out.println("Something went wrong.");
+        }
+
+        Random random = new Random();
+        String word = words.get(random.nextInt(words.size()));
+
+        Scanner scanner = new Scanner(System.in);
+        
+        ArrayList<Character> wordState = new ArrayList<>();
+        int wrongGuesses = 0;
+
+        for(int i = 0; i < word.length(); i++){
+            wordState.add('_');
+        }
+        
+        System.out.println("-------------------");
+        System.out.println("Welcome to Hangman!");
+        System.out.println("-------------------");
+
+        while (wrongGuesses < 6){
+
+            System.out.println(getHangmanArt(wrongGuesses));
+            
+            System.out.print("Word: ");
+    
+            for(char c : wordState){
+                System.out.print(c + " ");
+            }
+
+            System.out.println();
+    
+            System.out.print("Guess a letter: ");
+            char guess = scanner.next().toLowerCase().charAt(0);
+    
+            if(word.indexOf(guess) >= 0){
+                System.out.println("Correct guess!");
+    
+                for(int i = 0; i < word.length(); i++){
+                    if(word.charAt(i) == guess){
+                        wordState.set(i, guess);
+                    }
+                }
+
+                if(!wordState.contains('_')){
+                    
+                    System.out.println(getHangmanArt(wrongGuesses));
+                    System.out.println("You WIN!");
+                    System.out.println("The word was: " + word);
+                    break;
+                }
+            }
+
+            else{
+                wrongGuesses++;
+                System.out.println("Wrong guess!");
+            }
+        }
+
+        if(wrongGuesses >= 6){
+
+            System.out.println(getHangmanArt(wrongGuesses));
+            System.out.println("Game OVER!");
+            System.out.println("The word was: " + word);
+        }
+
+        scanner.close();
+    }
+
+    static String getHangmanArt(int wrongGuesses){
+
+        return switch(wrongGuesses){
+
+            case 0 -> """
+                       
+
+
+                      """;
+
+            case 1 -> """
+                       o
+
+
+                      """;
+
+            case 2 -> """
+                       o
+                       |
+
+                      """;
+
+            case 3 -> """
+                       o
+                      /|
+
+                      """;
+
+            case 4 -> """
+                       o
+                      /|\\
+
+                      """;
+            case 5 -> """
+                       o
+                      /|\\
+                      /
+                      """;
+            case 6 -> """
+                       o
+                      /|\\
+                      / \\
+                      """;
+                      
+            default -> "";
+        };
+    }
+}

games/HangMan/README.md

@@ -0,0 +1,84 @@
+# 🎮 Hangman Game (Java)
+
+A simple console-based **Hangman game** written in Java.  
+The program randomly selects a word from a file and allows the player to guess letters with a limited number of mistakes.
+
+This project focuses on:
+
+- File handling
+- Collections
+- Control flow
+- Basic game logic
+- Clean console interaction
+
+---
+
+## 📌 Features
+
+- Reads words from an external text file (`words.txt`)
+- Random word selection
+- ASCII-art Hangman display
+- Tracks wrong guesses (up to 6)
+- Win and lose conditions
+- Case-insensitive input
+
+---
+
+## 📂 Project Structure
+
+games/
+├─ HangMan/
+│ ├─ Main.java
+│ └─ words.txt
+└─ README.md
+
+
+---
+
+## ▶️ How to Run
+
+### 1. Compile
+From the **project root directory** (`nuke2`):
+
+```bash
+javac HangMan/Main.java
+java HangMan.Main
+
+📄 words.txt Format:-
+
+- Place words.txt inside the HangMan folder
+- One word per line
+- No special formatting required
+
+Example:-
+apple
+orange
+.
+.
+.
+.
+
+🧠 How the Game Works:-
+
+- The program loads words from words.txt
+- A random word is selected
+- The player guesses one letter at a time
+- Correct guesses reveal letters
+- Incorrect guesses add to the hangman
+- The game ends when:
+- The word is fully guessed (Win)
+- 6 wrong guesses are made (Game Over)
+
+⚠️ Notes:-
+
+- The program uses relative file paths
+- words.txt must exist and must not be empty
+- Java searches for files relative to where the program is executed, not where the class is located
+
+🛠️ Technologies Used:-
+
+- Java
+- ArrayList
+- Random
+- Scanner
+- BufferedReader

games/HangMan/words.txt

@@ -0,0 +1,8 @@
+apple
+orange
+grapes
+banana
+coconut
+pineapple
+lime
+lemon