caleb531 / connect-four

The slickest way to get 4-in-a-row, written using HTML5, JS, and Mithril (like React). Features an AI player, online multiplayer capability, and a smooth user interface

Connect Four

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

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).

connect-four's Issues

Cant run on normal webspace

I guess it would be a good idea to make your project ready to run in a zip file.
Its way of overcomplication using scss npm brew gulp etc pp for this some simple html css js files.
In the Readme you do not even mention where and how to get this exotic mithril.
At the current state you are to inviting to study your AI solution but to study how to install
all the tools you use. These tools are ment to develop a solution like yours but not to spread and make a solution available to others.
Just zip your running web solution with the index.html,
scripts and css in the right place and your done ;-))