Skip to content

This package provides API that allows you to easily create clones of the Tetris game. It handles game core - your role is to write the UI. Library was inspired by Redux and was written from scratch in TypeScript.

License

Notifications You must be signed in to change notification settings

robertrypula/simple-tetris

Repository files navigation

Simple Tetris

Update from 2023.02.08 - standalone WORKING even simpler tetris

Initial project (Redux-like & TypeScript) started in 2018 and it was never finished as I lost interest in it. In the meantime I wanted to create yet another Tetris version that is totally platform independent & programming language independent. Somewhere in 2022 this finally happen but I never published it... until now! Below you will find link to fully working game:

Play online

Source Code

Check the source code of that HTML. Everything is inside one file.

Few highlights:

  • this Tetris game was made for educational purposes
  • the game code (except simulation wrapper) has no JS syntactic sugar
  • there are no calls to external or even build in libraries (like JS's Math)
  • you can easily port it to any other language like C, just implement your own INPUT and OUTPUT ports handling and you are good to go
  • yes, that's the only file you need (linked above) from this repo to have a working Tetris

If you will find the code usefull please Star the project on GitHub - this really gives me a kick for making more stuff like that. Thanks in advance! :)

Below you will find old docs for the Redux-like & TypeScript version that was never finished:

Unfinished project (development stopped 2018.12.02)

npm version Build Status Coverage Status dependencies Status devDependencies Status

This package provides API that allows you to easily create clones of the Tetris game. It handles game core - your role is to write the UI. Library was inspired by Redux and was written from scratch in TypeScript.

NOTE: This project is still not finished. More details in the TODO section below.

Play online - use WSAD keys on Desktop or on-screen buttons on Mobile devices.

Api client browser

Simplest code example:

<!DOCTYPE html>
<html lang="en">
<head>
  <meta charset="UTF-8">
  <title>Simple Tetris - Simplest example</title>
  <style>
    #game-root {
      height: 480px;
      margin-bottom: 8px;
      width: 240px;
    }
    #game-root > div {
      background-color: lightgray;
      border: 1px solid white;
      box-sizing: border-box;
      float: left;
      height: 24px;
      width: 24px;
    }
    #game-root > div.filled { background-color: gray; }
  </style>
  <meta name="viewport" content="width=device-width, initial-scale=1.0">
</head>
<body onLoad="run()">
  <div id="game-root"></div>

  <button onClick="handleEvent(SimpleTetris.KEY_CODE_LEFT);">left</button>
  <button onClick="handleEvent(SimpleTetris.KEY_CODE_RIGHT);">right</button>
  <button onClick="handleEvent(SimpleTetris.KEY_CODE_HARD_DROP);">down</button>
  <button onClick="handleEvent(SimpleTetris.KEY_CODE_ROTATE);">rotate</button>

  <script>
    var store;

    function handleEvent(keyCode) {
      SimpleTetris.gameLoopIteration(store, 0.0, keyCode);
      render();
    }

    function render() {
      var matrixBlocksToRender = SimpleTetris.matrixBlocksToRenderSelector(store.getState());
      var html = '';

      for (var i = 0; i < matrixBlocksToRender.length; i++) {
        html += matrixBlocksToRender[i] ? '<div class="filled"></div>' : '<div></div>';
      }
      document.getElementById('game-root').innerHTML = html;
    }

    function run() {
      store = new SimpleTetris.createStore();
      render();
    }
  </script>
  <script src="https://unpkg.com/simple-tetris"></script>
</body>
</html>

Interactive code examples:

  • Clean JavaScript simplest example here
  • Clean JavaScript full example with mobile support here
  • Angular 7 example here

Installation

npm install simple-tetris

Ascii Runner alternative

If you just want to play the game and don't want to use any API you can simply use built-in Ascii Runner.

Play online - use Arrows on Desktop or on-screen buttons on Mobile devices.

<pre id="root"></pre>
<script src="https://unpkg.com/simple-tetris"></script>
<script>
  var asciiRunner = new SimpleTetris.AsciiRunner();
</script>

Ascii Runner browser

It works in terminal as well:

npm install simple-tetris && node node_modules/simple-tetris/dist/ascii-runner-node.js

Ascii Runner node

Content of the ascii-runner-node.js is as simple as:

const SimpleTetris = require('simple-tetris');
const asciiRunner = new SimpleTetris.AsciiRunner();

ASCII runner uses my other library (terminal-game-io) that simplifies basic input and output of the text based games.

Changelog

Still TODO

  • when tetrimino will hit the 'ground' attach it to the matrix (probably in 1.4.x)
  • add delay after hard drop before creating new tetrimino (probably in 1.4.x)
  • detect and remove completely filled lines (probably in 1.5.x)
  • detect game over, pause game button, new game button (probably in 1.6.x)
  • ...
  • (?) remove terminal-game-io from typescript definitions of src/lib/ascii-runner.ts file and move this lib back to devDeps (breaking change, probably in 2.0.0)
  • updates in interfaces like TetriminoRotation, TetriminoType instead of index, etc (breaking change, probably in 2.0.0)
  • add separate Enum for Keys and remove KEY_CODE_* constants (breaking change, probably in 2.0.0)
  • soft drop (probably in 2.x.x)
  • remove completely filled line 'blink' effect (probably in 2.x.x)
  • block colors (probably in 2.x.x)
  • score (probably in 2.x.x)
  • next piece preview (probably in 2.x.x)
  • ...

1.3.0 - ?? ?? 2018

  • move tetrimino one line down after given interval but still without attaching it to other blocks after reaching the 'ground'
  • implement hard drop and integrate it with collision detection

1.2.0 - 25 November 2018

  • collision detection both with borders and other blocks
  • updates in internal 'Simple Redux' implementation
  • small performance fix in matrixBlocksToRenderSelector
  • tetriminos now rotates clockwise
  • fields in IAsciiRunnerOptions are now optional
  • bugfix related to keyName parameter usage in ascii-runner.ts
  • bugfix related to terminal-game-io dependency issue

1.1.1 - 18 November 2018

  • adds dedicated 'GameLoopIteration' type that solves the problem in the *.d.ts file used by older typescript compilers
  • version upgrade of terminal-game-io (2.1.2 -> 3.1.0) - thanks to the new version of terminal-game-io all externals could be removed ('process' and 'readline')
  • npm keywords update
  • big update in examples (external stackblitz examples, internal API client example)
  • big update in readme (code examples, animated gifs)
  • simple-tetris is finally easy to import in any other project

1.1.0 - 13 September 2018

  • rename 'assets' directory to 'templates'
  • rename suffix of terminal-game-io-runner-* to node and browser
  • createStore factory that hides reducers
  • finish rotation database for all tetriminos
  • project setup based on terminal-game-io wrapper
  • split store into matrix and tetrimino sections
  • moving the tetrimino by arrows and simple rotations
  • let actions dispatch own actions and check store state
  • finalization of the project structure that will be used across all 1.x.x versions

1.0.0 - 06 August 2018

  • initial version of the project, nothing more than the PoC

Want to check this project in development mode?

Development mode is using Ascii Runner supported by terminal-game-io library.

git clone https://github.com/robertrypula/simple-tetris.git
cd simple-tetris
npm install

npm run dev-browser

You can develop and play Tetris directly in the terminal. It works even via the SSH connections.

npm run dev-node

Licence

The MIT License (MIT)

Copyright (c) 2018 Robert Rypuła - https://github.com/robertrypula/simple-tetris

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.