Skip to content

README.md

Latest commit

 

History

History
61 lines (43 loc) · 2.08 KB

README.md

File metadata and controls

61 lines (43 loc) · 2.08 KB

📄🛳️ Paper Battleship

Paper Battleship is a Java-based networked version of the classic Battleship game, built using socket programming. It simulates the nostalgic feel of the paper-based game, now with two players connecting over a network and taking turns to attack each other's grid.

🎯 Features

  • Two-player turn-based gameplay over a network
  • Server-client architecture using Java Sockets
  • Console-based grid interaction
  • Hit/miss feedback and ship sinking notification
  • Simple and minimalistic design for learning and fun

🔧 Objective

The core game logic is already implemented, but you are free to modify or extend it as needed. Your main tasks are to:

  • Complete the TODOs in the code
  • Set up the network connection
  • (Optionally) Improve or change the existing game logic
  • (Optionally) Changing the network handling logic
  • (Optionally) Considering use of JSON for message format and implementing better connection management between server and socket

🕹️ How to Play

  1. Start the Server Run the BattleShipServer on one machine (or the host machine).

  2. Connect Two Clients Run BattleShipClient on two separate terminals or machines. Each player enters the server's IP and port to connect.

  3. Gameplay

    • Each player places their ships (can be manual or random depending on your implementation).
    • Players take turns entering grid coordinates like A3, B7, etc.
    • The game continues until one player sinks all of the opponent’s ships.

image

🚀 Getting Started

Prerequisites

  • Java 8 or higher
  • Terminal or IDE (e.g., IntelliJ, Eclipse)

📁 Project Structure

PaperBattleShip/
├── java/
│   ├── Client/
│   │   ├── BattleShip.java
│   │   ├── BattleShipCell.java
│   │   ├── BattleShipClient.java
│   │   ├── BattleShipClientNetworkHandler.java
│   │   └── utils/
│   │       └── AnsiColor.java
│   └── Server/
│       ├── BattleShipServer.java
│       └── ClientHandler.java