⚓ Multiplayer Battleship Game Server

A high-performance, concurrent backend for the classic Battleship game, engineered with Go (Golang) and WebSockets. This server manages real-time game state, player matchmaking, and turn-based logic with a focus on low latency and thread-safe scalability.

🚀 Features

Real-time Communication: Bi-directional data flow via WebSockets for instantaneous move updates.
Concurrent Session Management: Efficiently handles multiple simultaneous game rooms using Go's lightweight goroutines.
Robust Game Logic: Full implementation of Battleship rules, including ship placement validation, hit/miss tracking, and win conditions.
Event-Driven Architecture: Uses a central hub to broadcast game states and manage player disconnections gracefully.

🛠 Tech Stack

Language: Go (Golang) 1.21+
Networking: Gorilla WebSocket
State Management: Channels & Mutexes for thread-safe memory operations.

🏗 System Architecture

The server operates on a Hub-Client model. The Hub manages the lifecycle of game rooms, while each client represents a unique socket connection.

Key Components:

The Hub: The central "brain" that registers/unregisters players and routes messages to the correct game session.
The Room: Encapsulates the state of a single match between two players.
The Player: Maintains the private game board and ship coordinates, ensuring the opponent cannot "see" ship locations via the API.

🚦 Getting Started

Prerequisites

Backend: Go (Gorilla WebSocket, gRPC)
Networking: WebSockets for real-time updates
Database (Optional): Redis/PostgreSQL for persistence (if needed)
Containerization: Docker (for easy deployment)

Installation & Run

Clone the repository:

git clone [https://github.com/raymondoyondi/Multiplayer-Battleship-Game-Server.git](https://github.com/raymondoyondi/Multiplayer-Battleship-Game-Server.git)
cd Multiplayer-Battleship-Game-Server

Install Dependencies for both client and sever
```
go mod tidy
```
Run the server
```
cd game-severs
make run
```
Run the client
```
cd game-clients
```
then
```
make install
```
run the command to connect to the game server
```
game-client connect 
```

⚙️ How It Works

Players Connect via WebSockets – Clients connect to the server via ws://localhost:8000/ws.
Matchmaking System – Players are matched with opponents automatically.
Game Board Initialization – Each player places ships before the game starts.
Turn-Based Attacks – Players take turns attacking a grid position.
Game State Updates – The server broadcasts updates to both players.
Win Condition – The first player to sink all opponent ships wins.

🤝 Contributing

Fork the repository
Create a feature branch
```
git checkout -b feature-name
```
Commit your changes
```
git commit -m "Add new feature"
```
Push to GitHub
```
git push origin feature-name
```
Create a Pull Request

📄 License

This project is licensed under the MIT License.

raymondoyondi/Multiplayer-Battleship-Game-Server