IART project 1

• Project name: Ball Sort Puzzle
• Short description: Solve the Ball Sort Puzzle using informed and uninformed search methods
• Environment: Unix/Windows console
• Tools: C++, CMake
• Institution: FEUP
• Course: IART (Artificial Intelligence)
• Project grade: 19.5/20.0
• Group members:
  • Diogo Miguel Ferreira Rodrigues (dmfrodrigues2000@gmail.com / diogo.rodrigues@fe.up.pt)
  • Rafael Soares Ribeiro (up201806330@fe.up.pt)
  • Bernardo António Magalhães Ferreira (up201806581@fe.up.pt)

Based on game Ball Sort Puzzle by Spica Game Studio.

Get this project

Setup

On Microsoft Windows, (as always) things don't just work out-of-the-box.

This project uses ASCII color codes, which are not enabled on some versions of Windows by default.

cmd/PowerShell

If colors don't properly render, try running the following command in cmd as administrator so that cmd can correctly interpret ASCII colors (source):

reg add HKEY_CURRENT_USER\Console /v VirtualTerminalLevel /t REG_DWORD /d 0x00000001 /f

and open a new cmd (not required to be administrator) to run with correct color rendering. Worked for me on Windows 10.

Visual Studio Code integrated terminal (cmd/PowerShell)

Add the following line to .vscode/settings.json:

"terminal.integrated.windowsEnableConpty": false

and open a new integrated terminal to run with correct color rendering and avoid garbage being printed.

Compile

This project uses CMake, to compile the project run

mkdir build
cd build
cmake ..
cmake --build .

The executable is called main and will be placed in the root of the repository.

To run it in interactive mode, just run ./main; for the CLI mode, run ./main cli to check the possible options.

License

© 2021 Diogo Rodrigues, Rafael Ribeiro, Bernardo Ferreira

All files are licensed under GNU General Public License v3 by © 2021 Diogo Rodrigues, Rafael Ribeiro, Bernardo Ferreira, to the exception of:

• all files inside directory doc/report and all artifacts deriving from them, which are licensed under the Creative Commons Attribution-NonCommercial-NoDerivatives 4.0 International public license.