Skip to content

umbio/JvMines

Repository files navigation

JVMines

License: MIT Java Version Status

A Java implementation of the classic Minesweeper game, originally developed as a Java applet in 1997.

⚠️ Historical Archive Notice

This is a preserved historical artifact from 1997 containing original Java applet source code. It is maintained as a retro computing archive for educational and nostalgic purposes. Java applets are no longer supported in modern browsers, and this code reflects Java language conventions and practices from that era.

Overview

JVMines is a nostalgic recreation of the Microsoft Minesweeper game concept, implemented in Java. The project features a fully functional Minesweeper game with:

  • Customizable grid dimensions and mine counts
  • Interactive cell-based gameplay
  • Visual feedback with images and digital displays
  • Support for flagging suspected mines
  • Timer functionality
  • Custom button and display components

Project Structure

  • jvmines.java - Main applet class and game interface
  • mines.java - Game logic and playground management
  • cell.java - Individual cell/button implementation
  • custombutton.java - Custom button component with image support
  • digitaldisplay.java - Digital display component for score/timer
  • java.html - HTML wrapper for the applet

Game Rules

  1. The playground is filled with mines hidden beneath cells
  2. Click on a cell to reveal it
  3. Numbers indicate how many mines are adjacent to that cell
  4. Right-click to flag cells you suspect contain mines
  5. Reveal all non-mine cells to win
  6. Hitting a mine ends the game

Technical Details

  • Language: Java
  • Type: Java Applet
  • Target: Java 1.1+ compatible browsers
  • Created: April 1997
  • Original Author: umbio

How to Compile

javac *.java

How to Run

The game is designed to run as a Java applet. Include the HTML file in a web page or use an applet viewer:

appletviewer java.html

Components

Cell

A clickable cell that can display an image and respond to mouse events. Supports enabled/disabled states and dynamic image updates.

Mines

Core game logic engine that:

  • Generates the game playground with specified dimensions
  • Places mines randomly
  • Calculates adjacent mine counts
  • Tracks visited cells and game state

Digital Display

A seven-segment style digital display component for showing game statistics (mine count, timer).

Custom Button

A button component with image support for custom visual representation.

Original Source Information

Written by umbio in Messina, Italy (1997)

The original concept is based on Microsoft's Minesweeper game.

License

See LICENSE file for details.

Contributing

See CONTRIBUTING.md for contribution guidelines.

About

A nostalgic recreation of the Microsoft Minesweeper game concept.

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors