Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/ajaxray/four-in-a-row

A Basic Four-In-A-Row Game
https://github.com/ajaxray/four-in-a-row

2d-game arcade-game game-development go golang

Last synced: 2 days ago
JSON representation

A Basic Four-In-A-Row Game

Host: GitHub
URL: https://github.com/ajaxray/four-in-a-row
Owner: ajaxray
License: mit
Created: 2019-10-18T14:51:11.000Z (over 5 years ago)
Default Branch: master
Last Pushed: 2019-11-22T05:15:36.000Z (about 5 years ago)
Last Synced: 2024-12-18T00:43:20.396Z (about 2 months ago)
Topics: 2d-game, arcade-game, game-development, go, golang
Language: Go
Size: 6.87 MB
Stars: 2
Watchers: 3
Forks: 0
Open Issues: 0
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

README

        Four In A Row - 2 Player Arcade Game

====================

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

[![Go Report Card](https://goreportcard.com/badge/github.com/ajaxray/four-in-a-row)](https://goreportcard.com/report/github.com/ajaxray/four-in-a-row)

> Connect Four (also known as Captain's Mistress, Four Up, Plot Four, Find Four, Four in a Row, Four in a Line, Drop Four, and Gravitrips (in Soviet Union)) is a two-player connection game in which the players first choose a color and then take turns dropping one colored disc from the top into a seven-column, six-row vertically suspended grid. The pieces fall straight down, occupying the lowest available space within the column. The objective of the game is to be the first to form a horizontal, vertical, or diagonal line of four of one's own discs.

> 

>  -- [Wikipedia](https://en.wikipedia.org/wiki/Connect_Four)

![Puzzle Board](media/screen-2.png)

How to play?

----------------------

- Point the cursor over the column you wish to drop your disc in

- Left click to drop your disc

- When you can connect four discs vertically, horizontally or diagonally you win

#### Download 

- [MacOS version]

- [Windows] (64-bit)

You have to compile yourself if you're on other OS, sorry!

Features Implemented/Pending

--------------------

- [x] Basic **Four In A Row** / **Connect Four** game

- [x] Colorful, glossy disc images

- [x] Dice dropping and win sound

- [x] Intro screen with instructions

- [x] Pause screen

- [x] Restart at anytime (from pause screen)

- [ ] Choosing Player name and pawn color

- [ ] Play (move and drop) with keyboard

- [x] Background images using [Unsplash] API

- [x] Change Background in the middle of game (from pause screen)

Development Notes

------------------

To fix any bug, improve or just to explore - 

1. Clone this repo

2. Create `.env` by copying the `.env.dist` file

3. If you don't want to use Unsplash backgrounds, just keep the `UNSPLASH_ACCESS_KEY` empty

4. I Recommend using Unsplash, as it's a huge collection of high quality photos with a totally free API. It's simple!

    - Create your [Developer Account] 

    - Create a *collection* to group up your curated photos. 

    - Set the collection ID as `UNSPLASH_COLLECTION_ID` in `.env` file

#### Compiling

Use additional flags if you are in MacOS Catalina (10.15.x)  

```

go build -ldflags "-w"

```

If you want to build for windows 64-bit from macOS, use the following options.

```

env GOOS=windows GOARCH=amd64 CGO_ENABLED=1 CC=x86_64-w64-mingw32-gcc go build -ldflags="-H windowsgui" -o four-in-a-row.exe

```

Also, you may need to check [this workaround].

Suggestions and [Pull Requests] are welcome!

Motivation

----------------- 

We have a puzzle toy board of Four-In-A-Row and my kids enjoy it very much! One day, they asked to make it a computer game so that they can play it from the MacBook. 

![Puzzle Board](media/connect-four-board.png)

Then, I have searched around for an easy 2D game engine in [Golang] and chosen [Pixel]. Pixel, with it's easy to follow wiki, made it fun to bring this game in existence within a very short time.

---

> O mankind, what has deceived you concerning your Lord, the Generous!  

> -- [Al-Quran 42:6](https://quran.com/82/6?translations=20)

[Unsplash]: https://unsplash.com

[Developer Account]: https://unsplash.com/documentation

[Pull Requests]: https://help.github.com/en/github/collaborating-with-issues-and-pull-requests/about-pull-requests

[Golang]: https://golang.org/

[Pixel]: https://github.com/faiface/pixel

[this workaround]: https://github.com/faiface/pixel/issues/53#issuecomment-360238189

[MacOS version]: https://github.com/ajaxray/four-in-a-row/releases/download/v1.0.0/Four-In-A-Row_macOS.zip

[Windows]: https://github.com/ajaxray/four-in-a-row/releases/download/v1.0.0/Four-In-A-Row__win64bit.zip