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: 3 months ago
JSON representation

AWKTC is Workable Klutzy Time-wasting Command

• Host: GitHub
• URL: https://github.com/mikkun/awktc
• Owner: mikkun
• License: mit
• Created: 2018-03-14T17:45:03.000Z (over 7 years ago)
• Default Branch: master
• Last Pushed: 2023-10-10T10:00:17.000Z (almost 2 years ago)
• Last Synced: 2025-04-12T22:55:55.201Z (3 months ago)
• Topics: awk, game, puzzle, terminal-game, tetris
• Language: Awk
• Homepage:
• Size: 61.5 KB
• Stars: 53
• Watchers: 4
• Forks: 5
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

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)