Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

https://github.com/mikkun/awktc

AWKTC is Workable Klutzy Time-wasting Command
https://github.com/mikkun/awktc

awk game puzzle terminal-game tetris

Last synced: about 6 hours ago
JSON representation

AWKTC is Workable Klutzy Time-wasting Command

Awesome Lists containing this project

README

        

# AWKTC

[![FlakeHub](https://img.shields.io/endpoint?url=https://flakehub.com/f/mikkun/AWKTC/badge)](https://flakehub.com/flake/mikkun/AWKTC)
![GitHub top language](https://img.shields.io/github/languages/top/mikkun/AWKTC)
![GitHub release (latest by date)](https://img.shields.io/github/v/release/mikkun/AWKTC)
![GitHub license](https://img.shields.io/github/license/mikkun/AWKTC)

> 🎮 **A**WKTC is **W**orkable **K**lutzy **T**ime-wasting **C**ommand

## Description

**AWKTC** is a Tetris-like tile-matching puzzle game written in AWK.

![AWKTC screenshot (width: 12)](./md-images/screenshot-width12.png)

## Requirements

- `gawk`, `nawk`, or `goawk`
- [GNU coreutils](https://www.gnu.org/software/coreutils/) or equivalent BSD command (`dd`, `echo`, `sleep`, `stty`)

## Installation

```shell
git clone https://github.com/mikkun/AWKTC.git
```

### Run Without Installing (For Nix/NixOS)

```shell
nix run github:mikkun/AWKTC
```

## How to Play

### Running the Game

```shell
cd /path/to/AWKTC
./awktc.awk
```

### Controls

- a: Move left
- d: Move right
- k: Rotate left
- l: Rotate right
- s: Fall faster
- p: Pause
- q: Quit

### Beneficial Item

- ![Black piece](./md-images/special_piece.png) - **Special Piece** - Destroys horizontal lines even if they have gaps of blocks.

### All Clear Bonus

If you clear all the blocks, then you will get an "All Clear Bonus".

## Changing the Playfield Width

You can change the playfield width between 4 and 24 cells. By default, the playfield width is 12 cells.

### Example Minimum Width

```shell
./awktc.awk 4
```

![AWKTC screenshot (width: 4)](./md-images/screenshot-width04.png)

### Example Maximum Width

```shell
./awktc.awk 24
```

![AWKTC screenshot (width: 24)](./md-images/screenshot-width24.png)

## License

[MIT License](./LICENSE)

## Author

[KUSANAGI Mitsuhisa](https://github.com/mikkun)