From 0657bc9b25ab83799eeb3939464c0e1a9a3ff1cd Mon Sep 17 00:00:00 2001
From: zulianc <julien.chataigner@etu.univ-lyon1.fr>
Date: Tue, 25 Feb 2025 12:07:16 +0100
Subject: [PATCH] initial commit

---
 .gitignore                    |  16 ++
 doc/class_diagramm_core.png   | Bin 0 -> 120647 bytes
 doc/class_diagramm_pieces.png | Bin 0 -> 46659 bytes
 doc/game_logic.md             |  67 +++++++
 doc/pieces_representation.md  | 108 ++++++++++
 doc/pieces_storage.md         |  20 ++
 src/Core/Action.h             |  18 ++
 src/Core/Bag.cpp              |  50 +++++
 src/Core/Bag.h                |  39 ++++
 src/Core/Board.cpp            | 117 +++++++++++
 src/Core/Board.h              |  63 ++++++
 src/Core/Game.cpp             | 300 ++++++++++++++++++++++++++++
 src/Core/Game.h               | 124 ++++++++++++
 src/Core/GameBoard.cpp        | 360 ++++++++++++++++++++++++++++++++++
 src/Core/GameBoard.h          | 126 ++++++++++++
 src/Core/GameParameters.cpp   | 237 ++++++++++++++++++++++
 src/Core/GameParameters.h     | 110 +++++++++++
 src/Core/Gamemode.h           |  12 ++
 src/Core/LineClear.h          |  11 ++
 src/Core/Player.cpp           |  49 +++++
 src/Core/Player.h             |  48 +++++
 src/Core/main.cpp             | 165 ++++++++++++++++
 src/Pieces/Cell.h             |  66 +++++++
 src/Pieces/Color.h            |  40 ++++
 src/Pieces/Generator.cpp      |  85 ++++++++
 src/Pieces/Generator.h        |  39 ++++
 src/Pieces/Piece.cpp          |  38 ++++
 src/Pieces/Piece.h            |  48 +++++
 src/Pieces/PiecesFiles.cpp    | 141 +++++++++++++
 src/Pieces/PiecesFiles.h      |  37 ++++
 src/Pieces/Polyomino.cpp      | 322 ++++++++++++++++++++++++++++++
 src/Pieces/Polyomino.h        | 108 ++++++++++
 src/Pieces/Rotation.h         |  28 +++
 xmake.lua                     |  77 ++++++++
 34 files changed, 3069 insertions(+)
 create mode 100644 .gitignore
 create mode 100644 doc/class_diagramm_core.png
 create mode 100644 doc/class_diagramm_pieces.png
 create mode 100644 doc/game_logic.md
 create mode 100644 doc/pieces_representation.md
 create mode 100644 doc/pieces_storage.md
 create mode 100644 src/Core/Action.h
 create mode 100644 src/Core/Bag.cpp
 create mode 100644 src/Core/Bag.h
 create mode 100644 src/Core/Board.cpp
 create mode 100644 src/Core/Board.h
 create mode 100644 src/Core/Game.cpp
 create mode 100644 src/Core/Game.h
 create mode 100644 src/Core/GameBoard.cpp
 create mode 100644 src/Core/GameBoard.h
 create mode 100644 src/Core/GameParameters.cpp
 create mode 100644 src/Core/GameParameters.h
 create mode 100644 src/Core/Gamemode.h
 create mode 100644 src/Core/LineClear.h
 create mode 100644 src/Core/Player.cpp
 create mode 100644 src/Core/Player.h
 create mode 100644 src/Core/main.cpp
 create mode 100644 src/Pieces/Cell.h
 create mode 100644 src/Pieces/Color.h
 create mode 100644 src/Pieces/Generator.cpp
 create mode 100644 src/Pieces/Generator.h
 create mode 100644 src/Pieces/Piece.cpp
 create mode 100644 src/Pieces/Piece.h
 create mode 100644 src/Pieces/PiecesFiles.cpp
 create mode 100644 src/Pieces/PiecesFiles.h
 create mode 100644 src/Pieces/Polyomino.cpp
 create mode 100644 src/Pieces/Polyomino.h
 create mode 100644 src/Pieces/Rotation.h
 create mode 100644 xmake.lua

diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000..ec7dd87
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1,16 @@
+# Xmake cache
+.xmake/
+build/
+
+# MacOS Cache
+.DS_Store
+
+# VSCode
+.vscode/
+
+# personnal documentation
+doc/*.txt
+doc/*.violet.html
+
+# pieces files
+data/pieces/*.bin
diff --git a/doc/class_diagramm_core.png b/doc/class_diagramm_core.png
new file mode 100644
index 0000000000000000000000000000000000000000..1e9e8e7c23a374c79bf90fa2430757306539f873
GIT binary patch
literal 120647
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

literal 0
HcmV?d00001

diff --git a/doc/class_diagramm_pieces.png b/doc/class_diagramm_pieces.png
new file mode 100644
index 0000000000000000000000000000000000000000..a965a8c96bce277e183636dfd0afcbb2e9d4558c
GIT binary patch
literal 46659
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
OlDzbhgGmQYUHo5rC21D`

literal 0
HcmV?d00001

diff --git a/doc/game_logic.md b/doc/game_logic.md
new file mode 100644
index 0000000..b788fb9
--- /dev/null
+++ b/doc/game_logic.md
@@ -0,0 +1,67 @@
+# Game logic
+
+This section will detail how the player's action are interpreted into the game.  
+We will only talk about pieces and not polyominos. In this project, pieces are an abstraction of a polyomino. Though if you want to know more the polyominos in this project, check [this other file](Pieces_representation.md).
+
+## Order of operations
+
+Each frame, the UI will translate the user's input into a series of action to apply to the game. The list of action is the following:
+
+- Pause
+- Retry
+- Hold
+- Move left
+- Move right
+- Rotate clockwise (CW)
+- Rotate 180°
+- Rotate counter-clockwise (CCW)
+- Soft drop
+- Hard drop
+
+Pausing and retrying are managed by the UI.  
+IHS and IRS are always tested first (see the [leniency mechanics section](./game_logic.md#leniency-mechanics)).  
+Then the rest of actions will be tested in the list's order. 
+Finally, gravity and lock delay are applied last.  
+Moving and soft dropping can be held but hard dropping, holding and rotating needs to be released and pressed again to happen.
+
+## Leniency mechanics
+
+In a general sense, we try to be kind to the players. Some of the following mechanics are just standards in a lot of stacker games, while other have been added because of this game using polyominos of high sizes and thus being way harder to play.
+
+When a piece touches the ground, there is a short time period before she automatically locks. This period is called _lock delay_. Lock delay is reset everytime the piece move. To not allow for infinite stalling, there is another longer period called _forced lock delay_ that does not reset when moving the piece.  
+The player as a hold box in which they can temporarly store a piece. In this game, we allow the player to swap between the held piece and the active piece as much as they want. Once again to not allow for infinite stalling, forced lock delay does not reset when holding a piece.
+
+If either holding or rotating happens during frames where no piece is in the board, they will be memorized and immediately applied upon spawning the next piece. This can sometime prevent the player from loosing when the default spawn would have lost the game. This is called IRS and IHS, for Instant Rotation/Hold System.  
+IRS and IHS will fail if they actually loose the player the game when it would have not happened otherwise. In the same sense, holding always fails if it would loose the game.
+
+## Kicking pieces
+
+A common mechanic of stacker games is kicking. This happen when rotating a piece makes it collide with a wall. The game will try to move the piece in a few predetermined spot close to the current position until one of them allow the piece to not be in a wall again. If no positions allow for that, the rotation is simply cancelled.
+
+This concept works very well for games with up to tetrominos or pentominos, but when using polyominos of any size we can't choose a few predetermined spots for each piece.
+
+Since this game uses polyomino of high sizes which are very unplayable, we will try to be complaisant to the player and allow as much kicking spots as possible, while trying not to make him feel like the piece is going through walls. To solve this problem, this game introduce a new Rotation System called **AutoRS**, which does not have a predetermined list of spots to fit the piece but instead adapt to its shape. Its algorithm goes as follow:
+
+1. Before rotating, mark every cell containing the piece or touching the piece, we will call the set of all theses cells the ``safeCells``
+2. Rotate the piece, if it fit stop the algorithm
+3. Try fitting the piece, going from the center to the sides, that means we try to move the piece 1 cell right, then 1 cell left, then 2 cell right, etc. until it fit (and then stop the algorithm), if at one point a position doesn't touch one of the ``safeCells`` we stop trying in this direction
+4. Move the piece one line down, and repeat step 3 again, until we hit a line were the first position (shifted by 0 cells horizontally) touched none of the ``safeCells``
+5. Do the same as step 4 but now we move the piece one line up every time
+6. Cancel the rotation
+
+## Detecting spins
+
+Another common mechanic of stacker games that goes alongside kicking is spinning. A spin is a special move (a move is calculated once a piece has been locked to the board) which usually happen when the last move a piece did was a kick or a rotation and the piece is locked in place, but the rules varies a lot from game to game. 
+
+Since we deal with a great deal of different size and shapes, the rules for spin dectection have been simplified greatly:
+
+- A move is a _spin_ if the piece is locked in place, that is it can't be moved one cell up, down, left or right without hitting a wall
+- A move is a _mini spin_ if the move isn't a spin and the last action of the piece was a kick (dropping down because of gravity counts as an action)
+
+## Score calculation
+
+- For every cell soft dropped, add 1 to the score
+- For every cell hard dropped, add 2 to the score
+- When clearing one line, add 100 to the score, 200 for 2 lines, 400 for 3 lines, 800 for 4 lines, 1600 for 5 lines, etc.
+- If the line clear is a spin, count the score like a normal clear of 2x more line (200 for 1-line spin, 800 for 2, 3200 for 3, etc.)
+- When performing a spin, a mini spin, or clearing 4 or more lines, B2B is activated, every subsequent line clear that is a spin, a mini spin, or clear 4 or more lines, scores twice as much
diff --git a/doc/pieces_representation.md b/doc/pieces_representation.md
new file mode 100644
index 0000000..b31f4c4
--- /dev/null
+++ b/doc/pieces_representation.md
@@ -0,0 +1,108 @@
+# Pieces representation
+
+## What are polyominos ?
+
+In this game, pieces are represented as a polyomino with a color.  
+Polyominos are mathematical objects consisting of multiple edge-touching squares.
+There must be a path from every cell to every other cell, going from square to square only through the sides and not the corners.  
+Polyominos can be classified in 3 ways:
+
+- Fixed polyominos : only translation is allowed
+- One-sided polyominos : only translation and rotation are allowed
+- Free polyomins : translation, rotation, and reflection are allowed
+
+For more detailed informations about polyominos, check the [Wikipedia page](https://en.wikipedia.org/wiki/Polyomino).
+
+Most stacker game uses one-sided polyominos, which results in 7 polyominos of size 4, also known as tetrominos.
+In this game too, one-sided polyominos will be used since we will only allow to move and rotate the pieces.  
+
+Internally, Polyominos are represented as a set of Cell.
+This means the cells can be in any order but can't be duplicates.  
+A cell is simply a position on a 2D grid, so a polyomino is determined by the position of its cells.
+This means however that 2 polyominos of same shape but different positions will be interpreted as different polyominos.
+To solve this, we normalize the position of the polyominos so that their left-most column is at x=0 and their bottom-most row at y=0.
+
+Even if there is only 7 one-sided 4-minos, there is already more than 9,000 one-sided 10-minos.
+Since the aim of this game is to be playable with polyominos of any size, listing all polyominos manually isn't viable.
+We will need a way to:
+
+1. Generate all one-sided polyominos of size n
+2. Set their spawn positions and rotation centers
+
+Aditionally, for this game we will also a want a way to separate the polyominos into multiple categories, specifically to allow removing those with holes who are more unplayable.
+
+##  Ordering the polyominos
+
+For practical reasons, we want to be able to sort all polyominos of the same size.
+This is done very simply:
+
+- If one polyomino has an inferior length than another, it is deemed inferior
+- If two polyomino have the same length, we check all the cells of their square, from left to right, and repeating from up to bottom, for the first position where a polyomino has a cell that another doesn't, the polyomino with the cell is deemed inferior
+
+Once the polyomino are ordered, it is very simple to attribute them a color, we can simply iterate through the list while looping over the color list.
+
+## 1. Generating polyominos
+
+The method used to generate polyominos is similar to the [inductive method](https://en.wikipedia.org/wiki/Polyomino#Inductive_algorithms) described in the previously mentionned Wikipedia page.
+
+The algorithm is the following:
+
+1. Add a single cell at position (0,0), and number it with 0
+2. Call the generator function
+    1. If we get a polyomino of the size we want:
+        1. We rotate it in its 4 possible rotations and sort them
+        2. If the polyomino was generated in its lowest rotation, we add it to the list, else we discard it
+        3. Stop this instance of the function (the function is recursive, see step 2.3.2)
+    2. Else we number each adjacent cell to the polyomino with a number higher than the last numbered cell, unless:
+        1. If a cell was already numbered then we don't touch it
+        2. If a cell is on top of the polyomino then we don't number it
+        3. If a cell is below y=0, or at exactly x=0 and y<0, then we don't number it
+    3. For each cell with a higher number than the last added one:
+        1. We add this cell to the polyomino
+        2. We call the generator function (recursive function!)
+        3. We remove this cell from the polyomino
+3. Return the list of polyominos
+
+The exact number of one-sided polyominos up to size 12 (and higher, but we only generated up to size 12) is known, and this method generated exactly theses numbers, without duplicates.
+
+By marking cells and adding only ones that have a higher number than the last one everytime, we generate each fixed polyomino exactly n times. By ignoring the cells below y=0, or at exactly x=0 and y<0, we generate each fixed polyomino exactly 1 time.  
+An one-sided polyomino has 4 rotations, some of which can be the same if the polyomino has symmetries. 2 rotations that are the same corresponds to 1 fixed polyomino, we will refer to theses 2 rotation as 1 "unique" rotation.  
+Because we generate every fixed polyomino exactly 1 time, that means each "unique" rotation of an one-sided polyomino is generated exactly one-time, which includes its lowest rotation. That's how we can get away with only checking the rotation of the polyomino and not comparing it to the rest of the generated polyominos.
+
+## 2. Setting the spawn position of polyominos
+
+When a polyomino is created, an attribute named its length is computed. This is simply the max between its width and its height. Thus the polyomino can be inscribed in a square of size ``length``.  
+So now we can assume the polyomino is always inscribed in a square of origin (0,0) and size ``length`` (which should always be the case under normal circumstances). This make the rotation center very easy to find as it is simply the center of this square, and rotating is as simple as rotating a matrix:
+
+- Clockwise (CW) rotation : ``x, y = y, (length - 1) - x``
+- 180° rotation : ``x, y = (length - 1) - x, (length - 1) - y``
+- Counter-clockwise (CCW) rotation : ``x, y = (length - 1) - y, x``
+
+_Note we set the origin at the bottom-left corner instead of the up-left corner in a matrix, so the formulae aren't exactly the same._
+
+The second challenge comes in finding a normalized spawn position for pieces. To do this, we first need to find which rotation the piece needs to spawn on, and then center it in the middle of its square.  
+For the rotation, **we want to find the side which is both the widest and the flattest**.  
+**Widest** means that we prefer if the piece is oriented horizontally rather than vertically.  
+**Flattest** means we prefer the side with the most cell at the bottom of the piece.  
+The current algorithm for doing so is the following:
+
+1. Check if the polyomino has more lines horizontally or vertically, this will determine either 2 or 4 sides which are widest than the others, and the others will be discarded
+2. For each potential side check the number of cell on the first line, if one has more than every others, then this side is choosed, else we only keep the sides that tied and repeat for the next line
+3. If we still have at least 2 sides tied, we do the same again but check the flatness of the side to the left instead, this will make the pieces overall have more cells to their left at spawn
+4. If there is still no winner, we sort the remaining sides (by simulating having them selectionned and then sort the resulting polyominos) and keep the lowest
+5. We rotate the piece so that the chosen side ends up at the bottom of the polyomino
+6. We center the polyomino inside its square, since we chose the widest side it will always fill the width of the square, but for the height it can be asymmetric, in that case we place it one line closer to the top than the bottom
+
+_Note we could actually just skip straight to step 4 because it always give the same orientation, but we want the spawn rotations to follow somewhat of a logic. Step 1 to 3 actually already works for 99% of polyominos and they constrain step 4 too by preselecting certain sides._
+
+## 3. Separating the polyominos into categories
+
+For this game, we want the polyominos to be broken down into 3 categories:
+
+- Convex: this is said of a polyomino where every row and column is formed of at most one continous line of cells
+- Holeless: the polyominos which are neither convex nor have a hole
+- Others: the polyominos who have a hole (thoses are by definition not convex)
+
+To check for convexity, we simply iterate trough each row and column, and check cell by cell if they are all contiguous.
+
+To check for holes, we list every empty cells starting from the exterior of the square of the polyomino, then add every adjacent empty cell recursively. If the cell has an hole then there is at least one empty cell we could not attaign, and since we know the size of the square and of the polyomino, we can compute wheter we have the right number of empty cells.
diff --git a/doc/pieces_storage.md b/doc/pieces_storage.md
new file mode 100644
index 0000000..fc2536b
--- /dev/null
+++ b/doc/pieces_storage.md
@@ -0,0 +1,20 @@
+# Pieces storage
+
+## What is stored
+
+If you don't know what a polyomino is, check [this other file](Pieces_representation.md#what-are-polyominos).
+
+Generating polyominos of size n is exponential in regard to n. Because of this, we will store the pieces beforehand and load them upon launching the game.
+
+We want the pieces to be always sorted in the same order, always attributed the same color, and always set at the same spawn position, no matter how they were generated. We also want them to be separated in 3 categories : convex, not convex but wihtout a hole, and with a hole. Theses problematics are already resolved internally, but will be calculated before storage as to not need extra calculcations upon load.
+
+## How is it stored
+
+Pieces are stored in binary files. Each file simply contains every polyomino of one size, one after the other. Since each file contains all polyominos of the same size, we know how much stuff to read and don't need delimiters. We know we've read all pieces simply when we reach the end of file character.
+
+Each piece is stored as follows:
+- 1 byte for the length of the piece
+- 1 byte for the other characteristics of the piece: ``ABCCCCCC`` where A indicates if the piece is convex, B indicates if it has a hole, and C is the color number of the piece
+- 1 byte for each cell: ``XXXXYYYY`` where X is the x coordinate of the cell and Y is the y coordinate of the cell
+
+The current implementation only allows to generate polyominos up to size 16, but can be upgraded by storing coordinates on 8 bits instead of 4. It has been choosen to use pieces only up to size 15 for this game.
diff --git a/src/Core/Action.h b/src/Core/Action.h
new file mode 100644
index 0000000..7b4acb2
--- /dev/null
+++ b/src/Core/Action.h
@@ -0,0 +1,18 @@
+#pragma once
+
+
+/**
+ * The list of actions that can be taken by the player
+ */
+enum Action {
+    PAUSE,
+    RETRY,
+    HOLD,
+    SOFT_DROP,
+    HARD_DROP,
+    MOVE_LEFT,
+    MOVE_RIGHT,
+    ROTATE_CW,
+    ROTATE_180,
+    ROTATE_CCW
+};
diff --git a/src/Core/Bag.cpp b/src/Core/Bag.cpp
new file mode 100644
index 0000000..8704595
--- /dev/null
+++ b/src/Core/Bag.cpp
@@ -0,0 +1,50 @@
+#include "Bag.h"
+
+#include "../Pieces/Piece.h"
+
+#include <Vector>
+#include <cstdlib>
+
+
+Bag::Bag(const std::vector<Piece>& pieces) : pieces(pieces) {
+    // initialize bags
+    this->currentBag.clear();
+    for (int i = 0; i < this->pieces.size(); i++) {
+        this->currentBag.push_back(i);
+    }
+    this->nextBag.clear();
+
+    // prepare first piece
+    this->prepareNext();
+}
+
+Piece Bag::lookNext() {
+    // return the next piece
+    return this->pieces.at(this->next);
+}
+
+Piece Bag::getNext() {
+    // get the piece to return
+    int nextIndex = this->next;
+
+    // prepare the piece even after the next
+    this->prepareNext();
+
+    // return the next piece
+    return this->pieces.at(nextIndex);
+}
+
+void Bag::prepareNext() {
+    // if the bag is empty switch to the next bag
+    if (this->currentBag.empty()) {
+        std::swap(this->currentBag, this->nextBag);
+    }
+
+    // pick a random piece from the current bag
+    int indexIndex = std::rand() % this->currentBag.size();
+    this->next = this->currentBag.at(indexIndex);
+
+    // move the piece over to the next bag
+    this->nextBag.push_back(this->next);
+    this->currentBag.erase(this->currentBag.begin() + indexIndex);
+}
diff --git a/src/Core/Bag.h b/src/Core/Bag.h
new file mode 100644
index 0000000..bd8fc38
--- /dev/null
+++ b/src/Core/Bag.h
@@ -0,0 +1,39 @@
+#pragma once
+
+#include "../Pieces/Piece.h"
+
+#include <Vector>
+
+
+/**
+ * A litteral bag of pieces, in which you take each of its piece randomly one by one then start again with a new bag
+ */
+class Bag {
+    private:
+        std::vector<Piece> pieces; // the pieces the bag can dispense
+        int next; // the next piece to give
+        std::vector<int> currentBag; // the list of pieces that are still to be taken out before starting a new bag
+        std::vector<int> nextBag; // the list of pieces that have been taken out of the current bag and have been placed in the next
+    
+    public:
+        /**
+         * Creates a new bag of the specified list of pieces
+         */
+        Bag(const std::vector<Piece>& pieces);
+
+        /**
+         * Looks at what the next picked piece will be
+         */
+        Piece lookNext();
+
+        /**
+         * Picks a new piece from the current bag
+         */
+        Piece getNext();
+
+    private:
+        /**
+         * Prepare the next picked piece in advance
+         */
+        void prepareNext();
+};
diff --git a/src/Core/Board.cpp b/src/Core/Board.cpp
new file mode 100644
index 0000000..c217f9e
--- /dev/null
+++ b/src/Core/Board.cpp
@@ -0,0 +1,117 @@
+#include "Board.h"
+
+#include "../Pieces/Piece.h"
+
+#include <Vector>
+#include <Set>
+#include <iostream>
+
+
+Board::Board(int width, int height) : width(width), height(height) {
+    std::vector<Color> emptyRow;
+    for (int i = 0; i < width; i ++) {
+        emptyRow.push_back(NOTHING);
+    }
+    
+    // initialize grid
+    this->grid.clear();
+    for (int j = 0; j < height; j++) {
+        this->grid.push_back(emptyRow);
+    }
+}
+
+void Board::addBlock(const Cell& position, Color block) {
+    // if the block is out of bounds we discard it
+    if (position.x < 0 || position.x >= this->width || position.y < 0) return;
+
+    // resize the grid if needed
+    if (position.y >= this->grid.size()) {
+        std::vector<Color> emptyRow;
+        for (int i = 0; i < width; i ++) {
+            emptyRow.push_back(NOTHING);
+        }
+        for (int j = this->grid.size(); j <= position.y; j++) {
+            this->grid.push_back(emptyRow);
+        }
+    }
+    
+    // change the block in the grid
+    this->grid.at(position.y).at(position.x) = block;
+}
+
+int Board::clearRows() {
+    std::vector<Color> emptyRow;
+    for (int i = 0; i < width; i ++) {
+        emptyRow.push_back(NOTHING);
+    }
+
+    // check from top to bottom
+    int clearedLines = 0;
+    for (int j = this->grid.size() - 1; j >= 0; j--) {
+        // check if a line has a block on every column
+        bool isFull = true;
+        for (int i = 0; i < this->width; i++) {
+            if (this->grid.at(j).at(i) == NOTHING) {
+                isFull = false;
+            }
+        }
+
+        // if it has, erase it and add a new row at the top
+        if (isFull) {
+            this->grid.erase(this->grid.begin() + j);
+            if(this->grid.size() < height) this->grid.push_back(emptyRow);
+            clearedLines++;
+        }
+    }
+
+    return clearedLines;
+}
+
+Color Board::getBlock(const Cell& position) const {
+    // if the block is out of bounds
+    if (position.x < 0 || position.x >= this->width || position.y < 0) return OUT_OF_BOUND;
+
+    // if the block is higher than the current grid, since it can grow indefinitely we do as if it was there but empty
+    if (position.y >= this->grid.size()) return NOTHING;
+
+    // else get the color in the grid
+    return this->grid.at(position.y).at(position.x);
+}
+
+std::vector<std::vector<Color>> Board::getBlocks() const {
+    return this->grid;
+}
+
+int Board::getGridHeight() const {
+    return this->grid.size();
+}
+
+int Board::getBaseHeight() const {
+    return this->height;
+}
+
+int Board::getWidth() const {
+    return this->width;
+}
+
+std::ostream& operator<<(std::ostream& os, const Board& board) {
+    // print the board
+    for (int y = board.grid.size() - 1; y >= 0; y--) {
+        for (int x = 0; x < board.width; x++) {
+            Color block = board.grid.at(y).at(x);
+            os << COLOR_CODES[block];
+            if (block != NOTHING) {
+                os << "*";
+            }
+            else {
+                os << "-";
+            }
+        }
+        os << std::endl;
+    }
+
+    // reset console color
+    os << COLOR_RESET;
+    
+    return os;
+}
diff --git a/src/Core/Board.h b/src/Core/Board.h
new file mode 100644
index 0000000..1723827
--- /dev/null
+++ b/src/Core/Board.h
@@ -0,0 +1,63 @@
+#pragma once
+
+#include "../Pieces/Piece.h"
+
+#include <Vector>
+#include <iostream>
+
+
+/**
+ * A 2D grid of blocks
+ */
+class Board {
+    private:
+        std::vector<std::vector<Color>> grid; // the grid, (0,0) is downleft
+        int width; // the width of the grid
+        int height; // the base height of the grid, which can extends indefinitely
+
+    public:
+        /**
+         * Creates a new board of the specified size
+         */
+        Board(int width, int height);
+
+        /**
+         * Change the color of the specified block, if the block is out of bounds it is simply ignored
+         */
+        void addBlock(const Cell& position, Color block);
+
+        /**
+         * Clears any complete row and moves down the rows on top, returns the number of cleared rows
+         */
+        int clearRows();
+
+        /**
+         * Returns the color of the block at the specified position
+         */
+        Color getBlock(const Cell& position) const;
+
+        /**
+         * Returns a copy of the grid
+         */
+        std::vector<std::vector<Color>> getBlocks() const;
+
+        /**
+         * Returns the actual height of the grid
+         */
+        int getGridHeight() const;
+
+        /**
+         * Returns the base height of the grid
+         */
+        int getBaseHeight() const;
+        
+        /**
+         * Returns the width of the grid
+         */
+        int getWidth() const;
+
+        /**
+         * Stream output operator, adds a 2D grid representing the board
+         */
+        friend std::ostream& operator<<(std::ostream& os, const Board& board);
+};
diff --git a/src/Core/Game.cpp b/src/Core/Game.cpp
new file mode 100644
index 0000000..c0cabca
--- /dev/null
+++ b/src/Core/Game.cpp
@@ -0,0 +1,300 @@
+#include "Game.h"
+
+#include "GameBoard.h"
+#include "GameParameters.h"
+#include "Action.h"
+
+#include <Vector>
+
+static const int SUBPX_PER_ROW = 60; // the number of position the active piece can take "between" two rows
+static const int SOFT_DROP_SCORE = 1; // the score gained by line soft dropped
+static const int HARD_DROP_SCORE = 2; // the score gained by line hard dropped
+static const int LINE_CLEAR_BASE_SCORE = 100; // the score value of clearing a single line
+static const int B2B_SCORE_MULTIPLIER = 2; // by how much havaing B2B on multiplies the score of the line clear
+static const int B2B_MIN_LINE_NUMBER = 4; // the minimum number of lines needed to be cleared at once to gain B2B (without a spin)
+
+
+Game::Game(Gamemode gamemode, const Player& controls, int boardWidth, int boardHeight, const std::vector<Piece>& bag) : parameters(gamemode, controls), board(boardWidth, boardHeight, bag, parameters.getNextQueueLength()) {
+    // the game has not yet started
+    this->started = false;
+    this->lost = false;
+
+    // initialize stats
+    this->score = 0;
+    this->framesPassed = 0;
+    this->B2BChain = 0;
+
+    // nothing happened yet
+    this->heldActions.clear();
+    this->initialActions.clear();
+    this->heldDAS = 0;
+    this->heldARR = 0;
+    this->subVerticalPosition = 0;
+    this->leftARETime = 0;
+    this->totalLockDelay = 0;
+    this->totalForcedLockDelay = 0;
+}
+
+void Game::start() {
+    // starts the game
+    this->started = true;
+    this->lost = this->board.spawnNextPiece();
+}
+
+void Game::nextFrame(const std::set<Action>& playerActions) {
+    if (this->lost || this->hasWon()) return;
+
+    if (this->started) {
+        bool AREJustEnded = (this->leftARETime == 1);
+        if (this->leftARETime > 0) {
+            this->leftARETime--;
+        }
+
+        if (this->leftARETime == 0) {
+            if (AREJustEnded) {
+                this->board.spawnNextPiece();
+            }
+
+            /* IRS and IHS */
+            Rotation initialRotation = NONE
+                + (this->initialActions.contains(ROTATE_CW)) ? CLOCKWISE : NONE
+                + (this->initialActions.contains(ROTATE_180)) ? DOUBLE : NONE
+                + (this->initialActions.contains(ROTATE_CCW)) ? COUNTERCLOCKWISE : NONE;
+
+            if (this->initialActions.contains(HOLD)) {
+                if (this->board.hold(initialRotation)) {
+                    this->subVerticalPosition = 0;
+                    this->totalLockDelay = 0;
+                    this->heldARR = 0;
+                }
+            }
+            else {
+                if (initialRotation != NONE) {
+                    this->board.rotate(initialRotation);  
+                }
+            }
+
+            /* HOLD */
+            if (playerActions.contains(HOLD) && (!this->heldActions.contains(HOLD))) {
+                if (this->board.hold()) {
+                    this->subVerticalPosition = 0;
+                    this->totalLockDelay = 0;
+                    this->heldARR = 0;
+                }
+            }
+
+            /* MOVE LEFT/RIGHT */
+            if (playerActions.contains(MOVE_LEFT)) {
+                this->movePiece(-1, (this->heldDAS >= 0));
+            }
+            if (playerActions.contains(MOVE_RIGHT)) {
+                this->movePiece(1, (this->heldDAS <= 0));
+            }
+            else {
+                this->heldDAS = 0;
+            }
+
+            /* ROTATIONS */
+            if (playerActions.contains(ROTATE_CW) && (!this->heldActions.contains(ROTATE_CW))) {
+                this->board.rotate(CLOCKWISE);
+            }
+            if (playerActions.contains(ROTATE_180) && (!this->heldActions.contains(ROTATE_180))) {
+                this->board.rotate(DOUBLE);
+            }
+            if (playerActions.contains(ROTATE_CCW) && (!this->heldActions.contains(ROTATE_CCW))) {
+                this->board.rotate(COUNTERCLOCKWISE);
+            }
+            
+            /* SOFT DROP */
+            if (playerActions.contains(SOFT_DROP)) {
+                int appliedSDR = this->parameters.getSDR();
+
+                // SDR=0 -> instant drop
+                if (appliedSDR == 0) {
+                    while (this->board.moveDown()) {
+                        this->score += SOFT_DROP_SCORE;
+                    }
+                }
+                // SDR>1 -> move down by specified amount
+                else {
+                    this->subVerticalPosition += (SUBPX_PER_ROW / appliedSDR);
+                    while (this->subVerticalPosition >= SUBPX_PER_ROW) {
+                        this->subVerticalPosition -= SUBPX_PER_ROW;
+                        this->score += (this->board.moveDown() * SOFT_DROP_SCORE);
+                    }
+                }
+            }
+
+            /* HARD DROP */
+            // needs to be done last because we can enter ARE period afterwards
+            if (this->initialActions.contains(HARD_DROP) || (playerActions.contains(HARD_DROP) && (!this->heldActions.contains(HARD_DROP)))) {
+                while (this->board.moveDown()) {
+                    this->score += HARD_DROP_SCORE;
+                }
+                this->lockPiece();
+            }
+            // no need to apply gravity and lock delay if the piece was hard dropped
+            else {
+                /* GRAVITY */
+                // parameters.getGravity() gives the gravity for an assumed 20-line high board
+                int appliedGravity = this->parameters.getGravity() * (this->board.getBoard().getBaseHeight() / 20.0);
+
+                this->subVerticalPosition += appliedGravity;
+                while (this->subVerticalPosition >= SUBPX_PER_ROW) {
+                    this->subVerticalPosition -= SUBPX_PER_ROW;
+                    this->board.moveDown();
+                }
+
+                /* LOCK DELAY */
+                if (this->board.touchesGround()) {
+                    this->totalLockDelay++;
+                    this->totalForcedLockDelay++;
+                }
+                else {
+                    this->totalLockDelay = 0;
+                }
+
+                if ((this->totalLockDelay > this->parameters.getLockDelay()) || (this->totalForcedLockDelay > this->parameters.getForcedLockDelay())) {
+                    this->lockPiece();
+                }
+            }
+
+            // remove initial actions only once they've been applied
+            if (AREJustEnded) {
+                this->initialActions.clear();
+            }
+        }
+
+        this->framesPassed++;
+    }
+    
+    // update remembered actions
+    if ((!this->started) || this->leftARETime > 0) {
+        for (Action action : playerActions) {
+            this->initialActions.insert(action);
+        }
+    }
+
+    this->heldActions = playerActions;
+
+    if (playerActions.contains(MOVE_LEFT)) {
+        this->heldDAS = std::min(-1, this->heldDAS - 1);
+    }
+    if (playerActions.contains(MOVE_RIGHT)) {
+        this->heldDAS = std::max(1, this->heldDAS + 1);
+    }
+    else {
+        this->heldDAS = 0;
+    }
+}
+
+void Game::movePiece(int movement, bool resetDirection) {
+    if (resetDirection) {
+        this->heldDAS = movement;
+        this->heldARR = 0;
+    }
+    else {
+        this->heldDAS += movement;
+    }
+
+    if (abs(this->heldDAS) > this->parameters.getDAS()) {
+        int appliedARR = this->parameters.getARR();
+
+        // ARR=0 -> instant movement
+        if (appliedARR == 0) {
+            if (movement == -1) while (this->board.moveLeft());
+            if (movement == 1) while (this->board.moveRight());
+        }
+        // ARR>1 -> move by specified amount
+        else {
+            this->heldARR++;
+            if (this->heldARR == appliedARR) {
+                this->heldARR = 0;
+                if (movement == -1) this->board.moveLeft();
+                if (movement == 1) this->board.moveRight();
+            }
+        }
+    }
+}
+
+void Game::lockPiece() {
+    LineClear clear = this->board.lockPiece();
+    this->parameters.clearLines(clear.lines);
+
+    // update B2B and score
+    bool B2BConditions = ((clear.lines > B2B_MIN_LINE_NUMBER) || clear.isSpin || clear.isMiniSpin);
+    if (clear.lines > 0) {
+        /* clearing one more line is worth 2x more
+           clearing with a spin is worth as much as clearing 2x more lines */
+        long int clearScore = LINE_CLEAR_BASE_SCORE;
+        clearScore = clearScore << (clear.lines << (clear.isSpin));
+
+        if (this->B2BChain && B2BConditions) clearScore *= B2B_SCORE_MULTIPLIER;
+        this->score += clearScore;
+    }
+    this->B2BChain = B2BConditions;
+    
+    // reset active piece
+    this->subVerticalPosition = 0;
+    this->totalLockDelay = 0;
+    this->totalForcedLockDelay = 0;
+    this->heldARR = 0;
+
+    // check for ARE
+    this->leftARETime = this->parameters.getARE();
+    if (this->leftARETime == 0) {
+        this->board.spawnNextPiece();
+    }
+}
+
+bool Game::hasWon() {
+    return this->parameters.hasWon(this->framesPassed);
+}
+
+bool Game::hasLost() {
+    return this->lost;
+}
+
+int Game::getClearedLines() {
+    return this->parameters.getClearedLines();
+}
+
+int Game::getLevel() {
+    return this->parameters.getLevel();
+}
+
+int Game::getFramesPassed() {
+   return this->framesPassed;
+}
+
+int Game::getScore() {
+    return this->score;
+}
+
+bool Game::isOnB2BChain() {
+    return this->B2BChain;
+}
+
+bool Game::areBlocksBones() {
+    return this->parameters.getBoneBlocks();
+}
+
+Board Game::getBoard() {
+    return this->board.getBoard();
+}
+
+Piece Game::getActivePiece() {
+    return this->board.getActivePiece();
+}
+
+Cell Game::getActivePiecePosition() {
+    return this->board.getActivePiecePosition();
+}
+
+Piece Game::getHeldPiece() {
+    return this->board.getHeldPiece();
+}
+
+std::vector<Piece> Game::getNextPieces() {
+    return this->board.getNextPieces();
+}
diff --git a/src/Core/Game.h b/src/Core/Game.h
new file mode 100644
index 0000000..f710b29
--- /dev/null
+++ b/src/Core/Game.h
@@ -0,0 +1,124 @@
+#pragma once
+
+#include "GameBoard.h"
+#include "GameParameters.h"
+#include "Action.h"
+
+#include <Vector>
+
+
+/**
+ * Interprets the player action into the game, depending on the state of the board and the current gamemode
+ */
+class Game {
+    private:
+        GameParameters parameters; // the current parameters of the game
+        GameBoard board; // the board in which the game is played
+        bool started; // wheter the game has started
+        bool lost; // wheter the game is lost
+        long int score; // the current score
+        int framesPassed; // how many frames have passed since the start of the game
+        bool B2BChain; // wheter the player is currently on a B2B chain
+        std::set<Action> heldActions; // the list of actions that were pressed last frame
+        std::set<Action> initialActions; // the list of actions that have been pressed while there was no active piece
+        int heldDAS; // the number of frames DAS has been held, positive for right or negative for left
+        int heldARR; // the number of frames ARR has been held
+        int subVerticalPosition; // how far the active piece is to go down one line
+        int leftARETime; // how many frames are left before ARE period finishes
+        int totalLockDelay; // how many frames has the active piece touched the ground without moving
+        int totalForcedLockDelay; // how many frames the active piece has touched the ground since the last spawned piece
+    
+    public:
+        /**
+         * Initialize the parameters and creates a new board
+         */
+        Game(Gamemode gamemode, const Player& controls, int boardWidth, int boardHeight, const std::vector<Piece>& bag);
+
+        /**
+         * Starts the game
+         */
+        void start();
+
+        /**
+         * Advance to the next frame while excecuting the actions taken by the player,
+         * this is where the main game logic takes place
+         */
+        void nextFrame(const std::set<Action>& playerActions);
+
+    private:
+        /**
+         * Move the piece in the specified direction
+         */
+        void movePiece(int movement, bool resetDirection);
+
+        /**
+         * Locks the piece, updates level and score and spawn the next piece if necessary
+         */
+        void lockPiece();
+
+    public:
+        /**
+         * Returns wheter the player has won
+         */
+        bool hasWon();
+
+        /**
+         * Returns wheter the player has lost
+         */
+        bool hasLost();
+
+        /**
+         * Returns the current level
+         */
+        int getLevel();
+
+        /**
+         * Returns the current number of cleared lines
+         */
+        int getClearedLines();
+
+        /**
+         * Returns the number of frames passed since the start of the game
+         */
+        int getFramesPassed();
+
+        /**
+         * Returns the current score
+         */
+        int getScore();
+
+        /**
+         * Returns wheter the player is currently on a B2B chain
+         */
+        bool isOnB2BChain();
+
+        /**
+         * Returns wheter all blocks are currently bone blocks
+         */
+        bool areBlocksBones();
+
+        /**
+         * Returns a copy of the board
+         */
+        Board getBoard();
+
+        /**
+         * Returns a copy of the active piece
+         */
+        Piece getActivePiece();
+
+        /**
+         * Returns a copy of the active piece position
+         */
+        Cell getActivePiecePosition();
+
+        /**
+         * Returns a copy of the held piece
+         */
+        Piece getHeldPiece();
+
+        /**
+         * Return a copy of the next pieces queue
+         */
+        std::vector<Piece> getNextPieces();
+};
diff --git a/src/Core/GameBoard.cpp b/src/Core/GameBoard.cpp
new file mode 100644
index 0000000..0122700
--- /dev/null
+++ b/src/Core/GameBoard.cpp
@@ -0,0 +1,360 @@
+#include "GameBoard.h"
+
+#include "../Pieces/Piece.h"
+#include "Board.h"
+#include "Bag.h"
+#include "LineClear.h"
+
+#include <Vector>
+#include <Set>
+#include <memory>
+
+
+GameBoard::GameBoard(int boardWidth, int boardHeight, const std::vector<Piece>& bag, int nextQueueLength) : board(boardWidth, boardHeight), generator(bag), nextQueueLength(nextQueueLength) {
+    // initialize queue
+    this->nextQueue.clear();
+    for (int i = 0; i < nextQueueLength; i++) {
+        this->nextQueue.push_back(this->generator.getNext());
+    }
+}
+
+bool GameBoard::moveLeft() {
+    // check if the piece can be moved one cell left
+    if (this->isActivePieceInWall(Cell{-1, 0})) {
+        return false;
+    }
+    else {
+        this->activePiecePosition.x -= 1;
+        this->isLastMoveKick = false;
+        return true;
+    }
+}
+
+bool GameBoard::moveRight() {
+    // check if the piece can be moved one cell right
+    if (this->isActivePieceInWall(Cell{1, 0})) {
+        return false;
+    }
+    else {
+        this->activePiecePosition.x += 1;
+        this->isLastMoveKick = false;
+        return true;
+    }
+}
+
+bool GameBoard::moveDown() {
+    // check if the piece can be moved one cell down
+    if (this->isActivePieceInWall(Cell{0, -1})) {
+        return false;
+    }
+    else {
+        this->activePiecePosition.y -= 1;
+        this->isLastMoveKick = false;
+        return true;
+    }
+}
+
+bool GameBoard::rotate(Rotation rotation) {
+    // copy the original piece before rotating it
+    Piece stored = *this->activePiece;
+    this->rotate(rotation);
+
+    // check if the piece can rotate
+    if (!this->isActivePieceInWall()) {
+        this->isLastMoveKick = false;
+        return true;
+    }
+
+    // get the list of cells that touches the original piece
+    std::set<Cell> safeCells;
+    for (Cell cell : stored.getPositions()) {
+        Cell cellInGrid(cell + this->activePiecePosition);
+        safeCells.insert(cellInGrid);
+        safeCells.insert(cellInGrid + Cell{0, 1});
+        safeCells.insert(cellInGrid + Cell{1, 0});
+        safeCells.insert(cellInGrid + Cell{0, -1});
+        safeCells.insert(cellInGrid + Cell{-1, 0});
+    }
+
+    // try kicking the piece down
+    bool suceeded = this->tryKicking(true, safeCells);
+    if (suceeded) {
+        this->isLastMoveKick = true;
+        return true;
+    }
+
+    // if it doesn't work try kicking the piece up
+    suceeded = this->tryKicking(false, safeCells);
+    if (suceeded) {
+        this->isLastMoveKick = true;
+        return true;
+    }
+
+    // if it still doesn't work, abort the rotation
+    this->activePiece = std::make_shared<Piece>(stored);
+    return false;
+}
+
+bool GameBoard::tryKicking(bool testingBottom, const std::set<Cell>& safeCells) {
+    // we try from the original height of the piece, moving vertically as long as the kicked piece touches the original
+    bool overlapsVertically = true;
+    int j = 0;
+    do {
+        // we try from the center to the sides as long as the kicked piece touches the original
+        bool overlapsLeft = true;
+        bool overlapsRight = true;
+        int i = 0;
+        do {
+            // check right before right arbitrarly, we don't decide this with rotations since it would still be arbitrary with 180° rotations
+            if (overlapsRight) {
+                Cell shift{+i, j};
+                // the kicked position must touch the original piece
+                if (!this->activePieceOverlapsOneCell(safeCells, shift)) {
+                    overlapsLeft = false;
+                }
+                else {
+                    // if the position is valid we place the active piece there
+                    if (!this->isActivePieceInWall(shift)) {
+                        this->activePiecePosition += shift;
+                        return true;
+                    }
+                }
+            }
+
+            // do the same on the left side
+            if (overlapsLeft) {
+                Cell shift{-i, j};
+                if (!this->activePieceOverlapsOneCell(safeCells, shift)) {
+                    overlapsLeft = false;
+                }
+                else {
+                    if (!this->isActivePieceInWall(shift)) {
+                        this->activePiecePosition += shift;
+                        return true;
+                    }
+                }
+            }
+
+            i++;
+        } while (overlapsLeft && overlapsRight);
+
+        // test if no position touched the original piece
+        if (i == 1) {
+            overlapsVertically = false;
+        }
+
+        // move one line up or down
+        (testingBottom) ? j-- : j++;
+    } while (overlapsVertically);
+
+    return false;
+}
+
+bool GameBoard::hold(Rotation initialRotation) {
+    // swap with held piece
+    std::swap(this->activePiece, this->heldPiece);
+
+    // if it's the first time holding try the next piece
+    bool isFirstTimeHolding = false;
+    if (this->activePiece == nullptr) {
+        isFirstTimeHolding = true;
+
+        // if no pieces in next queue look at what the next would be
+        if (this->nextQueueLength == 0) {
+            this->activePiece = std::make_shared<Piece>(this->generator.lookNext());
+        }
+        else {
+            this->activePiece = std::make_shared<Piece>(this->nextQueue.front());
+        }
+    }
+
+    // set the spawned piece to the correct position
+    this->goToSpawnPosition();
+
+    // apply initial rotation
+    Piece stored = *this->activePiece;
+    this->rotate(initialRotation);
+
+    // if the piece can't spawn, abort initial rotation
+    if (this->isActivePieceInWall()) {
+        this->activePiece = std::make_shared<Piece>(stored);
+        
+        // if the piece still can't spawn, abort holding
+        if (this->isActivePieceInWall()) {
+            if (isFirstTimeHolding) {
+                this->activePiece = nullptr;
+            }
+            std::swap(this->activePiece, this->heldPiece);
+            return false;
+        }
+    }
+
+    // if it's the first time holding, confirm we keep this piece
+    if (isFirstTimeHolding) {
+        if (this->nextQueueLength == 0) {
+            this->generator.getNext();
+        }
+        else {
+            this->spawnNextPiece();
+        }
+    }
+
+    // this piece has done nothing yet
+    this->isLastMoveKick = false;
+
+    return true;
+}
+
+bool GameBoard::spawnNextPiece() {
+    // add a piece to the queue
+    this->nextQueue.push_back(this->generator.getNext());
+
+    // get next piece from queue
+    this->activePiece = std::make_shared<Piece>(this->nextQueue.front());
+    this->nextQueue.erase(this->nextQueue.begin());
+
+    // set the spawned piece to the correct position
+    this->goToSpawnPosition();
+
+    // this piece has done nothing yet
+    this->isLastMoveKick = false;
+
+    // returns wheter the piece can spawn correctly
+    return !this->isActivePieceInWall();
+}
+
+bool GameBoard::touchesGround() {
+    return this->isActivePieceInWall(Cell{0, -1});
+}
+
+LineClear GameBoard::lockPiece() {
+    // check if the piece is locked in place
+    bool isLocked = (this->isActivePieceInWall(Cell{0, 1}) && this->isActivePieceInWall(Cell{1, 0}) &&
+        this->isActivePieceInWall(Cell{-1, 0}) && this->isActivePieceInWall(Cell{0, -1}));
+
+    // put the piece in the board
+    for (Cell cell : this->activePiece->getPositions()) {
+        this->board.addBlock(cell + this->activePiecePosition, this->activePiece->getColor());
+    }
+
+    // check for lines to clear
+    return LineClear{this->board.clearRows(), isLocked, (!isLocked) && this->isLastMoveKick};
+}
+
+Board GameBoard::getBoard() const {
+    return this->board;
+}
+
+Piece GameBoard::getActivePiece() const {
+    return *this->activePiece;
+}
+
+Cell GameBoard::getActivePiecePosition() const {
+    return this->activePiecePosition;
+}
+
+Piece GameBoard::getHeldPiece() const {
+    return *this->heldPiece;
+}
+
+std::vector<Piece> GameBoard::getNextPieces() const {
+    return this->nextQueue;
+}
+
+bool GameBoard::isActivePieceInWall(const Cell& shift) const {
+    // check if every cell of the active piece is in an empty spot
+    for (Cell cell : this->activePiece->getPositions()) {
+        if (this->board.getBlock(cell + this->activePiecePosition + shift) != NOTHING) return true;
+    }
+    return false;
+}
+
+bool GameBoard::activePieceOverlapsOneCell(const std::set<Cell>& safeCells, const Cell& shift) const {
+    // check if one cell of the translated active piece overlaps with one cell of the given piece set
+    for (Cell cell : this->activePiece->getPositions()) {
+        if (safeCells.contains(cell + shift)) return true;
+    }
+    return false;
+}
+
+void GameBoard::goToSpawnPosition() {
+    // get the lowest cell of the piece
+    int lowestCell = this->activePiece->getLength() - 1;
+    for (Cell cell : this->activePiece->getPositions()) {
+        if (cell.y < lowestCell) lowestCell = cell.y;
+    }
+
+    // set the piece one line above the board
+    this->activePiecePosition.y = this->board.getBaseHeight() - lowestCell;
+
+    // center the piece horizontally, biased towards left
+    this->activePiecePosition.x = (this->board.getWidth() - this->activePiece->getLength()) / 2;
+}
+
+std::ostream& operator<<(std::ostream& os, const GameBoard& gameboard) {
+    // print over the board (only the active piece if it is there)
+    if (gameboard.activePiece != nullptr) {
+
+        // change to the color of the active piece
+        Color pieceColor = gameboard.activePiece->getColor();
+        os << COLOR_CODES[pieceColor];
+
+        // print only the cell were the active piece is
+        for (int y = gameboard.activePiecePosition.y + gameboard.activePiece->getLength() - 1; y >= gameboard.board.getBaseHeight(); y--) {
+            for (int x = 0; x < gameboard.board.getWidth(); x++) {
+                bool hasActivePiece = gameboard.activePiece->getPositions().contains(Cell{x, y} - gameboard.activePiecePosition);
+                if (hasActivePiece) {
+                    os << "*";
+                }
+                else {
+                    os << " ";
+                }
+            }
+            os << std::endl;
+        }
+    }
+
+    // print the board
+    Color pieceColor = (gameboard.activePiece == nullptr) ? NOTHING : gameboard.activePiece->getColor();
+    for (int y = gameboard.board.getBaseHeight() - 1; y >= 0; y--) {
+        for (int x = 0; x < gameboard.board.getWidth(); x++) {
+            bool hasActivePiece = (gameboard.activePiece == nullptr) ? false : gameboard.activePiece->getPositions().contains(Cell{x, y} - gameboard.activePiecePosition);
+
+            // if the active piece is on this cell, print it
+            if (hasActivePiece) {
+                os << COLOR_CODES[pieceColor];
+                os << "*";
+            }
+
+            // else print the cell of the board
+            else {
+                Color block = gameboard.board.getBlock(Cell{x, y});
+                os << COLOR_CODES[block];
+                if (block != NOTHING) {
+                    os << "*";
+                }
+                else {
+                    os << "-";
+                }
+            }
+        }
+        os << std::endl;
+    }
+
+    // print held piece
+    os << "Hold:" << std::endl;
+    if (!(gameboard.heldPiece == nullptr)) {
+        os << *gameboard.heldPiece;
+    }
+
+    // print next queue
+    os << "Next:" << std::endl;
+    for (const Piece& piece : gameboard.nextQueue) {
+        os << piece;
+    }
+
+    // reset console color
+    os << COLOR_RESET;
+    
+    return os;
+}
diff --git a/src/Core/GameBoard.h b/src/Core/GameBoard.h
new file mode 100644
index 0000000..85a0f4a
--- /dev/null
+++ b/src/Core/GameBoard.h
@@ -0,0 +1,126 @@
+#pragma once
+
+#include "../Pieces/Piece.h"
+#include "Board.h"
+#include "Bag.h"
+#include "LineClear.h"
+
+#include <Vector>
+#include <memory>
+
+
+/**
+ * Links a board with the pieces moving in it
+ */
+class GameBoard {
+    private:
+        Board board; // the board in which pieces moves, (0, 0) is downleft
+        Bag generator; // the piece generator
+        std::shared_ptr<Piece> activePiece; // the piece currently in the board
+        Cell activePiecePosition; // the position of the piece currently in the board
+        std::shared_ptr<Piece> heldPiece; // a piece being holded
+        int nextQueueLength; // the number of next pieces seeable at a time
+        std::vector<Piece> nextQueue; // the list of the next pieces to spawn in the board
+        bool isLastMoveKick; // wheter the last action the piece did was kicking
+    
+    public:
+        /**
+         * Creates a new board, generator, and next queue
+         */
+        GameBoard(int boardWidth, int boardHeight, const std::vector<Piece>& bag, int nextQueueLength);
+
+        /**
+         * Try moving the piece one cell to the left, and returns wheter it was sucessfull
+         */
+        bool moveLeft();
+
+        /**
+         * Try moving the piece one cell to the right, and returns wheter it was sucessfull
+         */
+        bool moveRight();
+
+        /**
+         * Try moving the piece one cell down, and returns wheter it was sucessfull
+         */
+        bool moveDown();
+
+        /**
+         * Try rotating the piece and kicking it if necessary, and returns wheter it was sucessfull
+         */
+        bool rotate(Rotation rotation);
+    
+    private:
+        /**
+         * Try kicking the piece, testing position either above or below the piece's initial position
+         */
+        bool tryKicking(bool testingBottom, const std::set<Cell>& safeCells);
+
+    public:
+        /**
+         * Try holding the active piece or swapping it if one was already stocked, while trying to apply an initial rotation to the newly spawned piece,
+         * and returns wheter it was sucessfull
+         */
+        bool hold(Rotation initialRotation = NONE);
+
+        /**
+         * Spawns the next piece from the queue, and returns wheter it spawns in a wall
+         */
+        bool spawnNextPiece();
+
+        /**
+         * Returns wheter the active piece is touching walls directly below it
+         */
+        bool touchesGround();
+
+        /**
+         * Lock the active piece into the board and returns the resulting line clear
+         */
+        LineClear lockPiece();
+
+        /**
+         * Returns a copy of the board
+         */
+        Board getBoard() const;
+
+        /**
+         * Returns a copy of the active piece
+         */
+        Piece getActivePiece() const;
+
+        /**
+         * Returns a copy of the position of the active piece
+         */
+        Cell getActivePiecePosition() const;
+
+        /**
+         * Returns a copy of the held piece
+         */
+        Piece getHeldPiece() const;
+
+        /**
+         * Returns a copy of the next piece queue
+         */
+        std::vector<Piece> getNextPieces() const;
+    
+    private:
+        /**
+         * Returns wheter the translated active piece is in a wall
+         */
+        bool isActivePieceInWall(const Cell& shift = Cell{0, 0}) const;
+
+        /**
+         * Returns wheter the translated active piece overlaps with at least one of the cells
+         */
+        bool activePieceOverlapsOneCell(const std::set<Cell>& safeCells, const Cell& shift = Cell{0, 0}) const;
+        
+        /**
+         * Sets the active piece to its spawn position
+         */
+        void goToSpawnPosition();
+    
+    public:
+        /**
+         * Stream output operator, adds the board, the hold box and the next queue
+         */
+        friend std::ostream& operator<<(std::ostream& os, const GameBoard& gameboard);
+};
diff --git a/src/Core/GameParameters.cpp b/src/Core/GameParameters.cpp
new file mode 100644
index 0000000..d489a72
--- /dev/null
+++ b/src/Core/GameParameters.cpp
@@ -0,0 +1,237 @@
+#include "GameParameters.h"
+
+#include "Gamemode.h"
+#include "Player.h"
+
+
+GameParameters::GameParameters(Gamemode gamemode, const Player& controls) : gamemode(gamemode), controls(controls) {
+    // initialize lines and level
+    this->clearedLines = 0;
+    switch (this->gamemode) {
+        // lowest gravity
+        case SPRINT : {this->level = 1; break;}
+        // lowest gravity
+        case ULTRA : {this->level = 1; break;}
+        // goes from level 1 to 20
+        case MARATHON : {this->level = 1; break;}
+        // goes from level 20 to 39
+        case MASTER : {this->level = 20; break;}
+        default : this->level = 1;
+    }
+
+    // initialize stats
+    this->updateStats();
+}
+
+void GameParameters::clearLines(int lineNumber) {
+    // update lines and level
+    switch (this->gamemode) {
+        // modes where level increases
+        case MARATHON :
+        case MASTER : {
+                // update cleared lines
+                int previousLines = this->clearedLines;
+                this->clearedLines += lineNumber;
+
+                // level increments every 10 lines, stats only changes on level up
+                if (previousLines / 10 < this->clearedLines / 10) {
+                    this->level = this->clearedLines / 10;
+                    this->updateStats();
+                }
+                break;
+            }
+        // other modes
+        default : this->clearedLines += lineNumber;
+    }
+}
+
+bool GameParameters::hasWon(int framesPassed) {
+    switch (this->gamemode) {
+        // win once 40 lines have been cleared
+        case SPRINT : return this->clearedLines >= 40;
+        // win once 2mn have passed
+        case ULTRA : return (framesPassed / 60) >= 120;
+        // win once 200 lines have been cleared
+        case MARATHON : return this->clearedLines >= 200;
+        // win once 200 lines have been cleared
+        case MASTER : return this->clearedLines >= 200;
+        default : return false;
+    }
+}
+
+void GameParameters::updateStats() {
+    /* NEXT QUEUE */
+    switch (this->gamemode) {
+        // 5 for rapidity gamemodes
+        case SPRINT : 
+        case ULTRA : {
+                this->nextQueueLength = 5;
+                break;
+            }
+        // 3 for endurance gamemodes
+        case MARATHON :
+        case MASTER : {
+                this->nextQueueLength = 3;
+                break;
+            }
+        default : this->nextQueueLength = 1;
+    }
+
+    /* BONE BLOCKS */
+    switch (this->gamemode) {
+        // blocks turns into bone blocks at level 30
+        case MASTER : this->boneBlocks = (this->level >= 30);
+        default : this->boneBlocks = false;
+    }
+
+    /* GRAVITY */
+    if (level >= 20) {
+        // all levels above 20 are instant gravity
+        this->gravity = 20 * 60;
+    }
+    else {
+        // get gravity for an assumed 20-rows board
+        switch (this->level) {
+            case 1 : {this->gravity = 1; break;} // 60f/line, 20s total
+            case 2 : {this->gravity = 2; break;} // 30f/line, 10s total
+            case 3 : {this->gravity = 3; break;} // 20f/line, 6.66s total
+            case 4 : {this->gravity = 4; break;} // 15f/line, 5s total
+            case 5 : {this->gravity = 5; break;} // 12f/line, 4s total
+            case 6 : {this->gravity = 6; break;} // 10f/line, 3.33 total
+            case 7 : {this->gravity = 7; break;} // 8.57f/line, 2.85s total
+            case 8 : {this->gravity = 8; break;} // 7.5f/line, 2.5s total
+            case 9 : {this->gravity = 10; break;} // 6f/line, 2s total
+            case 10 : {this->gravity = 12; break;} // 5f/line, 1.66s total
+            case 11 : {this->gravity = 14; break;} // 4.28f/line, 1.42s total
+            case 12 : {this->gravity = 17; break;} // 3.52f/line, 1.17s total
+            case 13 : {this->gravity = 20; break;} // 3f/line, 60f total
+            case 14 : {this->gravity = 24; break;} // 2.5f/line, 50f total
+            case 15 : {this->gravity = 30; break;} // 2f/line, 40f total
+            case 16 : {this->gravity = 40; break;} // 1.5f/line, 30f total
+            case 17 : {this->gravity = 1 * 60; break;} // 1line/f, 20f total
+            case 18 : {this->gravity = 2 * 60; break;} // 2line/f, 10f total
+            case 19 : {this->gravity = 4 * 60; break;} // 4line/f, 5f total
+            default : this->gravity = 1;
+        }
+    }
+
+    /* LOCK DELAY */
+    switch (this->gamemode) {
+        // starts at 500ms (30f) at lvl 20 and ends at 183ms (11f) at lvl 39
+        case MASTER : {this->lockDelay = 30 - (this->level - 20); break;}
+        // 1s by default
+        default : this->lockDelay = 60;
+    }
+
+    /* FORCED LOCK DELAY */
+    this->forcedLockDelay = this->lockDelay * 10;
+
+    /* ARE */
+    switch (this->gamemode) {
+        // starts at 400ms (24f) at lvl 1 and ends at 083ms (5f) at lvl 20
+        case MARATHON : {this->ARE = 24 - (this->level - 1); break;}
+        // starts at 400ms (24f) at lvl 20 and ends at 083ms (5f) at lvl 39
+        case MASTER : {this->ARE = 24 - (this->level - 20); break;}
+        // no ARE by default
+        default : this->ARE = 0;
+    }
+
+    /* LINE ARE */
+    this->lineARE = this->ARE * 2;
+
+    /* DAS */
+    this->DAS = this->controls.getDAS();
+    switch (this->gamemode) {
+        // for modes with reduced lock delay, ensure DAS is lower than lock delay, but at least 1
+        case MASTER : {
+                if (this->lockDelay <= this->DAS) {
+                    this->DAS = this->lockDelay - 6; // give 6f (100ms) to change directions
+                }
+                if (this->DAS < 1) {
+                    this->DAS = 1;
+                }
+                break;
+            }
+        // modes with no reduced lock delay
+        default : break;
+    }
+
+    /* ARR */
+    this->ARR = this->controls.getARR();
+    switch (this->gamemode) {
+        // for modes with reduced lock delay, ensure ARR is lower than DAS, but not lower than 1
+        case MASTER : {
+                if (this->DAS <= this->ARR) {
+                    this->ARR = this->DAS - 1;
+                }
+                if (this->ARR < 1) {
+                    this->ARR = 1;
+                }
+                break;
+            }
+        // modes with no reduced lock delay
+        default : break;
+    }
+
+    /* SDR */
+    this->SDR = this->controls.getSDR();
+    switch (this->gamemode) {
+        // modes where we don't want instant soft drop to be possible
+        case MARATHON : {
+            if (this->SDR < 1) {
+                this->SDR = 1;
+            }
+            break;
+        }
+        // modes where we don't care
+        default : break;
+    }
+}
+
+int GameParameters::getClearedLines() {
+    return this->clearedLines;
+}
+
+int GameParameters::getLevel() {
+    return this->level;
+}
+
+int GameParameters::getNextQueueLength() {
+    return this->nextQueueLength;
+}
+
+bool GameParameters::getBoneBlocks() {
+    return this->boneBlocks;
+}
+
+int GameParameters::getGravity() {
+    return this->gravity;
+}
+
+int GameParameters::getLockDelay() {
+    return this->lockDelay;
+}
+
+int GameParameters::getForcedLockDelay() {
+    return this->forcedLockDelay;
+}
+
+int GameParameters::getARE() {
+    return this->ARE;
+}
+
+int GameParameters::getLineARE() {
+    return this->lineARE;
+}
+
+int GameParameters::getDAS() {
+    return this->DAS;
+}
+
+int GameParameters::getARR() {
+    return this->ARR;
+}
+
+int GameParameters::getSDR() {
+    return this->SDR;
+}
diff --git a/src/Core/GameParameters.h b/src/Core/GameParameters.h
new file mode 100644
index 0000000..647cc83
--- /dev/null
+++ b/src/Core/GameParameters.h
@@ -0,0 +1,110 @@
+#pragma once
+
+#include "Gamemode.h"
+#include "Player.h"
+
+
+/**
+ * Computes the parameters of the game depending on the current gamemode and the player's controls,
+ * this is basically where all the hard-coded values are stored
+ */
+class GameParameters {
+    private:
+        Gamemode gamemode; // the current gamemode
+        Player controls; // the player's controls
+        int clearedLines; // the number of cleared lines
+        int level; // the current level
+        int nextQueueLength; // the number of pieces visibles in the next queue
+        bool boneBlocks; // wheter all blocks are bone blocks
+        int gravity; // the gravity at which pieces drop
+        int lockDelay; // the time before the piece lock in place
+        int forcedLockDelay; // the forced time before the piece lock in place
+        int ARE; // the time before the next piece spawn
+        int lineARE; // the time before the next piece spawn, after clearing a line
+        int DAS; // the time before the piece repeats moving
+        int ARR; // the rate at which the piece repeats moving
+        int SDR; // the rate at which the piece soft drops
+
+    public:
+        /**
+         * Sets the current gamemode and the player's controls
+         */
+        GameParameters(Gamemode gamemode, const Player& controls);
+
+        /**
+         * Count the newly cleared lines and update level and stats if needed
+         */
+        void clearLines(int lineNumber);
+
+        /**
+         * Returns wheter the game ended
+         */
+        bool hasWon(int framesPassed);
+
+    private:
+        /**
+         * Updates all the parameters
+         */
+        void updateStats();
+
+    public:
+        /**
+         * Returns the current number of cleared line
+         */
+        int getClearedLines();
+
+        /**
+         * Returns the current level
+         */
+        int getLevel();
+
+        /**
+         * Returns the length of the next queue
+         */
+        int getNextQueueLength();
+
+        /**
+         * Returns wheter the blocks are currently bone blocks
+         */
+        bool getBoneBlocks();
+        
+        /**
+         * Returns the current gravity for a 20-line high board
+         */
+        int getGravity();
+
+        /**
+         * Returns the current lock delay
+         */
+        int getLockDelay();
+
+        /**
+         * Returns the current forced lock delay
+         */
+        int getForcedLockDelay();
+
+        /**
+         * Returns the current ARE
+         */
+        int getARE();
+
+        /**
+         * Returns the current line ARE
+         */
+        int getLineARE();
+        
+        /**
+         * Returns the current DAS
+         */
+        int getDAS();
+
+        /**
+         * Returns the current ARR
+         */
+        int getARR();
+
+        /**
+         * Returns the current SDR
+         */
+        int getSDR();
+};
diff --git a/src/Core/Gamemode.h b/src/Core/Gamemode.h
new file mode 100644
index 0000000..68a60f8
--- /dev/null
+++ b/src/Core/Gamemode.h
@@ -0,0 +1,12 @@
+#pragma once
+
+
+/**
+ * Every gamemode supported by the game
+ */
+enum Gamemode {
+    SPRINT,
+    MARATHON,
+    ULTRA,
+    MASTER
+};
diff --git a/src/Core/LineClear.h b/src/Core/LineClear.h
new file mode 100644
index 0000000..783eae1
--- /dev/null
+++ b/src/Core/LineClear.h
@@ -0,0 +1,11 @@
+#pragma once
+
+
+/**
+ * Specify how many lines were cleared and how
+ */
+struct LineClear {
+    int lines; // the number of lines cleared
+    bool isSpin; // if the move was a spin
+    bool isMiniSpin; // if the move was a spin mini
+};
diff --git a/src/Core/Player.cpp b/src/Core/Player.cpp
new file mode 100644
index 0000000..88b35d8
--- /dev/null
+++ b/src/Core/Player.cpp
@@ -0,0 +1,49 @@
+#include "Player.h"
+
+static const int DAS_MIN_VALUE = 0;
+static const int DAS_MAX_VALUE = 30;
+static const int ARR_MIN_VALUE = 0;
+static const int ARR_MAX_VALUE = 30;
+static const int SDR_MIN_VALUE = 0;
+static const int SDR_MAX_VALUE = 6;
+
+
+Player::Player() {
+    // default settings
+    this->DAS = 15; // 250ms
+    this->ARR = 3;  // 50ms
+    this->SDR = 2;  // 33ms
+}
+
+bool Player::setDAS(int DAS) {
+    if (DAS < DAS_MIN_VALUE || DAS > DAS_MAX_VALUE) return false;
+
+    this->DAS = DAS;
+    return true;
+}
+
+bool Player::setARR(int ARR) {
+    if (ARR < ARR_MIN_VALUE || ARR > ARR_MAX_VALUE) return false;
+
+    this->ARR = ARR;
+    return true;
+}
+
+bool Player::setSDR(int SDR) {
+    if (SDR < SDR_MIN_VALUE || SDR > SDR_MAX_VALUE) return false;
+
+    this->SDR = SDR;
+    return true;
+}
+
+int Player::getDAS() {
+    return this->DAS;
+}
+
+int Player::getARR() {
+    return this->ARR;
+}
+
+int Player::getSDR() {
+    return this->SDR;
+}
diff --git a/src/Core/Player.h b/src/Core/Player.h
new file mode 100644
index 0000000..d13cf94
--- /dev/null
+++ b/src/Core/Player.h
@@ -0,0 +1,48 @@
+#pragma once
+
+
+/**
+ * The controls of a player
+ */
+class Player {
+    private:
+        int DAS; // Delayed Auto-Shift, goes from 0 (instant) to 30 (500ms)
+        int ARR; // Auto-Repeat Rate, goes from 0 (instant) to 30 (500ms)
+        int SDR; // Soft Drop Rate, goes from 0 (instant) to 6 (100ms)
+    
+    public:
+        /**
+         * Sets default controls
+         */
+        Player();
+
+        /**
+         * Try setting DAS to the desired value, and returns wheter it is possible
+         */
+        bool setDAS(int DAS);
+
+        /**
+         * Try setting ARR to the desired value, and returns wheter it is possible
+         */
+        bool setARR(int ARR);
+
+        /**
+         * Try setting SDR to the desired value, and returns wheter it is possible
+         */
+        bool setSDR(int SDR);
+
+        /**
+         * Returns DAS value
+         */
+        int getDAS();
+
+        /**
+         * Returns ARR value
+         */
+        int getARR();
+
+        /**
+         * Returns SDR value
+         */
+        int getSDR();
+};
diff --git a/src/Core/main.cpp b/src/Core/main.cpp
new file mode 100644
index 0000000..3e861d0
--- /dev/null
+++ b/src/Core/main.cpp
@@ -0,0 +1,165 @@
+#include "../Pieces/PiecesFiles.h"
+#include "../Pieces/Generator.h"
+#include "GameBoard.h"
+
+#include <chrono>
+#include <string>
+#include <algorithm>
+#include <filesystem>
+#include <fstream>
+
+
+void testGeneratorForAllSizes(int amount);
+void testGeneratorForOneSize(int size);
+void testGeneratorByprintingAllNminos(int n);
+void testStoringAndRetrievingPieces(int size);
+void generateFilesForAllSizes(int amount);
+void readStatsFromFilesForAllSizes(int amount);
+
+
+int main(int argc, char** argv) {
+    std::srand(std::time(NULL));
+
+    using std::chrono::high_resolution_clock;
+    using std::chrono::duration_cast;
+    using std::chrono::duration;
+    using std::chrono::milliseconds;
+
+    PiecesFiles pf;
+    std::vector<Piece> pieces;
+    std::vector<int> convexPieces;
+    std::vector<int> holelessPieces;
+    std::vector<int> otherPieces;
+    pf.loadPieces(13, pieces, convexPieces, holelessPieces, otherPieces);
+
+    auto t1 = high_resolution_clock::now();
+    Bag bg(pieces);
+    auto t2 = high_resolution_clock::now();
+    duration<double, std::milli> ms_double = t2 - t1;
+    std::cout << ms_double.count() << "ms" << std::endl;
+
+    return 0;
+}
+
+
+void testGeneratorForAllSizes(int amount) {
+    using std::chrono::high_resolution_clock;
+    using std::chrono::duration_cast;
+    using std::chrono::duration;
+    using std::chrono::milliseconds;
+    Generator generator;
+
+    for (int i = 1; i <= amount; i++) {
+        auto t1 = high_resolution_clock::now();
+        std::vector<Polyomino> n_minos = generator.generatePolyominos(i);
+        auto t2 = high_resolution_clock::now();
+    
+        duration<double, std::milli> ms_double = t2 - t1;
+        std::cout << "generated " << n_minos.size() << " polyominos of size " << i << " in " << ms_double.count() << "ms" << std::endl;
+    }
+}
+
+void testGeneratorForOneSize(int size) {
+    using std::chrono::high_resolution_clock;
+    using std::chrono::duration_cast;
+    using std::chrono::duration;
+    using std::chrono::milliseconds;
+    Generator generator;
+
+    std::cout << "Generating " << size << "-minos" << std::endl;
+    for (int i = 0; i < 10; i++) {
+        auto t1 = high_resolution_clock::now();
+        std::vector<Polyomino> n_minos = generator.generatePolyominos(size);
+        auto t2 = high_resolution_clock::now();
+    
+        duration<double, std::milli> ms_double = t2 - t1;
+        std::cout << ms_double.count() << "ms" << std::endl;
+    }
+}
+
+void testGeneratorByprintingAllNminos(int n) {
+    Generator generator;
+    std::vector<Polyomino> n_minos = generator.generatePolyominos(n);
+
+    for (Polyomino& n_mino : n_minos) {
+        n_mino.goToSpawnPosition();
+    }
+    std::sort(n_minos.begin(), n_minos.end());
+
+    for (Polyomino& n_mino : n_minos) {
+        
+        std::cout << n_mino << std::endl;
+    }
+}
+
+void testStoringAndRetrievingPieces(int size) {
+    PiecesFiles piecesFiles;
+    piecesFiles.savePieces(size);
+
+    std::vector<Piece> pieces;
+    std::vector<int> convexPieces;
+    std::vector<int> holelessPieces;
+    std::vector<int> otherPieces;
+    piecesFiles.loadPieces(size, pieces, convexPieces, holelessPieces, otherPieces);
+
+    std::cout << "Convex " << size << "-minos:" << std::endl;
+    for (int index : convexPieces) {
+        std::cout << pieces.at(index);
+    }
+
+    std::cout << "Holeless " << size << "-minos:" << std::endl;
+    for (int index : holelessPieces) {
+        std::cout << pieces.at(index);
+    }
+
+    std::cout << "Others " << size << "-minos:" << std::endl;
+    for (int index : otherPieces) {
+        std::cout << pieces.at(index);
+    }
+}
+
+void generateFilesForAllSizes(int amount) {
+    using std::chrono::high_resolution_clock;
+    using std::chrono::duration_cast;
+    using std::chrono::duration;
+    using std::chrono::milliseconds;
+
+    PiecesFiles piecesFiles;
+    for (int i = 1; i <= amount; i++) {
+        auto t1 = high_resolution_clock::now();
+        piecesFiles.savePieces(i);
+        auto t2 = high_resolution_clock::now();
+
+        duration<double, std::milli> ms_double = t2 - t1;
+        std::cout << "Generated pieces files for size " << i << " in " << ms_double.count() << "ms" << std::endl;
+    }
+
+    for (int i = 1; i <= amount; i++) {
+        auto t1 = high_resolution_clock::now();
+        std::vector<Piece> pieces;
+        std::vector<int> convexPieces;
+        std::vector<int> holelessPieces;
+        std::vector<int> otherPieces;
+        piecesFiles.loadPieces(i, pieces, convexPieces, holelessPieces, otherPieces);
+        auto t2 = high_resolution_clock::now();
+
+        duration<double, std::milli> ms_double = t2 - t1;
+        std::cout << "Read pieces from files for size " << i << " in " << ms_double.count() << "ms" << std::endl;
+    }
+}
+
+void readStatsFromFilesForAllSizes(int amount) {
+    PiecesFiles piecesFiles;
+    for (int i = 1; i <= amount; i++) {
+        std::vector<Piece> pieces;
+        std::vector<int> convexPieces;
+        std::vector<int> holelessPieces;
+        std::vector<int> otherPieces;
+        piecesFiles.loadPieces(i, pieces, convexPieces, holelessPieces, otherPieces);
+
+        std::cout << i << "-minos : " << pieces.size() << std::endl;
+        std::cout << "Convex " << i << "-minos : " << convexPieces.size() << std::endl;
+        std::cout << "Holeless " << i << "-minos : " << holelessPieces.size() << std::endl;
+        std::cout << "Others " << i << "-minos : " << otherPieces.size() << std::endl;
+    }
+}
diff --git a/src/Pieces/Cell.h b/src/Pieces/Cell.h
new file mode 100644
index 0000000..3d0f3c8
--- /dev/null
+++ b/src/Pieces/Cell.h
@@ -0,0 +1,66 @@
+#pragma once
+
+#include <iostream>
+
+
+/**
+ * A cell on a 2D grid
+ */
+struct Cell {
+    int x; // x position
+    int y; // y position
+};
+
+
+/**
+ * Addition operator, returns the sums of the coordinates of both cells
+ */
+Cell operator+(const Cell& left, const Cell& right) {
+    return Cell{left.x + right.x, left.y + right.y};
+}
+
+/**
+ * Additive assignation operator, adds the coordinates of the right cell to the left one
+ */
+Cell& operator+=(Cell& left, const Cell& right) {
+    left = left + right;
+    return left;
+}
+
+/**
+ * Substraction operator, returns the difference of the coordinate between the left and right cell
+ */
+Cell operator-(const Cell& left, const Cell& right) {
+    return Cell{left.x - right.x, left.y - right.y};
+
+}
+
+/**
+ * Substractive assignation operator, substract the coordinates of the right cell from the left one
+ */
+Cell& operator-=(Cell& left, const Cell& right) {
+    left = left - right;
+    return left;
+}
+
+/**
+ * Strict inferiority operator, a cell is inferior to another if it is lower or at the same height and more to the left
+ */
+bool operator<(const Cell& left, const Cell& right) {
+    return (left.x == right.x) ? (left.y < right.y) : (left.x < right.x);
+}
+
+/**
+ * Equality operator, two cells are equal if they have the same coordinates
+ */
+bool operator==(const Cell& left, const Cell& right) {
+    return (left.x == right.x) && (left.y == right.y);
+}
+
+/**
+ * Stream output operator, adds the coordinates of the cell to the stream
+ */
+std::ostream& operator<<(std::ostream& os, const Cell& cell) {
+    os << "x: " << cell.x << " y: " << cell.y;
+    return os;
+}
diff --git a/src/Pieces/Color.h b/src/Pieces/Color.h
new file mode 100644
index 0000000..9c6404b
--- /dev/null
+++ b/src/Pieces/Color.h
@@ -0,0 +1,40 @@
+#pragma once
+
+#include <String>
+
+
+/**
+ * Every possible colors a block can take
+ */
+enum Color {
+    NOTHING,
+    OUT_OF_BOUND,
+    GARBAGE,
+    PURPLE,
+    ORANGE,
+    CYAN,
+    PINK,
+    YELLOW,
+    RED,
+    BLUE,
+    GREEN
+};
+
+
+static const Color FIRST_PIECE_COLOR = PURPLE; // the first color a piece can be
+static const Color LAST_PIECE_COLOR = GREEN; // the last color a piece can be
+
+static const std::string COLOR_RESET = "\033[38;2;255;255;255m"; // color code to reset the console color
+static const std::string COLOR_CODES[] = { // color codes to change the console color
+    COLOR_RESET,              // NOTHING
+    COLOR_RESET,              // OUT_OF_BOUND
+    "\033[38;2;150;150;150m", // GARBAGE
+    "\033[38;2;150;0;255m",   // PURPLE
+    "\033[38;2;255;150;0m",   // ORANGE
+    "\033[38;2;0;255;255m",   // CYAN
+    "\033[38;2;255;0;200m",   // PINK
+    "\033[38;2;255;255;0m",   // YELLOW
+    "\033[38;2;255;0;0m",     // RED
+    "\033[38;2;0;100;255m",   // BLUE
+    "\033[38;2;0;255;0m"      // GREEN
+};
diff --git a/src/Pieces/Generator.cpp b/src/Pieces/Generator.cpp
new file mode 100644
index 0000000..45fb95b
--- /dev/null
+++ b/src/Pieces/Generator.cpp
@@ -0,0 +1,85 @@
+#include "Generator.h"
+
+#include "Polyomino.h"
+
+#include <Vector>
+#include <Set>
+#include <Map>
+#include <algorithm>
+
+
+Generator::Generator() {
+}
+
+std::vector<Polyomino> Generator::generatePolyominos(unsigned int order) {
+    // initialization
+    this->validPolyominos.clear();
+    this->currentTestedShape.clear();
+
+    // no polyomino with 0 cells
+    if (order == 0) return this->validPolyominos;
+
+    // start generating from the monomino
+    this->currentTestedShape.insert(Cell{0, 0});
+    
+    // generate polyominos
+    std::map<Cell, int> candidateCells;
+    this->generate(order, 0, 1, candidateCells);
+    return this->validPolyominos;
+}
+
+void Generator::generate(unsigned int order, int lastAddedCellNumber, int nextAvaibleNumber, std::map<Cell, int> candidateCells) {
+    // recursion stop
+    if (order == this->currentTestedShape.size()) {
+        // we test the polyomino formed by the current shape
+        Polyomino candidate(this->currentTestedShape);
+
+        // we sort the rotations of the polyominos
+        std::vector<Polyomino> candidateRotations;
+        for (int i = 0; i < 4; i++) {
+            candidate.normalize();
+            candidateRotations.push_back(candidate);
+            if (!(i==3)) candidate.rotateCW();
+        }
+        std::sort(candidateRotations.begin(), candidateRotations.end());
+
+        // we keep the polyomino only if it was generated in its lowest rotation
+        if (candidate == candidateRotations.at(0)) {
+            this->validPolyominos.push_back(candidate);
+        }
+
+        return;
+    }
+
+    // generate the list of candidate cells
+    for (Cell cell : this->currentTestedShape) {
+        this->tryToAddCandidateCell(Cell{cell.x, cell.y + 1}, nextAvaibleNumber, candidateCells);
+        this->tryToAddCandidateCell(Cell{cell.x + 1, cell.y}, nextAvaibleNumber, candidateCells);
+        this->tryToAddCandidateCell(Cell{cell.x, cell.y - 1}, nextAvaibleNumber, candidateCells);
+        this->tryToAddCandidateCell(Cell{cell.x - 1, cell.y}, nextAvaibleNumber, candidateCells);
+    }
+    
+    // generate polyominos for all cells with a higher number than the last one
+    for (auto [key, val] : candidateCells) {
+        if (val > lastAddedCellNumber) {
+            this->currentTestedShape.insert(key);
+            this->generate(order, val, nextAvaibleNumber, (order == this->currentTestedShape.size()) ? std::map<Cell, int>() : candidateCells);
+            this->currentTestedShape.erase(key);
+        }
+    }
+}
+
+void Generator::tryToAddCandidateCell(const Cell& candidate, int& nextAvaibleNumber, std::map<Cell, int>& candidateCells) {
+    // we declared the first cell as the lower-left square, since we always start with a monomino at (0,0) we can test with hard values
+    if (candidate.y < 0 || (candidate.y == 0 && candidate.x < 0)) return;
+
+    // if the cell was already marked then we should not mark it again
+    if (candidateCells.contains(candidate)) return;
+
+    // if the candidate overlaps with the shape there is no reason to add it
+    if (this->currentTestedShape.contains(candidate)) return;
+
+    // once all tests passed we can add the cell
+    candidateCells.insert({candidate, nextAvaibleNumber});
+    nextAvaibleNumber++;
+}
diff --git a/src/Pieces/Generator.h b/src/Pieces/Generator.h
new file mode 100644
index 0000000..890e3fb
--- /dev/null
+++ b/src/Pieces/Generator.h
@@ -0,0 +1,39 @@
+#pragma once
+
+#include "Polyomino.h"
+
+#include <Vector>
+#include <Set>
+#include <Map>
+
+
+/**
+ * A generator of one-sided polyominos of any size
+ */
+class Generator {
+    private:
+        std::vector<Polyomino> validPolyominos; // the list of already generated polyominos
+        std::set<Cell> currentTestedShape; // the polyomino being created
+
+    public:
+        /**
+         * Initializes generator
+         */
+        Generator();
+        
+        /**
+         * Returns the list of all one-sided polyominos of the specified size
+         */
+        std::vector<Polyomino> generatePolyominos(unsigned int order);
+
+    private:
+        /**
+         * Generates all one-sided polyominos of the specified using the current tested shape
+         */
+        void generate(unsigned int order, int lastAddedCellNumber, int nextAvaibleNumber, std::map<Cell, int> candidateCells);
+
+        /**
+         * Check wheter a candidate cell can be added to the current tested shape
+         */
+        void tryToAddCandidateCell(const Cell& candidate, int& nextAvaibleNumber, std::map<Cell, int>& candidateCells);
+};
diff --git a/src/Pieces/Piece.cpp b/src/Pieces/Piece.cpp
new file mode 100644
index 0000000..61471f2
--- /dev/null
+++ b/src/Pieces/Piece.cpp
@@ -0,0 +1,38 @@
+#include "Piece.h"
+
+#include "Polyomino.h"
+#include "Rotation.h"
+#include "Color.h"
+
+#include <Set>
+#include <String>
+
+
+Piece::Piece(const Polyomino& polyomino, Color color) : polyomino(polyomino), color(color) {
+}
+
+void Piece::rotate(Rotation rotation) {
+    if (rotation == CLOCKWISE)
+        this->polyomino.rotateCW();
+    if (rotation == DOUBLE)
+        this->polyomino.rotate180();
+    if (rotation == COUNTERCLOCKWISE)
+        this->polyomino.rotateCCW();
+}
+
+std::set<Cell> Piece::getPositions() const {
+    return this->polyomino.getCells();
+}
+
+int Piece::getLength() const {
+    return this->polyomino.getLength();
+}
+
+Color Piece::getColor() const {
+    return this->color;
+}
+
+std::ostream& operator<<(std::ostream& os, const Piece& piece) {
+    os << COLOR_CODES[piece.color] << piece.polyomino << COLOR_RESET;
+    return os;
+}
diff --git a/src/Pieces/Piece.h b/src/Pieces/Piece.h
new file mode 100644
index 0000000..aa90b36
--- /dev/null
+++ b/src/Pieces/Piece.h
@@ -0,0 +1,48 @@
+#pragma once
+
+#include "Polyomino.h"
+#include "Rotation.h"
+#include "Color.h"
+
+#include <Set>
+
+
+/**
+ * An abstraction of a polyomino as a playable piece in a stacker game
+ */
+class Piece {
+    private:
+        Polyomino polyomino; // a polyomino representing the piece, (0, 0) is downleft
+        Color color; // the color of the piece
+
+    public:
+        /**
+         * Creates a piece with a specified shape and color
+         */
+        Piece(const Polyomino& piece, Color color);
+
+        /**
+         * Rotates the piece in the specified direction
+         */
+        void rotate(Rotation rotation);
+
+        /**
+         * Returns a copy of the list of cells of the piece
+         */
+        std::set<Cell> getPositions() const;
+
+        /**
+         * Returns the length of the piece
+         */
+        int getLength() const;
+
+        /**
+         * Returns the color of the piece
+         */
+        Color getColor() const;
+
+        /**
+         * Stream output operator, adds a 2D grid representing the piece
+         */
+        friend std::ostream& operator<<(std::ostream& os, const Piece& piece);
+};
diff --git a/src/Pieces/PiecesFiles.cpp b/src/Pieces/PiecesFiles.cpp
new file mode 100644
index 0000000..4ffca59
--- /dev/null
+++ b/src/Pieces/PiecesFiles.cpp
@@ -0,0 +1,141 @@
+#include "PiecesFiles.h"
+
+#include "Generator.h"
+#include "Piece.h"
+
+#include <Vector>
+#include <String>
+#include <iostream>
+#include <fstream>
+#include <filesystem>
+#include <algorithm>
+
+
+PiecesFiles::PiecesFiles() {
+}
+
+bool PiecesFiles::savePieces(int order) const {
+    // open pieces file
+    std::string filePath;
+    if (!this->getFilePath(order, filePath)) {
+        return false;
+    }
+    std::ofstream piecesFile(filePath, std::ios::trunc | std::ios::binary);
+    if (!piecesFile.good()) {
+        return false;
+    }
+
+    // generates the polyominos
+    Generator generator;
+    std::vector<Polyomino> nMinos = generator.generatePolyominos(order);
+
+    // set the polyominos to their spawn position
+    for (Polyomino& nMino : nMinos) {
+        nMino.goToSpawnPosition();
+    }
+    
+    // sort the polyominos, is done after setting spawn position to ensure the order is always the same
+    std::sort(nMinos.begin(), nMinos.end());
+    
+    // write pieces
+    Color pieceColor = Color(FIRST_PIECE_COLOR + (order % (LAST_PIECE_COLOR - FIRST_PIECE_COLOR + 1)));
+    for (const Polyomino& nMino : nMinos) {
+        // write polyomino length
+        char lengthByte = nMino.getLength();
+        piecesFile.write(&lengthByte, 1);
+
+        // write the type and color of the piece
+        char infoByte = (nMino.isConvex() << 7) + (nMino.hasHole() << 6) + pieceColor;
+        pieceColor = (pieceColor == LAST_PIECE_COLOR) ? FIRST_PIECE_COLOR : Color(pieceColor + 1);
+        piecesFile.write(&infoByte, 1);
+
+        // write the cells of the piece
+        char cellByte;
+        for (Cell cell : nMino.getCells()) {
+            cellByte = (cell.x << 4) + cell.y;
+            piecesFile.write(&cellByte, 1);
+        }
+    }
+
+    return true;
+}
+
+bool PiecesFiles::loadPieces(int order, std::vector<Piece>& pieces, std::vector<int>& convexPieces, std::vector<int>& holelessPieces, std::vector<int>& otherPieces) const {
+    // open pieces file
+    std::string filePath;
+    if (!this->getFilePath(order, filePath)) {
+        return false;
+    }
+    std::ifstream piecesFile(filePath, std::ios::binary);
+    if (!piecesFile.good()) {
+        return false;
+    }
+
+    // get empty vectors
+    pieces.clear();
+    convexPieces.clear();
+    holelessPieces.clear();
+    otherPieces.clear();
+
+    // set up masks
+    char convexMask = 0b1000'0000;
+    char holeMask = 0b0100'0000;
+    char colorMask = 0b0011'1111;
+    char xMask = 0b1111'0000;
+    char yMask = 0b0000'1111;
+
+    // read the pieces
+    char lengthByte;
+    int i = 0;
+    while (piecesFile.get(lengthByte)) {
+        if (piecesFile.eof()) break;
+        
+        // read piece infos
+        char infoByte;
+        piecesFile.get(infoByte);
+        bool isConvex = (infoByte & convexMask) >> 7;
+        bool hasHole = (infoByte & holeMask) >> 6;
+        Color color = Color(infoByte & colorMask);
+
+        // read cells
+        std::set<Cell> pieceCells;
+        char cellByte;
+        for (int i = 0; i < order; i++) {
+            piecesFile.get(cellByte);
+            int x = (cellByte & xMask) >> 4;
+            int y = cellByte & yMask;
+            pieceCells.insert(Cell{x, y});
+        }
+
+        // create piece
+        Piece readPiece(Polyomino(pieceCells, lengthByte), color);
+        pieces.push_back(readPiece);
+
+        // link it to its type
+        if (isConvex) {
+            convexPieces.push_back(i);
+        }
+        else if (hasHole) {
+            otherPieces.push_back(i);
+        }
+        else {
+            holelessPieces.push_back(i);
+        }
+
+        i++;
+    }
+
+    return true;
+}
+
+bool PiecesFiles::getFilePath(int order, std::string& filePath) const {
+    // verify that the data folder exists
+    std::string dataFolderPath = "data/pieces/";
+    if (!std::filesystem::is_directory(dataFolderPath)) {
+        return false;
+    }
+
+    // return the file path
+    filePath = dataFolderPath + std::to_string(order) + "minos.bin";
+    return true;
+}
diff --git a/src/Pieces/PiecesFiles.h b/src/Pieces/PiecesFiles.h
new file mode 100644
index 0000000..540a696
--- /dev/null
+++ b/src/Pieces/PiecesFiles.h
@@ -0,0 +1,37 @@
+#pragma once
+
+#include "Piece.h"
+
+#include <Vector>
+#include <String>
+
+
+/**
+ * Manages creating pieces files and importing the data back from them
+ */
+class PiecesFiles {
+    public:
+        /**
+         * Initializes file manager
+         */
+        PiecesFiles();
+
+        /**
+         * Generate a file containing all the pieces of the specified size,
+         * returns false if the file couldn't be created
+         */
+        bool savePieces(int order) const;
+
+        /**
+         * Replace the content of the vectors by the pieces of the specified size, if the file wasn't found the vectors stays untouched,
+         * returns false if the file wasn't found
+         */
+        bool loadPieces(int order, std::vector<Piece>& pieces, std::vector<int>& convexPieces, std::vector<int>& holelessPieces, std::vector<int>& otherPieces) const;
+    
+    private:
+        /**
+         * Puts the path to the piece file of the specified size in order, if the data folder wasn't found the string stays untouched,
+         * returns false if the data folder wasn't found
+         */
+        bool getFilePath(int order, std::string& filePath) const;
+};
diff --git a/src/Pieces/Polyomino.cpp b/src/Pieces/Polyomino.cpp
new file mode 100644
index 0000000..ec3a65f
--- /dev/null
+++ b/src/Pieces/Polyomino.cpp
@@ -0,0 +1,322 @@
+#include "Polyomino.h"
+
+#include "Cell.h"
+
+#include <Vector>
+#include <Set>
+#include <iostream>
+#include <climits>
+#include <algorithm>
+
+
+Polyomino::Polyomino(const std::set<Cell>& cells) {
+    // find min/max
+    int minX = INT_MAX;
+    int maxX = INT_MIN;
+    int minY = INT_MAX;
+    int maxY = INT_MIN;
+    for (Cell cell : cells) {
+        if (cell.x < minX) minX = cell.x;
+        if (cell.x > maxX) maxX = cell.x;
+        if (cell.y < minY) minY = cell.y;
+        if (cell.y > maxY) maxY = cell.y;
+    }
+
+    // normalize
+    std::set<Cell> newCells;
+    for (Cell cell : cells) {
+        newCells.insert(Cell{cell.x - minX, cell.y - minY});
+    }
+    this->cells = newCells;
+
+    // set polyomino length
+    this->length = std::max(maxX - minX + 1, maxY - minY + 1);
+}
+
+Polyomino::Polyomino(const std::set<Cell>& cells, int length) : cells(cells), length(length) {
+}
+
+void Polyomino::normalize() {
+    // find min values
+    int minX = INT_MAX;
+    int minY = INT_MAX;
+    for (Cell cell : this->cells) {
+        if (cell.x < minX) minX = cell.x;
+        if (cell.y < minY) minY = cell.y;
+    }
+
+    // translate the polyomino to the lowest unsigned values
+    std::set<Cell> newCells;
+    for (Cell cell : this->cells) {
+        newCells.insert(Cell{cell.x - minX, cell.y - minY});
+    }
+    this->cells = newCells;
+}
+
+void Polyomino::rotateCW() {
+    // rotate 90° clockwise
+    std::set<Cell> newCells;
+    for (Cell cell : this->cells) {
+        newCells.insert(Cell{cell.y, (length - 1) - (cell.x)});
+    }
+    this->cells = newCells;
+}
+
+void Polyomino::rotate180() {
+    // rotate 180°
+    std::set<Cell> newCells;
+    for (Cell cell : this->cells) {
+        newCells.insert(Cell{(length - 1) - (cell.x), (length - 1) - (cell.y)});
+    }
+    this->cells = newCells;
+}
+
+void Polyomino::rotateCCW() {
+    // rotate 90° counter-clockwise
+    std::set<Cell> newCells;
+    for (Cell cell : this->cells) {
+        newCells.insert(Cell{(length - 1) - (cell.y), cell.x});
+    }
+    this->cells = newCells;
+}
+
+void Polyomino::goToSpawnPosition() {
+    // initialize array
+    std::vector<std::vector<int>> linesCompleteness;
+    std::vector<int> empty;
+    for (int j = 0; j < this->length; j++) {
+        empty.push_back(0);
+    }
+    for (int i = 0; i < 4; i++) {
+        linesCompleteness.push_back(empty);
+    }
+
+    // calculates amount of cells per rows and columns
+    for (Cell cell : this->cells) {
+        linesCompleteness.at(0).at(cell.y) += 1; // 0 = bottom to top = no rotation
+        linesCompleteness.at(1).at((length - 1) - cell.x) += 1; // 1 = right to left = CW
+        linesCompleteness.at(2).at((length - 1) - cell.y) += 1; // 2 = top to bottom = 180
+        linesCompleteness.at(3).at(cell.x) += 1; // 3 = left to right = CCW
+    }
+
+    // checks for empty lines
+    int horizontalEmptyLines = 0;
+    int verticalEmptyLines = 0;
+    for (int i = 0; i < 4; i++) {
+        for (int j = this->length - 1; j >= 0; j--) {
+            if (linesCompleteness.at(i).at(j) == 0) {
+                // push the non-empty lines to the start of each vector
+                linesCompleteness.at(i).erase(linesCompleteness.at(i).begin() + j);
+                linesCompleteness.at(i).push_back(0);
+                if (i == 0) horizontalEmptyLines++;
+                if (i == 1) verticalEmptyLines++;
+            }
+        }
+    }
+
+    // we ignore the sides which are not the widest
+    bool currentFlattestSides[4] = {true, true, true, true};
+    if (horizontalEmptyLines < verticalEmptyLines) {
+        currentFlattestSides[0] = false;
+        currentFlattestSides[2] = false;
+    }
+    if (verticalEmptyLines < horizontalEmptyLines) {
+        currentFlattestSides[1] = false;
+        currentFlattestSides[3] = false;
+    }
+
+    // checks for the flattest sides
+    int sideToBeOn = -1;
+    this->checkForFlattestSide(linesCompleteness, currentFlattestSides, sideToBeOn, false);
+
+    // if all sides are as flat, checks for the most left-biased side
+    if (sideToBeOn == -1) {
+        this->checkForFlattestSide(linesCompleteness, currentFlattestSides, sideToBeOn, true);
+    }
+    
+    // if there's still no winner we take the side (amongst the remaining ones) that's the smallest once rotated
+    if (sideToBeOn == -1) {
+        std::vector<Polyomino> candidateRotations;
+        std::vector<int> candidateSides;
+        for (int i = 0; i < 4; i++) {
+            this->normalize();
+            if (currentFlattestSides[i]) {
+                candidateRotations.push_back(*this);
+                candidateSides.push_back(i);
+            }
+            this->rotateCW();
+        }
+        sideToBeOn = candidateSides.at(std::distance(candidateRotations.begin(), std::min_element(candidateRotations.begin(), candidateRotations.end())));
+    }
+    
+    // do the correct rotation
+    if (sideToBeOn == 1) this->rotateCW();
+    if (sideToBeOn == 2) this->rotate180();
+    if (sideToBeOn == 3) this->rotateCCW();
+    
+    // find min
+    int minX = INT_MAX;
+    int minY = INT_MAX;
+    for (Cell cell : this->cells) {
+        if (cell.x < minX) minX = cell.x;
+        if (cell.y < minY) minY = cell.y;
+    }
+
+    // center the piece with an up bias if it is assymetric
+    if (sideToBeOn % 2 == 1) {
+        std::swap(verticalEmptyLines, horizontalEmptyLines);
+    }
+    std::set<Cell> newCells;
+    for (Cell cell : cells) {
+        newCells.insert(Cell{(cell.x - minX) + (verticalEmptyLines / 2), (cell.y - minY) + ((horizontalEmptyLines + 1) / 2)});
+    }
+    this->cells = newCells;
+}
+
+void Polyomino::checkForFlattestSide(const std::vector<std::vector<int>>& linesCompleteness, bool currentFlattestSides[4], int& sideToBeOn, bool checkLeftSide) const {
+    // for each line
+    for (int j = 0; j < this->length; j++) {
+        // we check which sides are the flattest
+        int max = 0;
+        std::set<int> maxOwners;
+        for (int i = 0; i < 4; i++) {
+            // only the candidate sides are compared
+            if (!currentFlattestSides[i]) continue;
+
+            // if we need to check the flatness of the side to the left
+            int sideToCheck = i;
+            if (checkLeftSide) {
+                sideToCheck = (i + 3) % 4;
+            }
+
+            // we check which sides are the flattest
+            if (linesCompleteness.at(sideToCheck).at(j) > max) {
+                max = linesCompleteness.at(sideToCheck).at(j);
+                maxOwners.clear();
+                maxOwners.insert(i);
+            }
+            else if (linesCompleteness.at(sideToCheck).at(j) == max) {
+                maxOwners.insert(i);
+            }
+        }
+
+        // if there's no tie we choose this side
+        if (maxOwners.size() == 1) {
+            sideToBeOn = *maxOwners.begin();
+            return;
+        }
+
+        // else we only keep the flattest from this round and ignore the others
+        else {
+            for (int i = 0; i < 4; i++) {
+                currentFlattestSides[i] = currentFlattestSides[i] && maxOwners.contains(i);
+            }
+        }
+    }
+}
+
+bool Polyomino::isConvex() const {
+    // for each line and column we check if every cells are adjacent to each others
+    for (int j = 0; j < this->length; j++) {
+        bool startedLine = false;
+        bool completedLine = false;
+        bool startedColumn = false;
+        bool completedColumn = false;
+        for (int i = 0; i < this->length; i++) {
+            // line check
+            if (this->cells.contains(Cell{i, j})) {
+                if (completedLine) return false;
+                else startedLine = true;
+            }
+            else {
+                if (startedLine) completedLine = true;
+            }
+            // column check
+            if (this->cells.contains(Cell{j, i})) {
+                if (completedColumn) return false;
+                else startedColumn = true;
+            }
+            else {
+                if (startedColumn) completedColumn = true;
+            }
+        }
+    }
+    return true;
+}
+
+bool Polyomino::hasHole() const {
+    // add every outer cells of the square containing the polyomino
+    std::set<Cell> emptyCells;
+    for (int i = 0; i < this->length - 1; i++) {
+        this->tryToInsertCell(emptyCells, Cell{i, 0}); // up row
+        this->tryToInsertCell(emptyCells, Cell{this->length - 1, i}); // rigth column
+        this->tryToInsertCell(emptyCells, Cell{this->length - 1 - i, this->length - 1}); // bottom row
+        this->tryToInsertCell(emptyCells, Cell{0, this->length - 1 - i}); // left column
+    }
+
+    // if we didn't reached all empty cells in the square then there was some contained within the polyomino, i.e. there was a hole
+    return (emptyCells.size() < (this->length * this->length) - this->cells.size());
+}
+
+void Polyomino::tryToInsertCell(std::set<Cell>& emptyCells, const Cell& candidate) const {
+    // check if the cell is in the square containing the polyomino
+    if (candidate.x >= this->length || candidate.x < 0 || candidate.y >= this->length || candidate.y < 0) return;
+
+    // check if the cell is empty and hasn't already been tested
+    if (this->cells.contains(candidate) || emptyCells.contains(candidate)) return;
+
+    // adds the cell to the list of empty cells and try its neighbors
+    emptyCells.insert(candidate);
+    tryToInsertCell(emptyCells, Cell{candidate.x, candidate.y + 1});
+    tryToInsertCell(emptyCells, Cell{candidate.x + 1, candidate.y});
+    tryToInsertCell(emptyCells, Cell{candidate.x, candidate.y - 1});
+    tryToInsertCell(emptyCells, Cell{candidate.x - 1, candidate.y});
+}
+
+std::set<Cell> Polyomino::getCells() const {
+    return this->cells;
+}
+
+int Polyomino::getLength() const {
+    return this->length;
+}
+
+int Polyomino::getPolyominoOrder() const {
+    return this->cells.size();
+}
+
+bool Polyomino::operator<(const Polyomino& other) const {
+    // if one has an inferior length then it is deemed inferior
+    if (this->length != other.length) return this->length < other.length;
+
+    // else we check for all cells from left to right and top to bottom, until one has a cell that the other doesn't
+    for (int y = this->length - 1; y >= 0; y--) {
+        for (int x = 0; x < this->length; x++) {
+            bool hasThisCell = this->cells.contains(Cell{x, y});
+            bool hasOtherCell = other.cells.contains(Cell{x, y});
+            if (hasThisCell != hasOtherCell) return hasThisCell;
+        }
+    }
+
+    // if they are equal
+    return false;
+}
+
+bool Polyomino::operator ==(const Polyomino& other) const {
+    return this->cells == other.cells;
+}
+
+std::ostream& operator<<(std::ostream& os, const Polyomino& polyomino) {
+    for (int y = polyomino.length - 1; y >= 0; y--) {
+        for (int x = 0; x < polyomino.length; x++) {
+            if (polyomino.cells.contains(Cell{x, y})) {
+                os << "*";
+            }
+            else {
+                os << "-";
+            }
+        }
+        os << std::endl;
+    }
+    return os;
+}
diff --git a/src/Pieces/Polyomino.h b/src/Pieces/Polyomino.h
new file mode 100644
index 0000000..41aef17
--- /dev/null
+++ b/src/Pieces/Polyomino.h
@@ -0,0 +1,108 @@
+#pragma once
+
+#include "Cell.h"
+
+#include <Vector>
+#include <Set>
+#include <iostream>
+
+
+/**
+ * A mathematical object consisting of touching squares on a 2D grid
+ */
+class Polyomino {
+    private:
+        std::set<Cell> cells; // the squares composing the polyomino, (0,0) is downleft
+        int length; // the size of the smallest square in which the polyomino can fit on any rotation
+
+    public:
+        /**
+         * Creates a polyomino with the specified cells and normalizes it, wheter it is actually a polyonimo is not checked
+         */
+        Polyomino(const std::set<Cell>& cells);
+
+        /**
+         * Creates a polyomino with the specified cells and length, wheter it is actually a polyonimo of this length is not checked
+         */
+        Polyomino(const std::set<Cell>& cells, int length);
+
+        /**
+         * Translates the polyomino to the lowest unsigned values (lower row on y = 0, and left-most column on x = 0)
+         */
+        void normalize();
+
+        /**
+         * Rotates the polyomino 90° clockwise, the center of rotation being the middle of the square going from (0,0) to (length-1, length-1)
+         */
+        void rotateCW();
+
+        /**
+         * Rotates the polyomino 180°, the center of rotation being the middle of the square going from (0,0) to (length-1, length-1)
+         */
+        void rotate180();
+
+        /**
+         * Rotates the polyomino 90° counter-clockwise, the center of rotation being the middle of the square going from (0,0) to (length-1, length-1)
+         */
+        void rotateCCW();
+
+        /**
+         * Set the polyomino to a normalized default spawn position
+         */
+        void goToSpawnPosition();
+
+    private:
+        /**
+         * Auxiliary method of goToSpawnPosition()
+         */
+        void checkForFlattestSide(const std::vector<std::vector<int>>& linesCompleteness, bool currentFlattestSides[4], int& sideToBeOn, bool checkLeftSide) const;
+
+    public:
+        /**
+         * Returns wheter the polyomino is convex, that is if every line and column has at most one continuous line of cells
+         */
+        bool isConvex() const;
+
+        /**
+         * Returns wheter the polyomino has at least one hole
+         */
+        bool hasHole() const;
+    
+    private :
+        /**
+         * Auxiliary method of hasHole()
+         */
+        void tryToInsertCell(std::set<Cell>& emptyCells, const Cell& candidate) const;
+
+    public:
+        /**
+         * Returns a copy of the cells of the polyomino
+         */
+        std::set<Cell> getCells() const;
+
+        /**
+         * Returns the length of the polyomino
+         */
+        int getLength() const;
+
+        /**
+         * Returns the number of squares in the polyomino
+         */
+        int getPolyominoOrder() const;
+
+        /**
+         * Strict inferiority operator, a polyomino is inferior than another if it has a smaller length, or if they are the same length,
+         * while checking from left to right and top to bottom, is the first which has a cell while the other doesn't
+         */
+        bool operator<(const Polyomino& other) const;
+
+        /**
+         * Equality operator, two polyominos are equal if they overlap, that means two polyominos of the same shape but different positions will not be equal
+         */
+        bool operator ==(const Polyomino& other) const;
+
+        /**
+         * Stream output operator, adds a 2D grid representing the polyomino
+         */
+        friend std::ostream& operator<<(std::ostream& os, const Polyomino& polyomino);
+};
diff --git a/src/Pieces/Rotation.h b/src/Pieces/Rotation.h
new file mode 100644
index 0000000..a638900
--- /dev/null
+++ b/src/Pieces/Rotation.h
@@ -0,0 +1,28 @@
+#pragma once
+
+
+/**
+ * Every type of rotation that can be applied to an object in a 2D grid
+ */
+enum Rotation {
+    NONE,
+    CLOCKWISE,
+    DOUBLE,
+    COUNTERCLOCKWISE
+};
+
+
+/**
+ * Addition operator, returns a rotation corresponding to doing both rotations
+ */
+Rotation operator+(const Rotation& left, const Rotation& right) {
+    return Rotation((left + right) % 4);
+}
+
+/**
+ * Additive assignation operator, rotate the left rotation by the right rotation
+ */
+Rotation& operator+=(Rotation& left, const Rotation& right) {
+    left = left + right;
+    return left;
+}
diff --git a/xmake.lua b/xmake.lua
new file mode 100644
index 0000000..659104e
--- /dev/null
+++ b/xmake.lua
@@ -0,0 +1,77 @@
+set_languages("c++20")
+
+target("main")
+    set_kind("binary")
+    set_rundir(".")
+    add_files("./src/Pieces/*.cpp")
+    add_files("./src/Core/*.cpp")
+    
+
+--
+-- If you want to known more usage about xmake, please see https://xmake.io
+--
+-- ## FAQ
+--
+-- You can enter the project directory firstly before building project.
+--
+--   $ cd projectdir
+--
+-- 1. How to build project?
+--
+--   $ xmake
+--
+-- 2. How to configure project?
+--
+--   $ xmake f -p [macosx|linux|iphoneos ..] -a [x86_64|i386|arm64 ..] -m [debug|release]
+--
+-- 3. Where is the build output directory?
+--
+--   The default output directory is `./build` and you can configure the output directory.
+--
+--   $ xmake f -o outputdir
+--   $ xmake
+--
+-- 4. How to run and debug target after building project?
+--
+--   $ xmake run [targetname]
+--   $ xmake run -d [targetname]
+--
+-- 5. How to install target to the system directory or other output directory?
+--
+--   $ xmake install
+--   $ xmake install -o installdir
+--
+-- 6. Add some frequently-used compilation flags in xmake.lua
+--
+-- @code
+--    -- add debug and release modes
+--    add_rules("mode.debug", "mode.release")
+--
+--    -- add macro definition
+--    add_defines("NDEBUG", "_GNU_SOURCE=1")
+--
+--    -- set warning all as error
+--    set_warnings("all", "error")
+--
+--    -- set language: c99, c++11
+--    set_languages("c99", "c++11")
+--
+--    -- set optimization: none, faster, fastest, smallest
+--    set_optimize("fastest")
+--
+--    -- add include search directories
+--    add_includedirs("/usr/include", "/usr/local/include")
+--
+--    -- add link libraries and search directories
+--    add_links("tbox")
+--    add_linkdirs("/usr/local/lib", "/usr/lib")
+--
+--    -- add system link libraries
+--    add_syslinks("z", "pthread")
+--
+--    -- add compilation and link flags
+--    add_cxflags("-stdnolib", "-fno-strict-aliasing")
+--    add_ldflags("-L/usr/local/lib", "-lpthread", {force = true})
+--
+-- @endcode
+--