Skip to content

Amey-Thakur/HANGMAN-WORD-GAME

Repository files navigation

Hangman Word Game

License Status Java JDK 8 Developed by Amey Thakur and Mega Satish

A classic graphical Hangman game developed as a 3rd-Semester Mini-Project for the Object-Oriented Programming Methodology (Java) course. This implementation showcases fundamental OOP principles, graphical rendering using Java AWT/Swing, and event-driven interaction.

Project Presentation  ·  Source Code  ·  Technical Specification  ·  Video Demo  ·  Live Demo

Demo


Authors  ·  Overview  ·  Features  ·  Structure  ·  Quick Start  ·  Results  ·  Usage Guidelines  ·  License  ·  About  ·  Acknowledgments


Authors

Terna Engineering College | Computer Engineering | Batch of 2022

Amey Thakur
Amey Thakur

ORCID
Mega Satish
Mega Satish

ORCID

Important

🤝🏻 Special Acknowledgement

Special thanks to Mega Satish for her meaningful contributions, guidance, and support that helped shape this work.


Overview

A classic Hangman Word Game developed as a Semester III Mini-Project for the Object-Oriented Programming Methodology (OOPM) Lab at Terna Engineering College. The application challenges users to guess hidden words character by character within a limited number of attempts. It leverages Java JDK 8 for robust backend logic, utilizing core Object-Oriented Programming principles like inheritance and encapsulation to structure the game's components effectively. This project serves as a practical milestone in mastering Java syntax and graphical interface design during the academic journey of 2018-2022.

Note

Research Impact: The source code, presentation, and project report are published on ResearchGate.

Resources

# Resource Description
1 Presentation Research paper presentation and visuals
2 Technical Specification Technical architecture and logic specification
3 Source Code Original source code publication
4 Game Repository Standalone repository for the game
5 OOPM Laboratory Academic repository for Java OOPM

Features

Feature Description
Graphical Interface Visual representation of gallows and hangman
Word Database Predefined list of programming languages to guess
Interactive Controls Mouse support for logic and keyboard for guessing
Win/Loss States Clear visual feedback for game outcomes
Animations Simple animation for the "hanging" sequence
Wasm Deployment Integrated CheerpJ v3 for modern browser execution

Tech Stack

  • Language: Java JDK 8
  • UI Framework: Java AWT / Swing (Applet)
  • Web Runtime: CheerpJ v3 (JVM to WebAssembly)
  • Deployment: GitHub Actions & GitHub Pages

Project Structure

HANGMAN-WORD-GAME/
│
├── docs/                                    # Formal Documentation
│   └── SPECIFICATION.md                     # Technical Architecture & Specification
│
├── Mini-Project/                            # Academic Documentation & Results
│   ├── README.md                            # Mini-Project Overview
│   ├── WordGame.pdf                         # Technical Project Report
│   └── WordGame.pptx                        # Technical Presentation
│
├── Mega/                                    # Archival Attribution Assets
│   ├── Filly.jpg                            # Companion (Filly)
│   └── Mega.png                             # Author Profile Image (Mega Satish)
│
├── Source Code/                             # Core Implementation
│   └── Mega.java                            # Main Game Logic (Applet)
│
├── .gitattributes                           # Git Configuration
├── .gitignore                               # Git Ignore Rules
├── CITATION.cff                             # Citation Metadata
├── codemeta.json                            # Project Metadata (JSON-LD)
├── LICENSE                                  # MIT License
├── README.md                                # Main Documentation
└── SECURITY.md                              # Security Policy & Posture

Quick Start

Prerequisites

  • Java Development Kit (JDK 8) is required for Applet support.
  • AppletViewer or a compatible browser plugin.

Warning

Legacy Technology Implementation

As Java Applets are deprecated in modern browser environments, this project is primarily intended to be executed via the appletviewer utility included in the JDK. Attempts to run this in modern browsers (Chrome, Firefox, etc.) will fail without specialized legacy plugins.

