diff --git a/README.md b/README.md new file mode 100644 index 0000000..1e3d036 --- /dev/null +++ b/README.md @@ -0,0 +1,58 @@ +# 2048_ in Terminal, (BP Mini Project) + +![Logo](./screenshots/2048-image.jpg) + +A simple **2048 puzzle game** implemented in **C++** as a mini project for a basic programming course. The game offers a classic 2048 experience with extra features to customize gameplay and track scores. + +--- + +## Features + +- 🎮 Classic 2048 gameplay mechanics +- 🗂️ Main menu with intuitive navigation +- 📏 Choose different board sizes (e.g., 4x4, 5x5, etc.) +- 🏆 View and track best scores per board size +- 📝 Enter player name for personalized experience +- 📊 Leaderboard showing top scores filtered by board size + +--- + +## Screenshots + + +![Main Menu](./screenshots/main_menu.png) +![Loading](./screenshots/Loading.png) +![Game Board](./screenshots/game_board.png) + +--- + +## How to Play + +Use the arrow keys to move tiles in four directions. When two tiles with the same number collide, they merge into one with their sum. The goal is to reach the 2048 tile or achieve the highest possible score. + +--- + +## Build & Run + +1. Compile the source code using your favorite C++ compiler, e.g.: + +```bash +g++ -o 2048game TheGame -std=c++17 +``` + +2. Run the executable: + +```bash +./2048game +``` + +--- + + +## License + +This project is open-source and free to use for educational purposes. + +--- + +Enjoy the game and try to beat your best score! 🚀 diff --git a/screenshots/2048-image.jpg b/screenshots/2048-image.jpg new file mode 100644 index 0000000..10df1cd Binary files /dev/null and b/screenshots/2048-image.jpg differ diff --git a/screenshots/Loading.png b/screenshots/Loading.png new file mode 100644 index 0000000..1650f9f Binary files /dev/null and b/screenshots/Loading.png differ diff --git a/screenshots/game_board.png b/screenshots/game_board.png new file mode 100644 index 0000000..476470b Binary files /dev/null and b/screenshots/game_board.png differ diff --git a/screenshots/main_menu.png b/screenshots/main_menu.png new file mode 100644 index 0000000..b005844 Binary files /dev/null and b/screenshots/main_menu.png differ