Giter Club home page Giter Club logo

yetris's Introduction

yetris

Customizable Tetris(tm) with textual interface.

screenshot

Introduction

yetris is a customizable Tetris(tm) clone for the terminal. It has some features found on modern adaptations and aims to please both casual players and Tetris(tm) enthusiasts.

It has full textual interface, check out these features:

  • Colors and animated interface;
  • Customizable gameplay, with several game mode possibilities: ghost piece, hold piece, slide left/right, invisible and custom initial level and noise (like the old B-mode).
  • Customizable interface: up to 7 next pieces, toggle game borders, center screen, modify game random algorithm...
  • You can change settings on in-game menus and options;
  • Game profiles: settings are automatically saved and restored at startup. Multple profiles supported.
  • Game statistics: cleared lines, individual and total pieces...

yetris was originally developed in C, now reprogrammed in C++ with ncurses. It runs on pretty much every terminal around here, but it's limited to POSIX systems.

Screenshots

main-menu

profile-menu

single-player-menu

options-menu

b-mode

help

pause-menu

game-statistics

Controls

Key Action
Left, Right Controls the piece
Down Soft-drop
Space Hard-drop
c Holds the piece
z, x Rotates piece counter-clockwise/clockwise
p Pauses the game
q Quits the game at any time
r Restart game
h Show help window

Dependencies

yetris only depends on ncurses; it's used to show cute things on the terminal.

Make sure you have the package ncurses dev. Note that it's not the default that comes with your distro.

Distro Installation command
Ubuntu/Debian apt-get install libncurses5-dev
Fedora yum install ncurses-devel
Arch Linux comes by default

If you know the means to install on other distros, please tell me.

Usage

Briefly, the following shell commands should configure, build and install this package on the default directories:

$ make
$ [sudo] make install

If you want to test it before installing, do:

$ make run

Then, it's simple:

$ man yetris
$ yetris --help
$ yetris

Check file INSTALL.md for more info.

Hacking

There's another README.md on the src/ directory. In there I try to explain the source and how could you play with it.

If you want to contribute, there's a lot we could do together! Don't hesitate to contact me, any addition is welcome.

The BUGS and TODO files are nice points to check out what we could do.

Also, if you're like me and love ncurses games, with textual interface and stuff, the src/Inteface/* files could be of great use. I tried to make them very flexible so you could just insert them into a project without too much change.

Contact

Hello there, I'm Alexandre Dantas (kure)!

Thanks for downloading and playing this game. I'm glad you had interest on this project.

You can send me comments, bugs, ideas or anything else by email. And if you have time, please visit my blog!

I'd appreciate any commentary - even if it's just "Hello, I play your game!".

Credits

Huge thanks for all the people that contributed to the project (in order of appearance):

  • Karfield fixed a great mistake regarding typedefs and inclusions. Thanks to him, yetris now works on MacOsX!
  • Rodrigo Rebello fixed some resource leaks and optimized the game by removing unnecessary fflush() calls.
  • Damon McDougall pointed out a serious issue on the building process. Thanks to him yetris can be installed on BSD!

Also, some miscellaneous credits:

  • Yetris' logo uses the Crawford2 Figlet Font.
  • Thanks, Nicolas Devillard! Your iniParser helped me a lot!
  • I'm also using clibs/commander, simples CLI argument parser I've ever seen.
  • Emacs, Awesome and Arch Linux, the Ultimate Triforce.
  • The OneUps kept me awake on several nights. Their music is great, specially Volume 2!

License

yetris - Customizable Tetris(tm) on the console. Copyright (C) 2013-2014 Alexandre Dantas (kure)

yetris is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.

githalytics.com alpha

yetris's People

Contributors

alexdantas avatar karfield avatar rrebello avatar hwangcc23 avatar

Watchers

James Cloos avatar  avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.