Installation & Execution

  1. Clone the Repository

    git clone https://github.com/Amey-Thakur/HANGMAN-WORD-GAME.git
    cd "HANGMAN-WORD-GAME"
  2. Compile the Main Class Navigate to the source directory and compile:

    cd "Source Code"
    javac Mega.java
  3. Run the Application Use appletviewer with a simple HTML entry point. Create a file named index.html in the same folder:

    <!-- index.html -->
    <applet code="Mega.class" width="1000" height="625"></applet>

    Execute using the following command:

    appletviewer index.html

Tip

Modern Browser-Based Web Execution (Recommended)

Experience the high-fidelity graphical simulation of the Hangman Word Game directly in any modern web browser, powered by advanced CheerpJ v3 JVM-to-WebAssembly technology.

Launch Live Hangman Web Demo


Results Gallery

Welcome Message

Welcome Message

Instructions Message

Instructions Message

Hint Message

Hint Message

Player Name Input

Player Name Input

Game Screen

Game Screen

Input Window

Input Window

Input Answer

Input Answer

Missed 1

Missed 1

Missed 2

Missed 2

Missed 3

Missed 3

Missed 4

Missed 4

Missed 5

Missed 5

Missed 6

Missed 6

Hanging Animation - Phase 1

Missed 7.1

Hanging Animation - Phase 2

Missed 7.2

Hanging Animation - Phase 3

Missed 7.3

Win (Game Screen)

Win

Win (Input Window)

Input Win

Lose

Lose

Usage Guidelines

This repository is openly shared to support learning and knowledge exchange across the academic community.

For Students
Use this mini-project as a reference for understanding Java Applets, AWT/Swing GUI development, and object-oriented game logic. The source code is documented to facilitate self-paced learning and exploration of graphical programming concepts.

For Educators
This project may serve as a practical example or supplementary teaching resource for Object-Oriented Programming Methodology courses (CSL304). Attribution is appreciated when utilizing content.

For Researchers
The documentation and organization provide insights into academic project curation and educational software structuring.


License

This repository and all linked academic content are made available under the MIT License. See the LICENSE file for complete terms.

Note

Summary: You are free to share and adapt this content for any purpose, even commercially, as long as you provide appropriate attribution to the original author.

Copyright © 2020 Amey Thakur, Mega Satish


About This Repository

Created & Maintained by: Amey Thakur & Mega Satish
Academic Journey: Bachelor of Engineering in Computer Engineering (2018-2022)
Institution: Terna Engineering College, Navi Mumbai
University: University of Mumbai

This project features the Hangman Word Game, a graphical Java application developed as a 3rd-semester mini-project for the Object-Oriented Programming Methodology (OOPM) course. It showcases the practical application of core Java concepts, graphics programming, and user-centric design.

Connect: GitHub  ·  LinkedIn  ·  ORCID

Acknowledgments

Grateful acknowledgment to Mega Satish for her exceptional collaboration and scholarly partnership during the development of this project. Her constant support, technical clarity, and dedication to software quality were instrumental in achieving the project's functional objectives. Learning alongside her was a transformative experience; her thoughtful approach to problem-solving and encouragement turned challenges into meaningful learning moments. This work reflects the growth and insights gained from our side-by-side academic journey. Thank you, Mega, for everything you shared and taught along the way.

Grateful acknowledgment to the faculty members of the Department of Computer Engineering at Terna Engineering College for their guidance and instruction in Object-Oriented Programming Methodology. Their clear teaching and continued support helped me develop a strong understanding of object-oriented principles and Java programming.

Special thanks to the mentors and peers whose encouragement, discussions, and support contributed meaningfully to this learning experience.


↑ Back to Top

Authors  ·  Overview  ·  Features  ·  Structure  ·  Quick Start  ·  Usage Guidelines  ·  License  ·  About  ·  Acknowledgments


🔬 OOPM Laboratory  ·  🎮 HANGMAN-WORD-GAME


Presented as part of the 3rd Semester Mini-Project @ Terna Engineering College


Computer Engineering (B.E.) - University of Mumbai

Semester-wise curriculum, laboratories, projects, and academic notes.