Tetris Overlay Switch

Tetris Overlay
General
Author	ppkantorski
Type	Overlays
Version	0.3.1
License	GPL-2.0
Last Updated	2024/09/30
Links
Download
Website
Source
Support Author

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.

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.

Screenshots

Changelog

v0.3.1

• Updated with new libtesla and libultra from Ultrahand v1.7.8.

v0.3.0

1. Improved texture design.
2. Slight fixes to rotation logic.

Update:

• Slight adjustment to kick logic. - 09/26/2024 11:15 PM PST
• Spawn new piece centering bug fix. - 09/26/2024 11:54 PM PST

v0.2.9

1. More fixes to various Tetris piece movement / rotation (as well as auto-locking).
   • More boundary cases have been addressed.
   • Pieces will no longer rotate indefinitely.
   • Pressing down on the floor will now trigger a hard drop.
2. Fixes to Game Over prompt delay.

v0.2.8

• Slight improvement to block texture design.
• Bug fix for combo variables not resetting upon new game.
• More fixes to piece rotation, kicks and placement.
• Various subtle UI tweaks.

v0.2.7

1. Previews for next 2 Tetris pieces have been added.
2. Scores for each line clearing event are now rendered, along with the clearing event. (like T-Spin Double, 2x Tetris, etc)
3. New particle effect for fast dropping pieces (clicking up).
4. Fixes to sliding pieces left / right on floor. (limit to number of floor sides possible before locking)
5. Fixes to pieces not automatically locking when rotation is not possible (but rotation is pressed).
6. Improvements to the new game particle burst effect.
7. Various minor bug fixes and subtle UI tweaks and improvements.

Update:

• Fix for next 2 Tetris pieces not resetting upon new game. - 09/24/2024 12:17 AM PST
• Symbol indicator for pieces. - 09/24/2024 12:34 AM PST
• Expansion of save states to preserve back to back combo variables. - 09/24/2024 3:37 AM PST

v0.2.6

1. More bug fixes.
   • Fixed a bug that caused a crash when clearing lines near the top of the board.
   • Fixed the piece lock duration / duration reset function. (so items don't just hit the floor while you are still spinning them)
   • Various additional safety measures.
2. Various UI improvements.
   • Improved clear line event indicator.
   • New game particle effect.
3. Dynamic color logo property is now read from Ultrahand's theme.ini again.

Update:

• Bug fix for line clear event indicator causing screen flicker during paused game. - 09/23/2024 3:07 AM PST

v0.2.5

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.

Update:

• Lines cleared logging bug fix. - 09/22/2024 3:27 AM PST
• "Tetris" event text cleanup. - 09/22/2024 3:33 AM PST
• Slight bug fix. - 09/22/2024 4:02 AM PST
• Another slight bug fix. - 09/22/2024 4:43 AM PST
• Piece initial position bug fix. - 09/22/2024 5:00 AM PST
• Potential crash related bug fix. - 09/22/2024 6:40 AM PST

v0.2.4

1. Improved controls.
   • Directional click and holds now functions properly.
2. Clean-up of UI.
   • Ultrahand widgets are now rendered.
   • Ultrahand swipe to open and opaque screenshots settings now function properly.
   • Cleanup of button labels and colorization of application title.
3. Custom wallpaper override option.
   • This is done by placing an Ultrahand wallpaper.rgba into sdmc:/config/tetris/ and requires nx-ovlloader+ to function.
4. Custom theme override option.
   • This is done by placing an Ultrahand theme.ini into sdmc:/config/tetris/.
5. Various bug fixes.

v0.2.3

• First Release.

External links

• Gbatemp - https://gbatemp.net/threads/tetris-overlay.661021/
• Github - https://github.com/ppkantorski/Tetris-Overlay