Battleships-engine NPM

Battleship Engine

This TypeScript package is a core engine for implementing the classic game of Battleship. It allows for the creation of game boards, the placement of ships, and tracking of hits and misses, as well as determining when a player has lost.

For the React version of the engine, check out Battleship Engine for React, which provides the same functionality via a React hook.

Features

Create and manage a game board.
Place ships randomly or manually.
Track hits, misses, and sunken ships.
Detect when a player has lost the game.

Installation

To install the package, run:

npm install battleship-ts-engine

Usage

Importing

You can import the necessary classes and types from the package:

import { GameBoard, TCoords, ShipType, Direction } from "battleships-engine";

Example

Creating a Game Board

You can create a new game board, either with predefined ships or by randomly placing them:

const gameBoard = new GameBoard();
gameBoard.randomlyPlaceShips();

Placing a Ship Manually

gameBoard.placeShip({
    type: "battleship",
    coords: { x: 3, y: 5 },
    direction: "hor", // horizontal
});

Receiving an Attack

gameBoard.receiveAttack({ x: 3, y: 5 });

Checking if a Player has Lost

if (gameBoard.hasLost()) {
    console.log("You have lost the game!");
}

API Reference

`GameBoard`

The GameBoard class is responsible for managing the state of the game board, including ships, hits, and misses.

ships: Map<ShipType, Ship>: A map containing the ships on the board.
takenCells: Map<string, ShipType>: A map of all cells occupied by ships.
missed: Map<string, boolean>: A map of all missed attacks.

Methods:

randomlyPlaceShips(): Randomly places ships on the game board.
placeShip(params: { type: ShipType; coords: TCoords; direction: Direction }): Places a ship on the game board at specific coordinates and direction.
receiveAttack(coords: TCoords): Processes an attack at the given coordinates.
hasLost(): Returns true if all ships are sunk.