Skip to content

Latest commit

 

History

History
77 lines (51 loc) · 2.62 KB

README.md

File metadata and controls

77 lines (51 loc) · 2.62 KB

Connect Four

Copyright 2016-2024, Caleb Evans
Released under the MIT License

tests

This is the slickest Connect Four app around, written using HTML5, JavaScript, and Mithril (a React-like framework). You can play on your phone or computer, with a friend or against the AI. Just be sure to enjoy and have fun. :)

You can play the app online at:
https://connectfour.calebevans.me/

Implementation

User interface

The entire app UI is constructed and managed in JavaScript using Mithril. Chip transitions are handled by CSS to maximize performance and smoothness. The grid layout is styled with CSS Flexbox to enable the stacking of grid elements from the bottom up.

AI Player

Like many traditional board game AIs, my Connect Four AI uses the minimax algorithm. For my particular implementation, I've chosen to use a maximum search depth of three (meaning the AI examines possibilities up to three turns into the future). This is combined with alpha-beta pruning to dramatically reduce the number of possibilities evaluated.

My scoring heuristic works by counting connections of chips that intersect with an empty slot, giving exponentially more weight to larger connections. For example, every single chip touching an empty slot is worth four points, a connect-two is worth nine points, a connect-three is worth sixteen points, and so on. A winning connection of four or more chips is given the maximum/minimum score.

In the app, the AI player is lovingly referred to as "Mr. AI".

Run the project locally

1. Install global dependencies

The project requires Node (>= 18), so make sure you have that installed.

2. Install project dependencies

Install packages

This project uses pnpm (instead of npm) for package installation and management. From the cloned project directory, run:

npm install -g pnpm
pnpm install

3. Serve app locally

To serve the app locally, run:

pnpm dev

You will then be able to view the app at http://localhost:8080. Any app files will be recompiled automatically when you make changes to them (as long as pnpm dev is still running).