Code Monkey home page Code Monkey logo

teamabattleshipdotnet's Introduction

Build status

build and test dotnet

Battleship .NET

A simple game of Battleship, written in C# based on .NET 7. The purpose of this repository is to serve as an entry point into coding exercises and it was especially created for scrum.orgs Applying Professional Scrum for Software Development course (www.scrum.org/apssd). The code in this repository is unfinished by design.

Build the application

In the root folder of the application there is a Battleship.sln which can be used to build all projects by executing

dotnet build

Run the application

Running locally

You need to have the .NET 7 runtime installed on your local machine https://www.microsoft.com/net/download

You can now run the game with

dotnet run --project .\Battleship.Ascii\Battleship.Ascii.csproj

```GitPod:
dotnet run --project /workspace/TeamABattleshipDotNet/Battleship.Ascii/Battleship.Ascii.csproj

Running within a docker container

You can easily run the game within a docker container.

Change into the Battleship folder

docker run -it -v ${PWD}:/battleship mcr.microsoft.com/dotnet/sdk:6.0 bash

This starts a new container and maps your current folder on your host machine as the folder battleship in your container and opens a bash console. In bash then change to the folder battleship/Battleship.Ascii and run

dotnet run

Running within a DevContainer

DevContainers are a way to run your development environment inside of an Docker container. The container contains all frameworks, tools etc. to develop and run the application. If you open the folder of this repo in VS Code, it asks if you want to run this insiede a DevContainer. If you agree, VS Code will run inside this container with the needed extensions and frameworks.

See Developing inside a Container for more information on local container development with VS Code.

Prerequisites:

  • Docker
  • Visual Studio Code

Running within GitHub CodeSpaces

You can also use GitHub CodeSpaces to run the development environment completely in a browser.

See Introduction to CodeSpaces for more information about using GitHub Codespaces.

Execute Tests

You can run tests on the console by using

dotnet test

If you want to run tests within VSCode, you can install the .NET Core Test Explorer Extension. In this case make sure, you set the Propery "Test Project Path" in the extension setting to this value:

**/*[Test|ATDD]*/*.csproj

Telemetry data

This application is collecting telemetry data with Microsoft Application Insights. For more details see https://docs.microsoft.com/en-us/azure/azure-monitor/app/console.

To send the telemetry data to a specific instance of Application Insights, the connection string has to be adjusted in ApplicationInsights.config.

teamabattleshipdotnet's People

Contributors

tschissler avatar garypedretti avatar omeganot avatar

Stargazers

avatar

Watchers

avatar

teamabattleshipdotnet's Issues

Game does not end

Steps to Reproduce

  1. Start a new game
  2. Hit all the computers ships
  3. The game does not end

Acceptance Criteria

  1. When all ships have been sunk, the player sees a message saying, "You are the winner!" or "You lost!"
  2. The game shall end as soon as a player has no more ships left that are not sunk.

Indication when a ship has been sunk

As a player, I want to see which ships of my opponent I have sunk in order to identify which ships I still have to search for.

Acceptance Criteria

  1. Show only ships that have been sunk completely, not which ship was hit
  2. Show me in a way that I can see which ships are left over

Cool Happy Ending

As a player, I want a cool message or something like that when I win the game, so I'm motivated to play the game again.

Acceptance Criteria

  1. The message should be a positive surprise
  2. The message should work on a standard computer and require no special equipment.

Validate ship placement

As a player, I want to make sure that I'm placing all ships according to the rules so that it's a fair game and I can't cheat.

Acceptance Criteria

  1. Ships must not overlap each other
  2. All ships have the correct size
  3. All ships have all positions in a horizontal or vertical row, gaps are not allowed.
  4. If the player tries to set an invalid position, a message appears

Two human players

As a player, I want to be able to play against other players to have fun together

Acceptance Criteria

  1. Each player should be able to play on his computer
  2. Playing against the computer should still be possible
  3. There are always two players
  4. If there are several players on my network, I want to be able to choose who I want to play against

Computer shall place its ships randomly

As a player, I want the computer to place its ships randomly so that I don't know their position after a few games and the game becomes more interesting.

Acceptance Criteria

  1. The ships must be placed differently for each game
  2. The placement must comply with the rules
    • Ships must not cross each other
    • No ships outside the field
    • All ships have the correct size
    • All ships have all positions in a horizontal or vertical row, gaps are not allowed
  3. The player cannot see the positions of the ships of the computer

Make size of the field configurable

As a player, I want to be able to configure the size of the playing field in order to be able to influence the duration of the game.

Acceptance Criteria

  1. Non-square fields should be allowed
  2. Limit board size to 26 in both directions, otherwise the letters are not sufficient
  3. If board is too small to place all ships, a message should be displayed
  4. The computer should also use the new board size for placement and shooting
  5. I should be able to shoot at all configured fields

Computers should shoot smarter

As a player, I want the computer to shoot smarter so that the game becomes more challenging for me.

Acceptance Criteria

  1. Do not shoot at the same position several times
  2. Searching for a hit in adjacent positions instead of shooting at a completely different location
  3. Search for good shot positions based on remaining ships

Make ship positions changeable during placement

As a player, I want to be able to adjust the positions of my ships during the placement so that I can re-arrange them.

Acceptance Criteria

  1. The changed positions must also be valid.
  2. Changes should only be possible if the game has not yet been started.
  3. The position editing process should be intuitive for the player.

Computer should not shoot at the same position multiple times

As a player, I don't want the computer to shoot at the same position several times so that its chances of winning increase and the game becomes more challenging to me.

Acceptance Criteria

  1. The computer should not shoot again at a position it has used before
  2. The computer shall fire on all fields of the playing field

Computer is supposed to search for adjacent positions after a hit

As a player, I want the computer to try to sink my ship after a hit to increase its chances of winning and make the game more challenging for me.

Acceptance Criteria

  1. After a hit, the fields at the top / bottom / left / right of the hit should be fired upon
  2. Immediately after another hit has been made on one of the adjacent fields, the orientation of the ship
    can be detected and this information should be used for the next shot
  3. If no more hits are scored in the ship's direction and the ship is not yet sunk, then continue shooting
    in the other direction from the first hit.
  4. After the ship has been sunk, the next shot position is to be searched randomly on the whole field again
  5. If two ships touch each other, the system must detect this and sink both ships.

Computer shall search for good shooting positions based on the remaining ships

As a player, I want the computer to look for the best possible shot positions to increase its chances of winning and make the game more challenging for me.

Acceptance Criteria

  1. Do not shoot in gaps where there is not enough space for the smallest vessel to be sunk.
  2. Consider gaps in horizontal and vertical direction

Make the game more readable

As a player, I want a clean user interface to help me find my way around.

Acceptance Criteria

  1. Hits and water should be shown in individual colors
  2. A different color for messages
  3. Individual game steps should be grouped visually
  4. The player should be told exactly what the next possible steps are

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.