jj@portfolio:~/projects$jairik "jj" mccauley — software engineer
jj@portfolio: ~/projects/ai-puzzle-game — README.md — zsh

jj@portfolio:~/projects/ai-puzzle-game$ cat README.md

AI Puzzle Game

November 2024 · ● shipped · 2 screenshots · algorithms / ai

about

Utilizes A* Search to automate the 15-puzzle-game, a popular game that includes shifting tiles to a sequential configuration.

This desktop 15-puzzle can be played normally or handed over to an A* solver. The 4 by 4 board is a search state, every legal slide is a transition, and the ordered board is the goal. The interface makes the solver visible instead of leaving it as a function that prints a path to the terminal.

One mode solves and applies the full move sequence. A second computes only the next optimal move, which leaves room for a player-versus-bot format and makes it easier to inspect one decision at a time.

search design

A* combines the cost of moves already taken with a heuristic estimate of the work remaining. The solver expands the most promising board first, tracks how each state was reached, and reconstructs the final move sequence once it finds the goal.

The scope is deliberately limited to the standard 15-puzzle. Larger boards grow the state space quickly, so this is an educational pathfinding implementation rather than a general planning engine.

screenshots — 2 files

AI Puzzle Game — A* search 15-puzzle solver, screenshot 1 of 2AI Puzzle Game — A* search 15-puzzle solver, screenshot 2 of 2
$ cd ~/projectsexit code 0