Phel Snake

A cli-game written in Phel.

Two versions in one repository

This repository contains a full-version and a simplified version of the snake game.

I thought it might be useful to create a simplified version as introduction to the fundamentals of the language and the game itself.

• In the simplified version, you will find just the snake inside the board.
• In the full version, the snake will increase the speed as it reaches to goals.

How to play

Instructions

Use the arrow keys to move the snake: left-right-top-down. The game ends when the snake touches any border of the board.

In the full version

• You can use the space-key to accelerate a few cells the snake in the current direction.

• The snake will automatically increase the speed after each goal reached, unless you enable the "god mode" (using the argument god-mode).

Setup

Using Docker

1. Clone this repo
2. Build the image and run the container: docker-compose up --build -d
3. Run the game: docker exec -it phel_snake ./tools/composer play

Locally (no Docker)

1. Ensure you have PHP >=8.2
   1. Some help about how to install multiple PHP versions locally on linux and Mac
2. Clone this repo
3. Install the dependencies: ./tools/composer install
4. Run the game: ./tools/composer play

---

Alternatively, you can run the game using the phel run command You can define some optional arguments

• width={N} -> width of the board
• height={N} -> height of the board
• god-mode -> the snake won't increment the speed as it eats apples
• debug -> you can see internal stats of the game
• simple -> start the simplified game

vendor/bin/phel run src/main.phel width=40 height=15 god-mode debug

Demo