https://github.com/qluana7/tetrinal
Simulate no-gravity stacking block in terminal. It support SRS and damage system, all spin, bags, etc.
https://github.com/qluana7/tetrinal
srs stacking terminal tetromino
Last synced: 11 days ago
JSON representation
Simulate no-gravity stacking block in terminal. It support SRS and damage system, all spin, bags, etc.
- Host: GitHub
- URL: https://github.com/qluana7/tetrinal
- Owner: qluana7
- Created: 2025-06-27T03:37:25.000Z (10 months ago)
- Default Branch: main
- Last Pushed: 2025-08-11T08:09:02.000Z (9 months ago)
- Last Synced: 2025-10-31T03:58:12.535Z (6 months ago)
- Topics: srs, stacking, terminal, tetromino
- Language: C++
- Homepage:
- Size: 77.1 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
tetrinal
Simulate no-gravity stacking block in your terminal. Supports SRS, damage system, all spins, bag randomizer, and more.
## Overview
`tetrinal` is a terminal-based block stacking simulation that focuses on "no-gravity" zen play. It supports lot of mechanics.
## Features
- **No-Gravity Stacking:** Play at your own pace, no gravity pressure.
- **SRS & All Spins:** Full support for SRS kicks and spin recognition.
- **Damage System:** Configurable damage and line clear rules.
- **Bag Randomizer:** True 7-bag shuffling for piece distribution.
- **Terminal UI:** Runs natively in your terminal with minimal dependencies.
- **Statistics:** Track your clears, spins, attack, and more.
⚠️ This project is a work in progress ⚠️
### Planned Features
- **Perfect Clear Practice:** Practice mode for perfect clears.
- **Custom Game Modes:** Create and play custom game modes.
- **Main Menu:** A main menu for easier navigation.
- **Customizable Settings:** More options for customizing gameplay.
## How to Build
You need a C++20 (or higher).
```bash
git clone https://github.com/qluana7/tetrinal.git
cd tetrinal
mkdir build && cd build
# you can use 'GNU make' instead of ninja
cmake .. -GNinja --DCMAKE_BUILD_TYPE=Release
ninja
```
The executable will be built in the `build` directory.
## How to Play
Run the program:
```bash
./tetrinal
```
Controls (default):
- **Left/Right:** Move piece
- **Down:** Soft drop
- **Up:** Rotate Clock Wise
- **Z:** Rotate Counter Clock Wise
- **A:** Rotate 180 degrees
- **C:** Hold
- **Space:** Hard drop
- **ESC:** Quit
(You can check in-source comments or configuration files for custom key mappings.)
## Image
## Contributing
Feel free to open issues, suggest features, or submit pull requests! Please follow standard C++ coding conventions and include usage comments for new features.
---