Homebrew Homebrew app Homebrew game Tetris Overlay

[ppkantorski]

Tetris Overlay (HOS 16.0.0+)​

An Ultrahand-enhanced Tesla overlay that brings classic Tetris gameplay to the overlay menu. This overlay allows for in-menu gameplay with dynamic UI elements, saving and loading of game state, and high score tracking.

Screenshot​

Features​

• Ultrahand Integration: Enhanced with Ultrahand libraries for smooth and seamless gameplay with Ultrahand system settings and improved rendering.
• Classic Tetris Mechanics: Enjoy traditional Tetris gameplay, including line clears, level progression, and scoring.
• Dynamic UI: Provides a responsive interface with previews of the next and stored Tetriminos.
• Save and Load: Save your game progress and load previous games seamlessly.
• Pause and Resume: Easily pause and resume the game without losing progress.
• High Score Tracking: Tracks your highest score across sessions.
• In-Game Access: Launch the overlay directly within games using Ultrahand Overlay (or Tesla Menu).

Installation​

1. Ensure you have a homebrew-enabled Nintendo Switch with Ultrahand Overlay (or Tesla Menu) installed.
2. Download the latest release of Tetris Overlay from the Releases.
3. Copy "tetris.ovl" to the "sdmc:/switch/.overlays/" directory on your Nintendo Switch's SD card.
4. Open the Ultrahand Overlay (or Tesla Menu) and launch the Tetris Overlay.

Controls​

• D-Pad Left/Right: Move the Tetrimino left or right.
• D-Pad Down: Soft drop the Tetrimino.
• D-Pad Up: Hard drop the Tetrimino.
• A Button: Rotate the Tetrimino clockwise.
• B Button: Rotate the Tetrimino counterclockwise.
• L Button: Swap the current Tetrimino with the stored one.
• Plus (+) Button: Pause or resume the game.
• A or Plus (+) on Game Over: Restart the game.
• B on Pause: Exit the game.

Saving and Loading​

• The game state is automatically saved upon pausing or exiting the overlay.
• To load a previous session, start the overlay again.

Building the Project​

Prerequisites​

• DevkitPro with libnx installed.
• Nintendo Switch Homebrew Development Environment.

Building​

1. Clone the repository and pull the latest overlay libraries from Ultrahand Overlay:

git clone https://github.com/ppkantorski/Tetris-Overlay.git
cd Tetris-Overlay
chmod +x ./update_libs.sh
./update_libs.sh

The update_libs.sh script automates the process of downloading and updating the required libultra and libtesla libraries from the Ultrahand Overlay repository. It ensures the latest versions are correctly placed within the lib directory for the project.

2. Build the project:

make

3. The compiled overlay file (.ovl) will be in the project directory.

Contributing​

Contributions are welcome. Fork the repository and create a pull request, or report issues/suggestions via the Issues section.

License​

This project is licensed and distributed under GPLv2 with a custom library utilizing CC-BY-4.0.

Copyright (c) 2024 ppkantorski

---

This project is also basic a demo for how to build Ultrahand / Tesla overlays with the latest libtesla (Ultrahand) + libultra.
Hope you guys like it. ¯\_(ツ)_/¯

 

[blashy101]

Holy shit this is cool thank you so much

 

[ppkantorski]

Updated to v0.2.4.

Post automatically merged: Sep 22, 2024

https://github.com/ppkantorski/Tetris-Overlay/releases/tag/v0.2.5

List of changes:

1. New line clearing particle-burst effect.
2. New "ghost" piece preview for placing Tetris pieces with higher accuracy.
3. Improved scoring and falling speed according to level.
4. Clear event details for number of lines cleared. (like "Single", "Double", "Triple", or "Tetris")
5. Various minor UI improvements.