blame: README.md

# blockattack-game ![Build status](https://github.com/blockattack/blockattack-game/actions/workflows/main.yml/badge.svg) [![Codacy Badge](https://app.codacy.com/project/badge/Grade/044d09ab34be4a1fa93e31d9585adacf)](https://www.codacy.com/gh/blockattack/blockattack-game/dashboard?utm_source=github.com&utm_medium=referral&utm_content=blockattack/blockattack-game&utm_campaign=Badge_Grade) [![license](https://img.shields.io/github/license/blockattack/blockattack-game.svg)]()

Block Attack - Rise of the Blocks - the game<br/>

A Tetris Attack Clone under the GPL.

Homepage: <https://blockattack.net><br/>

Source: <https://github.com/blockattack/blockattack-game>

## Screen shot

![Block Attack - Rise of the Blocks](https://blockattack.github.io/images/screenshots/blockattack-2.3.0-3.png "Screen shot")

## Supported OS

### Linux

Recent Linux version. Target is all current Ubuntu Desktop LTS versions (up to 5 years).

### Windoes

Target is all official supported versions of windows for x86-64 that allows manually installed software. Currently Windows 10+.

## Dependencies

* A version of g++ with C++17 support. Tested on g++-11

* libSDL2

* libSDL2_image

* libSDL2_mixer

* libSDL2_ttf

* libphysfs

* libfmt

* libboost (only needed for compiling)

* libboost-program-options

## Building

The only supported build method is using the CMake<br/>

To build do:

```bash

./packdata.sh

cmake .

# or

# cmake -DCMAKE_BUILD_TYPE=Debug .

# or

# cmake -DCMAKE_BUILD_TYPE=Release .

make

```

The result should be in the "Game"-folder. To run

```bash

./Game/blockattack

```

You can also choose to install it with

```bash

sudo make install

```

Windows build uses MXE (mxe.cc) and Docker. See "Building with Docker".

## Building using Docker

As getting a C++ project with many dependencies to compile can be a daunting task then I have provided a couple of Docker images that can perform a build. Both for Windows and Linux.

The project should at all time be able to compile on the oldest and latest supported version of Ubuntu. This is tested with Docker.

On a fresh checkout you can use:

```bash

docker build -f source/misc/docker/Dockerfile.Ubuntu18.04build . -t blockattack_test

```

and

```bash

docker build -f source/misc/docker/Dockerfile.WindoesBuild . -t blockattack_test

```

## Source Structure

This project is a bit unconventional because I didn't know any better at the time.

* Game - The output is placed here

* man - The manual file and the script to generate it. May be moved to source/misc at some point

* source/code/ - The source code

* source/code/Libs - External libs that are compiled into the project because they are either header only (Cereal) or not designed for use as a shared library.

* source/code/sago - Source code. Not designed to be specific to Block Attack - Rise of the Blocks

* source/assets - Source for the assets if relevant. For instance svg source for the graphics.

* source/misc - Misc stuff. Code related tool that are used for development but not part of the final product.

* source/misc/astyle - Helper script that enforces code style using the "astyle"-program

* source/misc/docker - Docker files used by Travis CI  (but can just as well be used for local testing and release builds)

* source/misc/embedded_libs - Contains dependencies not present on all supported systems

* source/misc/icons - Icons for the installer

* source/misc/screenshots - Screen shots like the one in this README file.

* source/misc/translation - Translations and related tools and scripts

* windows installer - Information needed to Windows installer. May be moved to source/misc at some point

## Reporting bugs

Please report bugs on github: <https://github.com/blockattack/blockattack-game/issues>

If possible: Check if the bug is already fixed in master. But if you don't know how to check it then just report it.

## Contributions

Contributions are welcome. See CONTRIBUTING.md for details.