Skip to main content

Cetra Grand Master | An oddly familiar block stacker in the command line!

Project description

cgm

Cetra Grand Master!

A block stacker game that you might find very familiar. Built with similar design to Tetris Grand Master in mind, but runs entirely in your terminal with much more modern mechanics.

how

pip install cetragm, or pipx install cetragm if you're on an externally managed system like Arch Linux. You may need the pygame module if you don't have it or if pip doesn't install it for you. Run cgm.

If you'd like to customise your controls, you may change them in /src/cgm/config.py under the project directory.

To change DAS (how long until inputs repeat) and ARR (how fast inputs repeat), you'll have to do it under your OS' settings for now. On Windows, it should be under the Mouse and Keyboard controls. On KDE Plasma, under System Settings > Keyboard > Repeat Rate. On Mac, go ask Tim Cook. On Gnome, go ask Richard Stallman's left foot. Otherwise, I'm sure you can figure it out.

what

Features:

  • Supports any terminal emulator, Windows or Linux. (Not tested on Mac but may work.)
  • Rebindable controls, including hard and soft drops as well as holds.
  • Grade system, up to the Gm grade (which I guarantee you won't get)
  • Full color!
  • Dynamic gravity (speed) as your level increases
  • Scoring system
  • Gameplay timer
  • 7-bag piece drawing
  • 5-piece next queue and level display
  • Persistent TLS (or shadow piece)
  • TGM's 20G gravity after level 500
  • Proper ARE, lock delay, and line clear delay
  • Real-time gravity (not tied to frame rates)
  • The standard Super Rotation System and all its janky kicks!

Drawbacks:

  • Requires manual ARR/DAS and can't press two keys at once
  • Scoring is slightly off
  • Lack of theming or menus at all, as well as a lose state
  • No sound (background or effect)

To add by next week:

  • T-spins and detection for them
  • IHS and IRS (Inital Hold/Rotation System)
  • Full menu with configuration
  • Tiny optional input window via Pygame to add proper multi-key controls and DAS/ARR
  • Config config config! maybe even a new gamemode...

controls

You may configure these in config.py, but the defaults (and what I use) follow:

Buttons Function huh
a j Move Left
d l Move Right
space / c Rotate CW
z , q Rotate CCW
tab x . Rotate 180
s k Soft Drop move your piece down faster, but don't immediately lock it into place
w i Hard Drop move your piece as far down as it will go and lock it in place, skipping the delay
e v Hold Piece put a piece aside or switch to your held piece when it doesn't fit
esc p quit why would you ever want to do that?

why

Built for Hack Club's Siege program (week 10 and 11). Also, I like block stackers.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

cetragm-0.1.5.tar.gz (26.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

cetragm-0.1.5-py3-none-any.whl (28.9 kB view details)

Uploaded Python 3

File details

Details for the file cetragm-0.1.5.tar.gz.

File metadata

  • Download URL: cetragm-0.1.5.tar.gz
  • Upload date:
  • Size: 26.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.8.15

File hashes

Hashes for cetragm-0.1.5.tar.gz
Algorithm Hash digest
SHA256 23236059641df3abebc0f04d87aad819e567f0d1ff4aa7f5ab2896d55cc4da48
MD5 3c5f355c748bc607e407a587f923b196
BLAKE2b-256 4367e2e14fa6b054db89304aa39cb4f08dd12fda172c1a52ce7fa7c00705cc7e

See more details on using hashes here.

File details

Details for the file cetragm-0.1.5-py3-none-any.whl.

File metadata

  • Download URL: cetragm-0.1.5-py3-none-any.whl
  • Upload date:
  • Size: 28.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.8.15

File hashes

Hashes for cetragm-0.1.5-py3-none-any.whl
Algorithm Hash digest
SHA256 2e3ad0af4259989a4a3b83e45ee6868e5b6f77ca12844c6059337cdb2b1b94ba
MD5 ae8c898842c8b9dc8f43eff52b78cf02
BLAKE2b-256 b83fad99e4c51c0ae82a478cbbca461522ba373af80d76f1cfc8c259c0953665

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page