https://github.com/ruun/battleship

BattleShip Game developed with javaFX. This is for my course: CST8221 Java application programming
https://github.com/ruun/battleship

battleship battleship-game cst cst8221 java javaapplication javafx javafx-games

Last synced: 10 days ago
JSON representation

BattleShip Game developed with javaFX. This is for my course: CST8221 Java application programming

• Host: GitHub
• URL: https://github.com/ruun/battleship
• Owner: Ruun
• Created: 2024-08-19T17:13:17.000Z (5 months ago)
• Default Branch: main
• Last Pushed: 2025-01-15T00:39:54.000Z (16 days ago)
• Last Synced: 2025-01-15T01:44:51.275Z (16 days ago)
• Topics: battleship, battleship-game, cst, cst8221, java, javaapplication, javafx, javafx-games
• Language: Java
• Homepage:
• Size: 29.9 MB
• Stars: 1
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# BattleShipZ

BattleShipZ is a Battleship game developed using JavaFX. Engage in classic naval warfare with options to play against a bot or another player.

# Screenshots

![Screenshot1](Screenshot1.png)

![Screenshot2](Screenshot2.png)

![Screenshot3](Screenshot3.png)

![Screenshot4](Screenshot4.png)

![Screenshot5](Screenshot5.png)

## Project Features

- **Player vs Bot**: Test your skills against an AI opponent.

- **Player vs Player**: Connect through a server to play against another human player.

- **Swap Button**: Easily switch views between your board and the enemy's board, or modify the layout to display both boards side by side.

- **In-Game Messaging**: Communicate with your opponent during the game.

- **Game Stats**: Track your wins, losses, and other stats.

- **Translation**: Translate between english/french (needs more work)

- **Sound Effects**: Enjoy immersive game sounds, including background music, shooting, misses, wins, and losses.

## How to Run the Game

### Option 1: Run the JAR File

1. **Download the JAR file**:

   - [JAPLabsSwing.jar](https://github.com/Ruun/BattleShip/blob/main/JAPLabsSwing.jar)

3. **Run the JAR file** in your command line:

   ```bash

   java --module-path "/path/to/javafx-sdk-22.0.1/lib" --add-modules javafx.controls,javafx.fxml -jar JAPLabsSwing.jar

   ```

   Replace `/path/to/javafx-sdk-22.0.1/lib` with the actual path to your JavaFX SDK.

### Option 2: Build from Source

1. **Clone the repository**:

   ```bash

   git clone https://github.com/Ruun/BattleShipZ.git

   ```

2. **Navigate to the project directory**:

   ```bash

   cd BattleShipZ

   ```

3. **Use Maven to clean and build the project**:

   ```bash

   mvn clean package

   ```

4. **Run the generated JAR file**:

   ```bash

   java --module-path "/path/to/javafx-sdk-22.0.1/lib" --add-modules javafx.controls,javafx.fxml -jar target/BattleShipZ-1.0-SNAPSHOT.jar

   ```

   Replace `/path/to/javafx-sdk-22.0.1/lib` with the actual path to your JavaFX SDK.

## Credits

The server-side implementation is largely based on [this repository](https://github.com/JMazur121/Battleship).