Skip to content

mxple/citris

Repository files navigation

Citris

A modern Tetris training tool, aiming to be the best tool of its kind.

Try it online here!

Native builds for all Windows, MacOS, and Linux are available in Releases.

This project is under development.

Features

  • 40L, Blitz, Cheese race, and Freeplay
  • T-spin and advanced T-spin practice
  • Downstack AI
  • PC finder
  • Custom queue + maps
  • Opener library + trainer
  • Finesse and advanced finesse trainer
  • VS mode against AI
  • Networked multiplayer (?)

Contributing

Contributing skins, bug reports, suggestions, and code is much appreciated! Open a PR/issue to get started.

Building

You'll need a C++23 compiler, SDL3, and ImGUI.

cmake -B build -DCMAKE_BUILD_TYPE=Release
cmake --build build -j$(nproc)
./build/citris

Settings are loaded from settings.ini in the project root. Copy assets/default_settings.ini to get started, or the game will use sensible defaults.

Acknowledgements

Portions of this codebase are either inspired by or direct ports of existing software.

T-spin practice modes are ported from himitsuconfidential.

PC finder is ported from MinusKelvin.

The following projects were used as references: cold-clear, fusion, misamino, clys, and blockfish.

About

Modern Tetris trainer

Resources

License

Stars

Watchers

Forks

Contributors

Languages