Skip to main content

NELIKKO (terminal)

Helsinki, 1989, in a terminal. The second version of the game beside web/, on the magmacrunch engine's terminal backend: a cabinet in the magmacrunch arcade and its own command, the same either way.

pipx install magmacrunch-nelikko
nelikko

For working on it:

pip install -e ".[dev]"
python -m nelikko

Keys

key
← → (or A/D) siirrä, slide. Hold to keep sliding
↑ (or W, X) käännä, turn clockwise
↓ (or S) pudota, down a row
SPACE heitä, drop
C pidä, hold
P tauko, pause
R restart
Esc the title (from the title, back to the arcade)
Q quit

Every control is a press, so a terminal plays this the way a browser does. Holding an arrow is the terminal repeating it, which stands in for the browser's own auto-shift; it starts a little later than the page's 170 ms, and that is the only difference you can feel.

It is the browser's game

nelikko/rules.py is the rules from web/game.js, which keeps them in one file with the canvas and the page. tests/test_oracle.py checks the port anyway: tools/js_oracle.mjs loads web/game.js unmodified with the page stubbed out, plays it through its own update(), and the test replays every op through the port and requires the same well, piece, score, level and clock after each one. Ten games, about 25,000 ops, up to level 20.

Both versions share a scoreboard, so a rule changes in web/game.js and here together, and the oracle test holds the two to each other. Two oddities this port used to copy were fixed in both on 2026-10-19: levels 2 and 3 fell slower than level 1, and a piece swapped out of hold entered over the stack.

Scores go to the board the browser already has, which is still called tetris from before the rename. That is deliberate (see ../AGENTS.md) and never shown.

Characters

Every glyph is in the engine's degradation table except the Finnish ä in PIDÄ and the tagline. cp1252 and cp437 both carry it, so in practice it draws everywhere; what it lacks is an ASCII stand-in under --ascii. The engine's nordic group (magmacrunch-media/magmacrunch#4) adds one. Once a release carries it, raise the magmacrunch floor here and drop FINNISH from tests/test_app.py.

Needs a 52x22 terminal.

Licence

PolyForm Noncommercial 1.0.0, as the rest of this repository. See NOTICE.

Metadata

Release files for magmacrunch-nelikko 0.1.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for magmacrunch-nelikko 0.1.1
File Size Uploaded Provenance
magmacrunch_nelikko-0.1.1.tar.gz 22.5 kB With provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for magmacrunch-nelikko 0.1.1
File Interpreter ABI Platform
magmacrunch_nelikko-0.1.1-py3-none-any.whl Python 3 none any Details

Total release size: 42.2 kB

Release files / magmacrunch_nelikko-0.1.1.tar.gz

Download URL magmacrunch_nelikko-0.1.1.tar.gz
Size 22.5 kB
Tags Source
SHA-256 checksum
How to use checksums
c93725a43fbec65d6122ddf6e06993c834379e8f8639c3356577310fb3aac9d9
BLAKE2b-256 checksum
How to use checksums
583a18fa932b0347e3496e2ad8ee7867a00d4bb41b2c9d44de1ccb01ff00b5de
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 22, 2026.

Transparency log

Release files / magmacrunch_nelikko-0.1.1-py3-none-any.whl

Download URL magmacrunch_nelikko-0.1.1-py3-none-any.whl
Size 19.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
67d2502e0f8b4e677b6167bba8d8af2c506176e19af06eb4819965c9f9ca9a2b
BLAKE2b-256 checksum
How to use checksums
acbcdeb722a0dbff726c2dca37d0d7af6a2e656ae830225fc610af024536465a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 22, 2026.

Transparency log

Security for magmacrunch-nelikko 0.1.1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

All 2 files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for magmacrunch_nelikko-0.1.1.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 22, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

Release history Release notifications | RSS feed

This release

0.1.1 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page